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.yaml for suggestion-only defaults

Steps

  1. 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
  2. Review and approve docs/specification.md

    • Ensure Technology Stack and Acceptance Criteria are complete and rationalized
  3. Run Derive Implementation Plan prompt

    • Creates a plan under docs/plan/
    • Validates against the approved spec and captures traceability
  4. Run Decompose Feature Work

    • For a chosen epic/feature, generate an executable breakdown
  5. 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