Skip to content

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Jan 30, 2026

Summary

  • Implements the complete experts system as specified in doc/experts_requirements.md
  • Adds new data structures (ExpertDefinition, Topic, Learning)
  • Adds JSON Schema validation for expert.yml, topics, and learnings
  • Adds parser for expert directories with frontmatter markdown support
  • Adds Jinja2 template-based agent generation
  • Adds CLI commands (deepwork topics, deepwork learnings)
  • Integrates standard experts installation during deepwork install
  • Integrates expert agent generation during deepwork sync
  • Includes standard "experts" expert documenting the system itself
  • Updates documentation status to reflect completed implementation
  • Comprehensive test suite (99 new tests)

Test plan

  • All existing tests pass
  • New expert tests pass (unit and integration)
  • Manual verification of deepwork install installing experts
  • Manual verification of deepwork sync generating expert agents

🤖 Generated with Claude Code

@nhorton nhorton changed the title docs: Add experts system specification and initial standard expert docs updates Jan 30, 2026
nhorton and others added 3 commits January 30, 2026 15:56
Add specification for the experts system - auto-improving collections of
domain knowledge that get exposed as Claude agents.

- Add doc/experts_requirements.md with full specification:
  - Directory structure (.deepwork/experts/[name]/)
  - File formats (expert.yml, topics/*.md, learnings/*.md)
  - CLI commands (deepwork topics, deepwork learnings)
  - Sync behavior (generates agents in .claude/agents/)

- Add initial "experts" standard expert in src/deepwork/standard/experts/:
  - Meta-expert for the experts system itself
  - Topics on design patterns and discovery descriptions

- Update doc/architecture.md:
  - Add src/deepwork/standard/ directory to structure diagram
  - Add "Experts (Planned)" section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Remove "(Planned)" from section heading and update status to reflect
that the experts system implementation is now complete.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@nhorton nhorton changed the title docs updates feat: Add experts system for auto-improving domain knowledge Jan 30, 2026
nhorton and others added 8 commits January 30, 2026 16:12
- Add `agent: deepwork-jobs` to all 4 steps in deepwork_jobs job.yml
- Remove misleading "Prerequisites" documentation from step files
- Create new step_delegation.md topic explaining how to use expert delegation
- Update job_yml_schema.md with "Agent Delegation" section
- Key insight: "This is how you make a step 'run via' an expert"

The deepwork_jobs steps now properly delegate to the deepwork-jobs expert,
giving them access to job schema knowledge, best practices, and learnings.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add new review_pr job with 3 steps: check_relevance, deep_review, improve_and_rereview
- Use inline bash completion $(gh pr diff) for efficient token usage in expert prompts
- Experts focus only on their domain expertise for specialized feedback
- Iterative improvement cycles until all experts approve or 3 max iterations
- Add learnings: domain focus in expert prompts, efficiency improvements
- Code cleanup: remove redundant try/except and unused context variables
- Include PR review output files from workflow execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant