Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

Refine `plan-template.md` with improved project type detection, clarified structure decision process, and enhanced research task guidance.

Dan Washusendf3e4930cc53
diff --git a/templates/plan-template.md b/templates/plan-template.md
index e812b4126..283ffd4b3 100644
--- a/templates/plan-template.md
+++ b/templates/plan-template.md
@@ -15,7 +15,7 @@ scripts:
1. Load feature spec from Input path
β†’ If not found: ERROR "No feature spec at {path}"
2. Fill Technical Context (scan for NEEDS CLARIFICATION)
- β†’ Detect Project Type from context (web=frontend+backend, mobile=app+api)
+ β†’ Detect Project Type from file system structure or context (web=frontend+backend, mobile=app+api)
β†’ Set Structure Decision based on project type
3. Fill the Constitution Check section based on the content of the constitution document.
4. Evaluate Constitution Check section below
@@ -69,8 +69,14 @@ specs/[###-feature]/
```
### Source Code (repository root)
+<!--
+ ACTION REQUIRED: Replace the placeholder tree below with the concrete layout
+ for this feature. Delete unused options and expand the chosen structure with
+ real paths (e.g., apps/admin, packages/something). The delivered plan must
+ not include Option labels.
+-->
```
-# Option 1: Single project (DEFAULT)
+# [REMOVE IF UNUSED] Option 1: Single project (DEFAULT)
src/
β”œβ”€β”€ models/
β”œβ”€β”€ services/
@@ -82,7 +88,7 @@ tests/
β”œβ”€β”€ integration/
└── unit/
-# Option 2: Web application (when "frontend" + "backend" detected)
+# [REMOVE IF UNUSED] Option 2: Web application (when "frontend" + "backend" detected)
backend/
β”œβ”€β”€ src/
β”‚ β”œβ”€β”€ models/
@@ -97,15 +103,16 @@ frontend/
β”‚ └── services/
└── tests/
-# Option 3: Mobile + API (when "iOS/Android" detected)
+# [REMOVE IF UNUSED] Option 3: Mobile + API (when "iOS/Android" detected)
api/
└── [same as backend above]
ios/ or android/
-└── [platform-specific structure]
+└── [platform-specific structure: feature modules, UI flows, platform tests]
```
-**Structure Decision**: [DEFAULT to Option 1 unless Technical Context indicates web/mobile app]
+**Structure Decision**: [Document the selected structure and reference the real
+directories captured above]
## Phase 0: Outline & Research
1. **Extract unknowns from Technical Context** above: