spec-writing

To create a specification aligned with architecture rules, use a skeleton-driven workflow with templates and checklists to enforce frontmatter compliance and ensure inclusion of reference materials. Start with a TLDR and skeleton, then track open questions and iterate.

A skeleton-driven workflow for specifications involves starting with a basic structural template, adding a TLDR, and iteratively refining the document. This approach ensures consistency, enforces frontmatter compliance, and reduces ambiguity before implementation begins.

Handle open questions during specification writing by tracking them within the document to surface critical unknowns early. This guides decision-making and iterative refinement, ensuring all architectural and quality requirements are met before consensus.

The best way to review a SPEC for quality and compliance is to apply provided checklists and reference materials. This iterative refinement process verifies alignment with AGENTS guidelines, architectural standards, and frontmatter rules.

Yes, you can use templates to accelerate specification creation. Template-driven drafting provides a consistent skeleton and enforces inclusion of necessary reference materials, reducing ambiguity and accelerating consensus before implementation.

You should not skip checklists for specification refinement when architectural alignment and quality rules are critical. Checklists are essential for verifying frontmatter compliance and ensuring all open questions are resolved during the iterative drafting process.