feat(ce-plan): add output structure and scope sub-categorization (#542)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Trevin Chow
2026-04-09 19:22:21 -07:00
committed by GitHub
parent bb59547a2e
commit f3cc7545e5

View File

@@ -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]
<!-- Optional: When some items are planned work that will happen in a separate PR, issue,
or repo, use this sub-heading to distinguish them from true non-goals. -->
### 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]
<!-- Optional: Include when the plan creates a new directory structure (greenfield plugin,
new service, new package). Shows the expected output shape at a glance. Omit for plans
that only modify existing files. This is a scope declaration, not a constraint --
the implementer may adjust the structure if implementation reveals a better layout. -->
## Output Structure
[directory tree showing new directories and files]
<!-- Optional: Include this section only when the work involves DSL design, multi-component
integration, complex data flow, state-heavy lifecycle, or other cases where prose alone
would leave the approach shape ambiguous. Omit it entirely for well-patterned or
@@ -621,6 +649,8 @@ Before finalizing, check:
- Deferred items are explicit and not hidden as fake certainty
- If a High-Level Technical Design section is included, it uses the right medium for the work, carries the non-prescriptive framing, and does not contain implementation code (no imports, exact signatures, or framework-specific syntax)
- Per-unit technical design fields, if present, are concise and directional rather than copy-paste-ready
- If the plan creates a new directory structure, would an Output Structure tree help reviewers see the overall shape?
- If Scope Boundaries lists items that are planned work for a separate PR or task, are they under `### Deferred to Separate Tasks` rather than mixed with true non-goals?
- Would a visual aid (dependency graph, interaction diagram, comparison table) help a reader grasp the plan structure faster than scanning prose alone?
If the plan originated from a requirements document, re-read that document and verify: