diff --git a/plugins/compound-engineering/skills/ce-plan/SKILL.md b/plugins/compound-engineering/skills/ce-plan/SKILL.md index 3bda701..c57aed8 100644 --- a/plugins/compound-engineering/skills/ce-plan/SKILL.md +++ b/plugins/compound-engineering/skills/ce-plan/SKILL.md @@ -348,6 +348,20 @@ Frame every sketch with: *"This illustrates the intended approach and is directi Keep sketches concise — enough to validate direction, not enough to copy-paste into production. +#### 3.4b Output Structure (Optional) + +For greenfield plans that create a new directory structure (new plugin, service, package, or module), include an `## Output Structure` section with a file tree showing the expected layout. This gives reviewers the overall shape before diving into per-unit details. + +**When to include it:** +- The plan creates 3+ new files in a new directory hierarchy +- The directory layout itself is a meaningful design decision + +**When to skip it:** +- The plan only modifies existing files +- The plan creates 1-2 files in an existing directory — the per-unit file lists are sufficient + +The tree is a scope declaration showing the expected output shape. It is not a constraint — the implementer may adjust the structure if implementation reveals a better layout. The per-unit `**Files:**` sections remain authoritative for what each unit creates or modifies. + #### 3.5 Define Each Implementation Unit For each unit, include: @@ -454,6 +468,12 @@ deepened: YYYY-MM-DD # optional, set when the confidence check substantively st - [Explicit non-goal or exclusion] + +### Deferred to Separate Tasks + +- [Work that will be done separately]: [Where or when -- e.g., "separate PR in repo-x", "future iteration"] + ## Context & Research ### Relevant Code and Patterns @@ -482,6 +502,14 @@ deepened: YYYY-MM-DD # optional, set when the confidence check substantively st - [Question or unknown]: [Why it is intentionally deferred] + +## Output Structure + + [directory tree showing new directories and files] +