Entry point:
/faion-net— invoke this skill for automatic routing to the appropriate domain.
SDD Planning Sub-Skill
Documentation planning phase of Specification-Driven Development.
Communication: User's language. Docs/code: English.
Context Discovery
Auto-Investigation
| Signal | Check For | Why |
|--------|-----------|-----|
| .aidocs/ structure | SDD workflow in use (backlog, todo, in-progress, done) | SDD adoption status |
| spec.md files | Specification format and quality | Spec standards present |
| design.md files | Design doc patterns | Design approach |
| implementation-plan.md | Task breakdown structure | Planning methodology |
| TASK-*.md files | Task format, token estimates | Task creation standards |
Discovery Questions
questions:
- question: "Which SDD phase are you in?"
options:
- label: "Writing specification"
description: "Use writing-specifications, spec-structure"
- label: "Creating design doc"
description: "Use design-doc-structure, design-doc-writing-process"
- label: "Breaking down into tasks"
description: "Use writing-implementation-plans, task-creation-principles"
- label: "Setting up SDD workflow"
description: "Use workflows, templates"
- question: "Do you have existing SDD documentation?"
options:
- label: "Yes, following SDD"
description: "Continue with established patterns"
- label: "Partial/inconsistent"
description: "Standardize using templates"
- label: "No, starting fresh"
description: "Start with spec-structure, templates"
- question: "What's your task complexity?"
options:
- label: "Simple features (<50k tokens)"
description: "Standard task breakdown"
- label: "Complex features (>100k tokens)"
description: "Apply impl-plan-100k-rule, split features"
Philosophy
"Intent is the source of truth" - specification is the main artifact, code is implementation.
No Time Estimates: Use complexity (Low/Medium/High) + token estimates (~Xk).
Scope
This sub-skill handles:
- Writing specifications (WHAT + WHY)
- Creating design documents (HOW)
- Breaking down implementation plans (TASKS)
- Task creation and templating
- Workflow documentation
Decision Tree
| If you need... | Use | File | |----------------|-----|------| | Specifications | | | | Write spec | writing-specifications | writing-specifications.md | | Spec structure | spec-structure | spec-structure.md | | Spec requirements | spec-requirements | spec-requirements.md | | Advanced guidelines | spec-advanced-guidelines | spec-advanced-guidelines.md | | Basic examples | spec-examples-basic | spec-examples-basic.md | | E-commerce example | spec-example-ecommerce-cart | spec-example-ecommerce-cart.md | | AI-assisted spec | ai-assisted-specification-writing | ai-assisted-specification-writing.md | | Design Documents | | | | Design structure | design-doc-structure | design-doc-structure.md | | Writing process | design-doc-writing-process | design-doc-writing-process.md | | Advanced patterns | design-doc-advanced-patterns | design-doc-advanced-patterns.md | | Examples | design-doc-examples | design-doc-examples.md | | Implementation Plans | | | | Write impl-plan | writing-implementation-plans | writing-implementation-plans.md | | 100k token rule | impl-plan-100k-rule | impl-plan-100k-rule.md | | Components | impl-plan-components | impl-plan-components.md | | Task format | impl-plan-task-format | impl-plan-task-format.md | | Examples | impl-plan-examples | impl-plan-examples.md | | Tasks | | | | Create tasks | task-creation-principles | task-creation-principles.md | | Template guide | task-creation-template-guide | task-creation-template-guide.md | | Templates | | | | All templates | templates | templates.md | | Spec template | template-spec | template-spec.md | | Design template | template-design | template-design.md | | Task template | template-task | template-task.md | | Workflows | | | | Workflow overview | workflows | workflows.md | | Spec phase | workflow-spec-phase | workflow-spec-phase.md | | Design phase | workflow-design-phase | workflow-design-phase.md | | Other | | | | Backlog grooming | backlog-grooming-roadmapping | backlog-grooming-roadmapping.md | | ADR | architecture-decision-records | architecture-decision-records.md | | API-first | api-first-development | api-first-development.md |
Methodologies (28)
| Category | Count | Files | |----------|-------|-------| | Specifications | 7 | writing-specifications, spec-structure, spec-requirements, spec-advanced-guidelines, spec-examples-basic, spec-example-ecommerce-cart, ai-assisted-specification-writing | | Design Documents | 4 | design-doc-structure, design-doc-writing-process, design-doc-advanced-patterns, design-doc-examples | | Implementation Plans | 5 | writing-implementation-plans, impl-plan-100k-rule, impl-plan-components, impl-plan-task-format, impl-plan-examples | | Tasks | 2 | task-creation-principles, task-creation-template-guide | | Templates | 4 | templates, template-spec, template-design, template-task | | Workflows | 3 | workflows, workflow-spec-phase, workflow-design-phase | | Other | 3 | backlog-grooming-roadmapping, architecture-decision-records, api-first-development |
Related Sub-Skill
faion-sdd-execution - Quality gates, reflexion, patterns, memory, execution workflows.
faion-sdd-planning v1.0 Planning phase: specs → design → impl-plan → tasks