spec-workflow

Survey spec work management involves guiding specs from initial drafting through adversarial review to final resolution. This workflow automation stage-routes the process, reading reference files and logging decisions for auditable traceability across surveyverse packages.

An adversarial review for spec development is a structured stage where drafted specs are critically evaluated before resolution. This workflow routes the spec to Stage 2, reads rule-driven reference files to ensure consistency, and records structured review data for traceability.

An auditable decisions log for phase specs is created by routing work through structured stages from draft to resolution. This workflow records decisions and structured review data, storing files under .claude/skills/spec-workflow to ensure traceability across spec iterations.

Yes, this spec workflow supports surveycore package development and other surveyverse packages. It demonstrates cross-package applicability, applying standardized rule files to ensure consistency with coding, testing, and documentation conventions throughout the spec process.

To start drafting a phase spec using stage routing, trigger the workflow by saying "draft spec" to begin Stage 1. The system determines the active stage from context, reads stage reference files, and progresses sequentially through adversarial review to resolution.

Manual spec work without stage-driven workflow automation lacks standardized rule integration and auditable decision tracking. This can lead to inconsistent coding and testing conventions, missing structured review data, and lost traceability across spec iterations when resolving issues interactively.