Agent skill
faion-writing-implementation-plan
SDD Framework: Creates implementation-plan.md from design.md. Decomposes into tasks that fit 100k token context. Triggers on "implementation plan", "impl plan".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/faion-writing-implementation-plan
SKILL.md
SDD: Writing Implementation Plans
Communication: User's language. Docs: English.
Key Principle
Each task MUST fit 100k token context = atomic, single-agent executable.
Workflow
LOAD CONTEXT → ANALYZE COMPLEXITY → DEFINE WORK UNITS → APPLY 100k RULE → DEPENDENCIES → DRAFT → REVIEW → SAVE
Phase 1: Load Context
Read: constitution.md, spec.md, design.md
Phase 2: Analyze Complexity
For each file in design.md:
| File | Action | Complexity | Est. Tokens |
|---|---|---|---|
| models.py | CREATE | High | 40k |
| services.py | CREATE | High | 50k |
Factors: LOC, dependencies, business logic, tests
Phase 3: Define Work Units
Group related work:
## Work Unit 1: Data Layer
- models.py (CREATE)
Est: 40k tokens
Phase 4: Apply 100k Rule
Research: ~20k (read existing code)
Task file: ~5k
Implementation: ~50k
Buffer: ~25k
TOTAL < 100k
If > 100k: Split into smaller tasks.
Phase 5: Dependencies
| Task | Depends On | Enables |
|---|---|---|
| TASK_001 | — | TASK_003 |
| TASK_002 | — | TASK_003 |
| TASK_003 | 001, 002 | — |
Rules: No cycles, maximize parallelization.
Phase 6: Draft
Show section by section:
- Overview (total tasks, critical path, est. tokens)
- Tasks list (files, deps, FR/AD coverage, AC)
- Execution order (phases, parallel/sequential)
Phase 7: Review
Call faion-impl-plan-reviewer-agent agent. Checks: 100k compliance, deps, coverage.
Phase 8: Save
aidocs/sdd/{project}/features/{feature}/implementation-plan.md
Token Estimation Guide
| Component | Tokens |
|---|---|
| Django model simple | 5-10k |
| Django model complex | 15-25k |
| Service class | 20-40k |
| ViewSet | 15-30k |
| Test file | 20-40k |
Rule: If uncertain, estimate higher and split.
Output
implementation-plan.md → Next: faion-make-tasks skill (via /faion-net → create tasks)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?