skills/plan-component/SKILL.md
C4 Level 3 (Component) planning phase: define internal modules, responsibilities, interfaces, and dependency decisions.
npx skillsauth add popoffvg/dotfiles plan-componentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Design the internal structure of each container — modules, packages, interfaces.
All L1 and L2 decisions must be fixed.
Update _notes/plan.md with:
| Question | Decision | |---|---| | What packages/modules exist in each container? | ... | | What are their responsibilities? | ... | | What interfaces do they expose? | ... | | What are the dependency directions? | ... | | What patterns apply? (repository, service, handler) | ... |
Format:
- D20 [L3, fixed]: <decision statement>
rationale: <why>
Add domain terms for internal concepts (aggregates, value objects, services). Every domain noun used in TODOs must have an entry.
Create TODOs for component-level work (module creation, interface definition, wiring):
- [ ] T20: ...
- level: L3
- files: `path/to/file`
- criteria: AC...
- decisions: D20
All L3 decisions are fixed. No open questions at this level. No contradiction with L1/L2 decisions. Proceed to L4 (plan-code).
tools
Improve a whole CLAUDE.local.md — the private, per-project rules captured from user corrections. Wraps each conditional rule in a <task-relevant> block so it only surfaces for matching work, merges duplicates, generalizes one-off facts, drops stale entries, and routes raw project facts to engram. Use when the user says "improve claude.local", "clean up the local rules", "claude.local is bloated", or after the Stop hook has appended many rules.
testing
WM pipeline and conventions shared across all phases. Agents must read this before spec, impl, or verify work.
development
One entry point for spec writing, implementation, and bug fixing. Default is new (write spec → grill loop → produce notes → author TODO bodies). Other subcommands: verify (audit), revise (sync to shipped), prototype (settle a decision), code-map (diagram), impl (execute one TODO), fix (analyze cause, correct thoughts, fix behavior), help (this page). Invoke as /code <subcommand>.
development
Red-Green-Refactor cycle for bug fixes. Before fixing a bug, first write a failing test that reproduces it (Red), then make the minimal change to pass (Green), then clean up the code (Refactor). Use on any bug fix, error correction, failing test repair, or when user says "fix this bug".