Documentation Writing Skill

What problem does it solve?

This Skill helps you organize documentation into a traceable workflow so designs and requirements lead directly to executable BDD tests, reducing ambiguity and rework.

Core Features & Use Cases

• Document relationship model: Guides you from PLAN and REQUIREMENTS through FEATURE SPEC and into BDD TESTS and TEST RESULTS.
• Clear document types and locations: Enforces where each artifact belongs (research, requirements, NFR/SLO, architecture, ADR, design, spec, guides, tracking, reports).
• Workflow for new features: Provides an end-to-end drafting sequence that keeps architecture decisions and implementation details aligned with testing.
• Writing and governance rules: Requires executable specs in test/ using *_spec.spl and discourages writing spec.md, while prescribing formatting standards for research/design documents.

Quick Start

Use the Documentation Writing Skill to produce a complete feature documentation set where requirements and design are explicitly linked to *_spec.spl BDD tests for a new feature.