spec-setup

Create repository documentation with product, tech, and feature specification templates.

1|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/wizact/dotclaude --skill spec-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-setup
Source: https://github.com/wizact/dotclaude/tree/main/wizact-marketplace/plugins/speculator/skills/spec-setup
Command: npx skills add https://github.com/wizact/dotclaude --skill spec-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of a comprehensive, context-driven documentation structure for any repository, ensuring clear separation of concerns between product and technical details, and establishing a standardized pattern for feature specifications.

Core Features & Use Cases

  • Automated Documentation Structure: Generates CLAUDE.md, docs/constitution/product.md, docs/constitution/tech.md, and feature templates.
  • Standardized Feature Specs: Creates docs/features/README.md and templates for requirements.md, design.md, and tasks.md.
  • Documentation Migration: Integrates and migrates existing convention files (.claude/project_rules.md, CONVENTIONS.md) into tech.md.
  • Use Case: When starting a new project or onboarding an AI agent to an existing one, invoke /spec-setup to instantly establish a robust documentation foundation that adheres to best practices for clarity and maintainability.

Quick Start

Use the spec-setup skill to establish a comprehensive documentation structure for the current repository.

Frequently Asked Questions about spec-setup

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

FAQPage Schema
How do I automate project documentation setup for a new repository?

You can automate project documentation setup by generating a multi-document constitution pattern with product.md and tech.md, alongside feature specification templates. This process analyzes your codebase to populate templates and establishes a clear separation of product and technical concerns.

What is a multi-document constitution pattern for repository documentation?

A multi-document constitution pattern separates project context into distinct files like product.md and tech.md. This structure ensures clear separation of concerns between product details and technical conventions, making repositories easier to navigate and maintain.

How do I migrate existing convention files into a new documentation structure?

Migrating existing convention files involves integrating content from files like .claude/project_rules.md and CONVENTIONS.md directly into the tech.md document. This consolidates scattered technical rules into the newly generated constitution structure.

Can I generate feature specification templates for any programming language?

Yes, you can generate language-agnostic feature specification templates. The setup creates a standardized feature directory containing requirements.md, design.md, and tasks.md templates that work across different programming environments.

What's the best way to structure feature specifications in a repository?

The best way to structure feature specifications is to create a dedicated docs/features directory with standardized templates. This includes separate files for requirements, design, and tasks, ensuring consistent documentation for every feature.

Does this documentation setup require existing convention files to work?

No, existing convention files are not required. The setup analyzes your codebase to populate templates from scratch, but if convention files like CONVENTIONS.md exist, it migrates their content into the new tech.md document.