skills/plan-context/SKILL.md
C4 Level 1 (Context) planning phase: define system boundaries, external actors, integrations, and scope decisions.
npx skillsauth add popoffvg/dotfiles plan-contextInstall 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.
Define the system's place in the world before diving into internals.
_notes/plan.md (if resuming)Write or update these sections in _notes/plan.md:
One paragraph: what the system/feature does, who it serves, why it exists.
Extract initial domain entities from the description. Each entry:
**<Term>** — <One-sentence definition in domain language>
context: <Bounded context or module>
aliases: <Alternative names if any>
Rules:
Order, not OrderDTO).For each, capture as a Decision entry:
| Question | Decision | |---|---| | What is in scope? | ... | | What is explicitly out of scope? | ... | | Who are the external actors (users, systems)? | ... | | What external systems do we integrate with? | ... | | What are the trust boundaries? | ... |
Format:
- D1 [L1, fixed]: <decision statement>
rationale: <why>
Write verifiable criteria as checkboxes. These may be refined in later phases.
All L1 decisions are fixed. No open questions remain at this level. Glossary seeded. Proceed to L2 (plan-container) or skip to the appropriate level.
testing
Use when the user asks to create test sets, enumerate scenarios, generate edge cases, or draft a coverage matrix before implementation.
testing
Use when the user asks to review, audit, score, or validate test sets for missed cases before execution or merge.
tools
Test harness plugins in isolation using tmux panes. Runs MCP servers, unit tests, typecheck, and Claude plugin loading. Use when user says "test plugin", "check plugin", "run plugin tests", "validate plugin", or names a specific plugin to test.
development
Guide for designing integration and e2e tests using BDD (Behavior-Driven Development) methodology with Cucumber-style Given/When/Then scenarios. Use when writing or reviewing tests for any service, API, or component. Language-agnostic — covers scenario structure, step notation, assertion principles, async patterns, and common anti-patterns.