spec-driven

Draft next-version specifications and align them with current documentation.

Updated Nov 12, 2017
One-click install
npx skills add https://github.com/ak110/dotfiles --skill spec-driven-ak110
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven
Source: https://github.com/ak110/dotfiles/tree/main/plugins/agent-toolkit/skills/spec-driven
Command: npx skills add https://github.com/ak110/dotfiles --skill spec-driven-ak110

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill creates and coordinates next-version specifications and the accompanying documentation to keep future release plans aligned with the current docs.

Core Features & Use Cases

  • Next-version specification generation: Automatically draft the scope and requirements for upcoming releases based on user input.
  • Documentation integration planning: Map next-version content to existing docs and prepare promotion steps to merge after release.
  • Guided workflow: Orchestrate planning, implementation, verification, and review phases using agent-toolkit components like plan-mode and careful-impl to ensure traceability.

Quick Start

Initiate the spec-driven workflow to generate the next-version specification and prepare the integration plan for merging into the current docs after release.

Frequently Asked Questions about spec-driven

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent documentation drift when planning a next-version release?

To prevent documentation drift during release management, you create next-version specifications and cross-reference them with current docs. This aligns upcoming release scope with existing documentation to keep plans synchronized before promotion.

What is the best way to coordinate specifications for multi-theme projects?

Coordinating specifications for multi-theme projects involves drafting a next-version overview that explicitly documents each theme. You organize decisions by linking new scope to existing docs and capturing planning, implementation, and verification requirements.

How do I generate next-version specifications from current documentation?

Generating next-version specifications from current documentation requires mapping upcoming content to existing files and preparing promotion steps. The workflow drafts release scope and requirements based on your input to merge smoothly after release.

Does this specification workflow support guided planning and implementation phases?

Yes, this specification workflow supports guided planning and implementation phases. It orchestrates planning, careful implementation, verification, and review steps to ensure full traceability from next-version scope to final documentation integration.

Can I use this for release management without dedicated versioning tools?

Yes, you can use this for release management without dedicated versioning tools. It handles versioning by manually drafting next-version overviews and cross-referencing current documents to maintain alignment without external dependencies.

When should I not use a spec-driven workflow for documentation?

You should not use a spec-driven workflow for documentation if your project lacks distinct versioning cycles or multi-theme planning needs. It is designed for structured release management, so continuous or ad-hoc updates without formal scopes may find the overhead unnecessary.