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

•

Developer Tools

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.

Key Features

01Automated scaffolding of docs/specs and docs/changes directories

02Intelligent detection of existing documentation to prevent accidental overwrites

03Built-in guidance for initializing RETROSPECTIVE.md and agent configurations

049 GitHub stars

05Idempotent execution allows for safe re-runs on existing projects

06Pre-configured directory structure for Spec PR workflows

Use Cases

01Starting a new software project with a spec-first methodology

02Adding structured documentation standards to an existing codebase without docs

03Standardizing repository layouts across a team for better AI agent navigation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bodangren/git-workflow .

For use in Claude.ai and ChatGPT

Download Skill