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