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
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.

2 participants