What problem does it solve? Frontend and backend engineers drift apart when API conventions are not locked down, and stories get built against inconsistent or missing endpoint specs. This Skill establishes a single API contract document with shared architecture rules and specifies each story's endpoints one step ahead of its build, clearing the story's contract gate. ## Core Features & Use Cases - Contract Architecture Foundation: Creates the release-level contract defining auth pattern, URL and JSON conventions, error envelope, pagination, and versioning that every endpoint must obey. - Per-Story Endpoint Specification: Appends one story's endpoints under its own heading, validates gate state, and advances the story to contract_ready only after human acceptance. - Contract Path Management: Relocates the contract file or repoints the api_contract_path setting, with confirmation prompts and a scan for stale references. - Use Case: Before building story S7-20, run the contract command with that story id to have the api-contract-architect agent append its endpoints to the shared contract, review them, and clear the story's needs_contract gate. ## Quick Start Ask the agent to run /archflow-contract S7-20 to specify that story's endpoints against the existing contract architecture and clear its contract gate.
