How does this skill organize my documentation files?

It automatically moves files between subdirectories like /draft, /approved, /reference, and /archive based on the status you set, keeping your repository organized.

Can I link a Tech Spec to an RFC?

Yes, you can use the --link-rfc option to update the decision reference in the specification's frontmatter for better traceability.

Does moving files break my Git history?

No, the skill is designed to use 'git mv' where possible to ensure that the version history of your documentation is preserved across status changes.

What happens when I archive a specification?

The skill moves the file to a year-specific archive directory, prompts for an archive reason, and updates the metadata with the archive date.

Tech Spec Lifecycle Manager

Name: Tech Spec Lifecycle Manager
Author: jpoutrin

byjpoutrin

•

Learning & Documentation

Manages the progression of technical specifications by tracking statuses, validating transitions, and automating document organization.

The Tech Spec Lifecycle Manager is a specialized tool designed to maintain a structured and organized technical architecture repository. It streamlines the lifecycle of technical specifications (Tech Specs) from initial drafting to approval, implementation, and eventual archiving. By enforcing valid status transitions and automatically relocating files into appropriate subdirectories (like /draft, /approved, or /reference), it ensures that documentation remains a reliable single source of truth. The skill also facilitates architectural traceability by linking specs to RFCs and maintaining metadata in file frontmatter, making it essential for teams following rigorous design-doc workflows.

Key Features

018 GitHub stars

02Automated file organization across status-based subdirectories

03RFC linking to maintain traceability between design decisions and specs

04Preservation of file history using git integration for document moves

05Enforced status transitions (DRAFT to APPROVED to REFERENCE to ARCHIVED)

06Automated frontmatter updates for status and modification timestamps

Use Cases

01Transitioning a completed technical proposal from draft to approved for implementation

02Organizing technical debt by archiving deprecated architecture documents with recorded reasons

03Viewing a summarized snapshot of an existing specification's status and metadata

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge tech-spec-status

For use in Claude.ai and ChatGPT

Download Skill