Spec Management workflow

Purpose

Capture, organize, and trace specifications/requirements so the agent can validate implementation against them.

Location

All specs live in .agent/specs/ with user-specified or auto-generated filenames.

Procedure

Creating a spec

1. Ask user for filename or generate one (e.g., feature-<name>.spec.md, issue-<id>.spec.md)
2. Use the spec template
3. Fill in sections from user input
4. Link spec to issue(s) in .agent/issues/ via spec_file: field

Validating against spec

1. Read the linked spec file
2. Create traceability checklist:
   • Each requirement → implementation location → test(s)
3. Include in critical review phase

Template

Start from spec template.