ReddRadar
Agent skill
design-doc-generate
Generate design documents for Validate mode work items (Checkpoint 1). Required for high-complexity items.
Install this agent skill to your Project
npx add-skill https://github.com/fabriqaai/specs.md/tree/main/src/flows/fire/agents/planner/skills/design-doc-generate
SKILL.md
<degrees_of_freedom> LOW — Follow the design doc structure precisely. Decisions must have rationale. </degrees_of_freedom>
<output_format>
| Decision | Choice | Rationale |
|----------|--------|-----------|
| ... | ... | ... |
</output_format>
<output_format>
| Risk | Impact | Mitigation |
|------|--------|------------|
| ... | ... | ... |
</output_format>
## Summary
{brief description}
## Key Decisions
{decisions table}
## Technical Approach
{component diagram, API contracts}
## Risks
{risks table}
## Implementation Checklist
{ordered steps}
---
This is Checkpoint 1 of Validate mode.
Approve design? [Y/n/edit]
</output>
</checkpoint>
Route to Builder for Checkpoint 2 (implementation plan)? [Y/n]
</output>
</check>
<check if="response == edit">
<ask>What changes are needed?</ask>
<action>Incorporate feedback</action>
<goto step="8"/>
</check>
<check if="response == n">
<output>Design rejected. What concerns need to be addressed?</output>
<action>Gather feedback, revise approach</action>
<goto step="3"/>
</check>
<output_artifacts>
| Artifact | Location | Template |
|---|---|---|
| Design Doc | .specs-fire/intents/{intent-id}/work-items/{id}-design.md |
./templates/design.md.hbs |
| </output_artifacts> |
<success_criteria> Work item analyzed for design decisions Key decisions documented with rationale Domain model defined (if applicable) Technical approach specified Risks identified with mitigations Implementation checklist created Design doc approved at checkpoint Design doc saved to correct location </success_criteria>
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
fabriqaai/specs.md
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
fabriqaai/specs.md
run-status
Display current run status and progress. Shows work item, mode, duration, and files changed.
fabriqaai/specs.md
run-plan
Plan the scope of a run by discovering available work items and suggesting groupings. Invoked before run-execute.
fabriqaai/specs.md
walkthrough-generate
Generate implementation walkthrough for human review after run completion. Documents decisions, changes, and verification steps.
fabriqaai/specs.md
code-review
Review code written during a run, auto-fix no-brainer issues, and suggest improvements requiring confirmation. Invoked after tests pass.
fabriqaai/specs.md
run-execute
Execute work items based on their assigned mode (autopilot, confirm, validate). Supports single-item and multi-item (batch/wide) runs.
Didn't find tool you were looking for?