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*