greenfield
Tutorial: Greenfield Project with Prompts
Goal: Create a complete spec and initial plan for a new system starting from an empty or minimal repo.
Prerequisites
- Optional:
.github/presets/greenfield-tech-defaults.yamlfor suggestion-only defaults
Steps
-
Run the Author Specification prompt
- Input: System name
- The prompt will ask discovery questions; it may surface presets as “Org Preset (suggestion)”
- Confirm selections at the Confirmation Gate; after this, presets are ignored
-
Review and approve
docs/specification.md- Ensure Technology Stack and Acceptance Criteria are complete and rationalized
-
Run Derive Implementation Plan prompt
- Creates a plan under
docs/plan/ - Validates against the approved spec and captures traceability
- Creates a plan under
-
Run Decompose Feature Work
- For a chosen epic/feature, generate an executable breakdown
-
Implement Next Work Item
- Apply minimal, consistent changes; keep traceability
Outcomes
- Deterministic spec with Technology Stack and DOC plan
- Traceable plan, breakdown, and initial progress