SDD Domain Skill (Orchestrator) Skill

Entry point: /faion-net — invoke this skill for automatic routing to the appropriate domain.

SDD Domain Skill (Orchestrator)

Communication: User's language. Docs/code: English.

Philosophy

"Intent is the source of truth" - specification is the main artifact, code is just its implementation.

No Time Estimates: Use complexity levels (Low/Medium/High) and token estimates (~Xk) instead.

Context Discovery

Auto-Investigation

Check for existing SDD structure:

| Signal | How to Check | What It Tells Us | |--------|--------------|------------------| | .aidocs/ | Glob("**/.aidocs/") | SDD structure exists | | constitution.md | Read(".aidocs/constitution.md") | Tech stack, standards defined | | roadmap.md | Read(".aidocs/roadmap.md") | Features planned | | backlog/ | Glob("**/.aidocs/backlog/*") | Features in queue | | todo/ | Glob("**/.aidocs/todo/*") | Ready features | | in-progress/ | Glob("**/.aidocs/in-progress/*") | Active work | | memory/ | Glob("**/.aidocs/memory/*") | Learning artifacts |

Read existing artifacts:

constitution.md for constraints and standards
Any existing specs/designs for patterns
memory/patterns.md for learned patterns

Discovery Questions

Q1: SDD Phase

question: "What phase of SDD workflow are you in?"
header: "Phase"
multiSelect: false
options:
  - label: "Starting new project (need constitution)"
    description: "Bootstrap SDD structure"
  - label: "Planning a feature (spec/design)"
    description: "Write spec, design, impl-plan"
  - label: "Ready to execute (have tasks)"
    description: "Implement planned tasks"
  - label: "Reviewing/improving"
    description: "Quality gates, code review"

Routing:

"Starting" → constitution-guidelines, project bootstrap
"Planning" → Skill(faion-sdd-planning)
"Execute" → Skill(faion-sdd-execution) or Skill(faion-feature-executor)
"Reviewing" → Skill(faion-sdd-execution) → quality-gates

Q2: Document Type (if planning)

question: "What document do you need to create?"
header: "Document"
multiSelect: false
options:
  - label: "Specification (what to build)"
    description: "Requirements, success criteria"
  - label: "Design document (how to build)"
    description: "Architecture, API contracts"
  - label: "Implementation plan (tasks)"
    description: "Task breakdown, dependencies"
  - label: "All of the above"
    description: "Full planning cycle"

Q3: Feature Complexity

question: "How complex is the feature?"
header: "Complexity"
multiSelect: false
options:
  - label: "Low (< 50k tokens)"
    description: "Single task, straightforward"
  - label: "Medium (50-150k tokens)"
    description: "Multiple tasks, some complexity"
  - label: "High (> 150k tokens)"
    description: "Many tasks, architectural changes"

Context impact:

"Low" → Single task, less formal docs
"Medium" → Standard SDD workflow
"High" → Detailed spec, parallel execution

Architecture

This skill orchestrates 2 sub-skills:

| Sub-Skill | Scope | Methodologies | |-----------|-------|---------------| | faion-sdd-planning | Specs, design docs, impl-plans, tasks, templates, workflows | 28 | | faion-sdd-execution | Quality gates, reflexion, patterns, memory, code review, context | 20 |

Total: 48 methodologies

Workflow Overview

CONSTITUTION → SPEC → DESIGN → IMPL-PLAN → TASKS → EXECUTE → DONE
      |          |        |          |          |         |        |
   project    feature  technical   100k rule   atomic   agent    learn
   principles  intent   approach   compliance   units  execution reflect

When to Use Which Sub-Skill

Use faion-sdd-planning for:

Writing specifications (WHAT + WHY)
Creating design documents (HOW)
Breaking down implementation plans (TASKS)
Task creation from impl-plans
Template usage
Workflow navigation

Use faion-sdd-execution for:

Task execution workflows
Quality gate validation (L1-L6)
Code review cycles
Reflexion learning (PDCA)
Pattern/mistake memory management
Context management strategies
Task parallelization analysis

Quick Decision Tree

| If you need... | Invoke | Why | |----------------|--------|-----| | Write spec | faion-sdd-planning | Documentation phase | | Write design doc | faion-sdd-planning | Documentation phase | | Create impl-plan | faion-sdd-planning | Documentation phase | | Create tasks | faion-sdd-planning | Documentation phase | | Get templates | faion-sdd-planning | Templates stored there | | Run quality gates | faion-sdd-execution | Validation phase | | Execute tasks | faion-sdd-execution | Execution phase | | Code review | faion-sdd-execution | Review phase | | Learn patterns | faion-sdd-execution | Learning phase | | Check mistakes | faion-sdd-execution | Learning phase | | Parallelize tasks | faion-sdd-execution | Optimization phase |

Directory Structure

.aidocs/
├── constitution.md                    # Project principles
├── contracts.md                       # API contracts
├── roadmap.md                         # Milestones
└── features/
    ├── backlog/                       # Waiting for grooming
    ├── todo/                          # Ready for execution
    ├── in-progress/                   # Being worked on
    └── done/                          # Completed
        └── {NN}-{feature}/
            ├── spec.md                # WHAT and WHY
            ├── design.md              # HOW
            ├── implementation-plan.md # Tasks breakdown
            └── tasks/
                ├── backlog/
                ├── todo/              # Ready tasks
                ├── in-progress/       # Executing
                └── done/              # Completed

Lifecycle: backlog/ → todo/ → in-progress/ → done/

Agents

| Agent | Purpose | Sub-Skill | |-------|---------|-----------| | faion-task-executor-agent | Execute SDD tasks autonomously | execution | | faion-task-creator-agent | Create detailed TASK_*.md files | planning | | faion-sdd-reviewer-agent | Quality gate reviews | execution | | faion-hallucination-checker-agent | Validate task completion | execution |

Memory Storage

Location: Project-local .aidocs/memory/ (not global)

.aidocs/memory/
├── patterns.md           # Learned patterns
├── mistakes.md           # Errors and solutions
├── decisions.md          # Key decisions
└── session.md            # Session state

Related Skills

| Skill | Relationship | |-------|--------------| | faion-net | Parent orchestrator | | faion-feature-executor | Executes SDD tasks in sequence | | faion-software-developer | Implements code from tasks | | faion-product-manager | Provides product specs | | faion-software-architect | Provides design documents |

faion-sdd v4.0 (Orchestrator) Sub-skills: faion-sdd-planning (28) + faion-sdd-execution (20)

Agent Skills: SDD Domain Skill (Orchestrator)

Install this agent skill to your local

Skill Files