run-workflow-in-this-repo

How-to: Run the Prompt Workflow in This Repo

Refer to the canonical standards in .github/instructions/prompt-standards.md for process enforcement, interactive protocol, IDs, and status tokens.

Prerequisites

  • VS Code with this workspace open
  • The included tasks for Go build/test (see Run section)

Steps

  1. Start with Author Specification

    • Use .github/prompts/author-specification.prompt.md
    • This will analyze the current Go codebase under cmd/ and internal/
    • Approve the generated docs/specification.md

  2. Derive the Implementation Plan

    • Use .github/prompts/derive-implementation-plan.prompt.md
    • Outputs to docs/plan/

  3. Decompose a Feature

    • Use .github/prompts/decompose-feature-work.prompt.md

  4. Implement the Next Work Item

    • Use .github/prompts/implement-next-work-item.prompt.md
    • Make minimal code changes and add/update tests

  5. If decisions shift, Author and Propagate an ADR

    • Use .github/prompts/author-adr.prompt.md then .github/prompts/propagate-adr.prompt.md

Run build and tests

Use the predefined VS Code tasks:

  • Build: Task “go build all”
  • Test: Task “go test all”