Should I use project-init or project-migrate?

Use project-init for new projects or those without existing documentation. If your project already has markdown files in a 'docs/' folder, use project-migrate to preserve history and update links.

Is it safe to run this skill multiple times?

Yes, the initialization script is idempotent. It will detect existing directories and skip creation without overwriting or deleting your current files.

How does this improve AI agent performance?

By providing a predictable directory structure, AI agents can more reliably locate system requirements and historical context, leading to more accurate code generation and fewer errors.

What directories does this skill create?

The skill creates a 'docs/specs/' directory for approved source-of-truth specifications and a 'docs/changes/' directory for staging proposed updates and task breakdowns.

Spec-Driven Project Initializer

Name: Spec-Driven Project Initializer
Author: bodangren

bybodangren

•

开发者工具

Scaffolds standardized directory structures and configuration files to enable spec-driven development workflows in Claude Code.

关于

The Project Init skill establishes a foundational structure for spec-driven development by creating dedicated directories for approved specifications and proposed changes. It streamlines the transition to an AgenticDev workflow by automating the creation of source-of-truth documentation folders and providing guidance on essential supporting files like retrospectives and agent definitions. This skill is ideal for greenfield projects or existing codebases without established documentation, ensuring all team members and AI agents follow a consistent architectural convention from day one.

主要功能

Automated scaffolding of docs/specs and docs/changes directories
Intelligent detection of existing documentation to prevent accidental overwrites
Built-in guidance for initializing RETROSPECTIVE.md and agent configurations
9 GitHub stars
Idempotent execution allows for safe re-runs on existing projects
Pre-configured directory structure for Spec PR workflows

使用场景

Starting a new software project with a spec-first methodology
Adding structured documentation standards to an existing codebase without docs
Standardizing repository layouts across a team for better AI agent navigation

关于

主要功能

Automated scaffolding of docs/specs and docs/changes directories
Intelligent detection of existing documentation to prevent accidental overwrites
Built-in guidance for initializing RETROSPECTIVE.md and agent configurations
9 GitHub stars
Idempotent execution allows for safe re-runs on existing projects
Pre-configured directory structure for Spec PR workflows

使用场景

Starting a new software project with a spec-first methodology
Adding structured documentation standards to an existing codebase without docs
Standardizing repository layouts across a team for better AI agent navigation