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
1---2name: faion-sdd-planning3description: SDD planning: specifications, design docs, implementation plans, task creation.4---5> **Entry point:** `/faion-net` — invoke this skill for automatic routing to the appropriate domain.
6
7# SDD Planning Sub-Skill
8
9**Documentation planning phase of Specification-Driven Development.**
10
11**Communication: User's language. Docs/code: English.**
12
13---
14
15## Context Discovery
16
17### Auto-Investigation
18
19| Signal | Check For | Why |
20|--------|-----------|-----|
21| `.aidocs/` structure | SDD workflow in use (backlog, todo, in-progress, done) | SDD adoption status |
22| `spec.md` files | Specification format and quality | Spec standards present |
23| `design.md` files | Design doc patterns | Design approach |
24| `implementation-plan.md` | Task breakdown structure | Planning methodology |
25| `TASK-*.md` files | Task format, token estimates | Task creation standards |
26
27### Discovery Questions
28
29```yaml
30questions:
31 - question: "Which SDD phase are you in?"
32 options:
33 - label: "Writing specification"
34 description: "Use writing-specifications, spec-structure"
35 - label: "Creating design doc"
36 description: "Use design-doc-structure, design-doc-writing-process"
37 - label: "Breaking down into tasks"
38 description: "Use writing-implementation-plans, task-creation-principles"
39 - label: "Setting up SDD workflow"
40 description: "Use workflows, templates"
41
42 - question: "Do you have existing SDD documentation?"
43 options:
44 - label: "Yes, following SDD"
45 description: "Continue with established patterns"
46 - label: "Partial/inconsistent"
47 description: "Standardize using templates"
48 - label: "No, starting fresh"
49 description: "Start with spec-structure, templates"
50
51 - question: "What's your task complexity?"
52 options:
53 - label: "Simple features (<50k tokens)"
54 description: "Standard task breakdown"
55 - label: "Complex features (>100k tokens)"
56 description: "Apply impl-plan-100k-rule, split features"
57```
58
59---
60
61## Philosophy
62
63**"Intent is the source of truth"** - specification is the main artifact, code is implementation.
64
65**No Time Estimates:** Use complexity (Low/Medium/High) + token estimates (~Xk).
66
67---
68
69## Scope
70
71This sub-skill handles:
72- Writing specifications (WHAT + WHY)
73- Creating design documents (HOW)
74- Breaking down implementation plans (TASKS)
75- Task creation and templating
76- Workflow documentation
77
78---
79
80## Decision Tree
81
82| If you need... | Use | File |
83|----------------|-----|------|
84| **Specifications** | | |
85| Write spec | writing-specifications | [writing-specifications.md](writing-specifications.md) |
86| Spec structure | spec-structure | [spec-structure.md](spec-structure.md) |
87| Spec requirements | spec-requirements | [spec-requirements.md](spec-requirements.md) |
88| Advanced guidelines | spec-advanced-guidelines | [spec-advanced-guidelines.md](spec-advanced-guidelines.md) |
89| Basic examples | spec-examples-basic | [spec-examples-basic.md](spec-examples-basic.md) |
90| E-commerce example | spec-example-ecommerce-cart | [spec-example-ecommerce-cart.md](spec-example-ecommerce-cart.md) |
91| AI-assisted spec | ai-assisted-specification-writing | [ai-assisted-specification-writing.md](ai-assisted-specification-writing.md) |
92| **Design Documents** | | |
93| Design structure | design-doc-structure | [design-doc-structure.md](design-doc-structure.md) |
94| Writing process | design-doc-writing-process | [design-doc-writing-process.md](design-doc-writing-process.md) |
95| Advanced patterns | design-doc-advanced-patterns | [design-doc-advanced-patterns.md](design-doc-advanced-patterns.md) |
96| Examples | design-doc-examples | [design-doc-examples.md](design-doc-examples.md) |
97| **Implementation Plans** | | |
98| Write impl-plan | writing-implementation-plans | [writing-implementation-plans.md](writing-implementation-plans.md) |
99| 100k token rule | impl-plan-100k-rule | [impl-plan-100k-rule.md](impl-plan-100k-rule.md) |
100| Components | impl-plan-components | [impl-plan-components.md](impl-plan-components.md) |
101| Task format | impl-plan-task-format | [impl-plan-task-format.md](impl-plan-task-format.md) |
102| Examples | impl-plan-examples | [impl-plan-examples.md](impl-plan-examples.md) |
103| **Tasks** | | |
104| Create tasks | task-creation-principles | [task-creation-principles.md](task-creation-principles.md) |
105| Template guide | task-creation-template-guide | [task-creation-template-guide.md](task-creation-template-guide.md) |
106| **Templates** | | |
107| All templates | templates | [templates.md](templates.md) |
108| Spec template | template-spec | [template-spec.md](template-spec.md) |
109| Design template | template-design | [template-design.md](template-design.md) |
110| Task template | template-task | [template-task.md](template-task.md) |
111| **Workflows** | | |
112| Workflow overview | workflows | [workflows.md](workflows.md) |
113| Spec phase | workflow-spec-phase | [workflow-spec-phase.md](workflow-spec-phase.md) |
114| Design phase | workflow-design-phase | [workflow-design-phase.md](workflow-design-phase.md) |
115| **Other** | | |
116| Backlog grooming | backlog-grooming-roadmapping | [backlog-grooming-roadmapping.md](backlog-grooming-roadmapping.md) |
117| ADR | architecture-decision-records | [architecture-decision-records.md](architecture-decision-records.md) |
118| API-first | api-first-development | [api-first-development.md](api-first-development.md) |
119
120---
121
122## Methodologies (28)
123
124| Category | Count | Files |
125|----------|-------|-------|
126| Specifications | 7 | writing-specifications, spec-structure, spec-requirements, spec-advanced-guidelines, spec-examples-basic, spec-example-ecommerce-cart, ai-assisted-specification-writing |
127| Design Documents | 4 | design-doc-structure, design-doc-writing-process, design-doc-advanced-patterns, design-doc-examples |
128| Implementation Plans | 5 | writing-implementation-plans, impl-plan-100k-rule, impl-plan-components, impl-plan-task-format, impl-plan-examples |
129| Tasks | 2 | task-creation-principles, task-creation-template-guide |
130| Templates | 4 | templates, template-spec, template-design, template-task |
131| Workflows | 3 | workflows, workflow-spec-phase, workflow-design-phase |
132| Other | 3 | backlog-grooming-roadmapping, architecture-decision-records, api-first-development |
133
134---
135
136## Related Sub-Skill
137
138**faion-sdd-execution** - Quality gates, reflexion, patterns, memory, execution workflows.
139
140---
141
142*faion-sdd-planning v1.0*
143*Planning phase: specs → design → impl-plan → tasks*