How yongxin-yang/spec-agent-prompt-my works
This repository is a lightweight Document-Driven Development (DDD) framework: it provides durable project knowledge, task-specific specification templates, AI-agent guidance, and structural checks. The documented workflow moves from research and Docus updates through Specs, implementation, tests, and documentation updates. The tree supports concrete templates, agents, and structure-check scripts; the README describes broader workflow stages, but sampled source does not establish runtime orchestration or semantic consistency checking, so those links are not depicted as implemented integrations.
Main entry points: constitutions Project principles · scripts Structure checks · templates Spec templates · DDD-implementor.agent.md Implementor
Components 17
Docus knowledge
- Project principles
constitutions - System structure
structures - File guidance
constitutions - DDD workflow
README.md
Specs workflow
- Spec templates
.docusdd/templates - Quickstart
quickstart.md
AI guidance
- Constitution builder
.github/agents/DDD-constitution-builder.agent.md - Requirement explainer
.github/agents/DDD-require-explainer.agent.md - Implementor
.github/agents/DDD-implementor.agent.md
Structure checks
- Structure checks
.docusdd/scripts - Code structure check
.docusdd/scripts/check_codefile_structure.ps1 - Docus structure check
.docusdd/scripts/check_docus_structure.ps1 - Specs structure check
.docusdd/scripts/check_specs_structure.ps1
Other components
- Developer
- Research
- Project code
- Project tests
Connections 20
- Developer → Research: investigates
- Research → Project principles: informs updates
- Developer → Project principles: maintains
- Developer → System structure: maintains
- Developer → File guidance: documents files
- Project principles → Spec templates: rules propagate
- Project principles → Constitution builder: rules propagate
- Project principles → DDD workflow: rules propagate
- Project principles → Quickstart: rules propagate
- Developer → Spec templates: plans work with
- Spec templates → Requirement explainer: guides requirements
- Spec templates → Implementor: guides tasks
- Implementor → Project code: generates implementation
- Implementor → Project tests: generates tests
- Project code → Project tests: is verified by
- Developer → Structure checks: runs checks
- Structure checks → Code structure check: includes
- Structure checks → Docus structure check: includes
- Structure checks → Specs structure check: includes
- Developer → Project principles: updates knowledge