Browse / Learning Documentation / Spec Scaffold

Spec Scaffold

Automates the creation and maintenance of technical documentation through template-based Specification-Driven Development workflows.

SkillLearning DocumentationDocs StandardsOrchestrationTemplate

The source repository doesn't declare a license. Check its terms before reusing the code.

Key features

  • Standardized template generation for constitutions, architectures, and roadmaps
  • Automated copying and updating of Specification-Driven Development documents
  • Structured management of glossaries and project-specific terminology
  • Automated workflow planning using TodoWrite integration
  • Interactive information gathering to populate specific document requirements

Use cases

  • Initializing a new software project with foundational governance and architectural documentation
  • Maintaining an evolving project roadmap and glossary to ensure team-wide alignment
  • Recording complex design choices using standardized Architecture Decision Record templates

FAQ

What does the Spec Scaffold skill do?

Spec Scaffold automates the creation and maintenance of technical documentation. It uses standardized templates to help Claude generate project constitutions, architectures, roadmaps, and glossaries based on Specification-Driven Development (SDD) principles.

Does Spec Scaffold interact with my existing files?

Yes. It can identify existing documents that need updates, read their content, and apply modifications. If no document exists, it uses automated bash commands to copy the correct template into your project directory.

When should I use this skill?

You should use this skill whenever you are starting a new project or updating existing technical specs. It is specifically designed for handling constitutions, architectural decision records (ADRs), feature specifications, and project-specific glossaries.

How does Spec Scaffold improve my developer workflow?

It eliminates the manual effort of setting up documentation boilerplate. By utilizing the TodoWrite integration, it creates a structured plan to gather necessary information, ensuring your documentation is consistent, professional, and updated automatically.

What specific templates are included with this skill?

The skill includes templates for constitutions, specifications, roadmaps, glossaries, architecture overviews, and Architecture Decision Records (ADRs), providing a comprehensive toolkit for project lifecycle management.