to-spec
To Spec
Synthesize the current conversation, active project artifacts, and codebase
understanding into a specification. Do not interview the user; use grill-with-docs
when decisions remain unresolved.
Resolve every .agents/projects/ path from the repository root; never read or write
project artifacts in a global agent-installation directory.
Process
-
Identify the active project and read
.agents/projects/<project>/CONTEXT.md,LINKS.md, relevant ADRs, and existing specs. Explore the current codebase where necessary.Done when the spec uses confirmed project language and respects relevant decisions.
-
Sketch the seams at which the feature will be tested. Prefer the highest existing seam; propose a new seam only when necessary. Check that the seams meet the user's expectations before proceeding.