Where are the specifications stored during this process?

Specifications are moved from the ./specs/draft/{spec-name} directory to the ./specs/active/{spec-name} directory, ensuring a clean separation of work-in-progress and ready-to-code tasks.

Can I promote a spec if a validation gate has failed?

No, failed gates for Initiatives will block promotion. Users must resolve the underlying issues that caused the gate failure before the spec can be moved to the active stage.

Does this skill update the actual content of my documentation?

Spec Promote specifically updates the YAML frontmatter in your spec.md file, changing the status and stage fields to 'Active' and adding the current promotion date.

What happens if there are unresolved markers in the spec?

The skill will identify any open markers in the validation.yaml file, warn you about the unresolved ambiguities, and ask for explicit confirmation before proceeding with the promotion.

Spec Promote

Name: Spec Promote
Author: srnnkls

bysrnnkls

Productivity & Workflow

Transitions technical specifications from draft status to active implementation readiness by validating markers and updating metadata.

About

Spec Promote is a workflow automation skill for Claude Code designed to streamline the transition of technical specifications from the ideation phase to the execution phase. It automatically verifies that a specification has passed all required validation gates and resolved critical markers before moving files from the draft directory to the active directory. By updating frontmatter metadata and ensuring documentation completeness, it provides a reliable handoff for implementation tools, ensuring that only vetted and approved designs move into production.

Key Features

Contextual awareness of existing draft specifications for easy selection
0 GitHub stars
Automatic frontmatter metadata updates including status and promotion dates
Interactive marker resolution alerts with override capabilities
Automated directory migration from draft to active storage
Validation gate checking to block promotion of failed initiatives

Use Cases

Moving a validated feature specification into the implementation phase
Ensuring architectural requirements are met before starting development
Maintaining an organized project structure by separating draft ideas from active tasks

About

Key Features

Contextual awareness of existing draft specifications for easy selection
0 GitHub stars
Automatic frontmatter metadata updates including status and promotion dates
Interactive marker resolution alerts with override capabilities
Automated directory migration from draft to active storage
Validation gate checking to block promotion of failed initiatives

Use Cases

Moving a validated feature specification into the implementation phase
Ensuring architectural requirements are met before starting development
Maintaining an organized project structure by separating draft ideas from active tasks