Can I use this on an existing codebase?

Yes, the skill includes 'brownfield' detection that scans your existing tech stack, dependencies, and database migrations to auto-populate the generated documentation.

What is the Project Initialization Phase skill?

It is a specialized Claude Code skill that automates the setup of new or existing projects by generating eight core architectural documents through interactive questioning and automated codebase analysis.

How does the skill ensure documentation accuracy?

It follows a strict principle of marking unknown information with '[NEEDS CLARIFICATION]' markers instead of hallucinating details, allowing users to provide missing context manually.

What specific documents are generated?

It generates eight files: Overview, System Architecture, Tech Stack, Data Architecture, API Strategy, Capacity Planning, Deployment Strategy, and Development Workflow.

How does it handle existing documentation to avoid data loss?

The skill includes a safety check; if a documentation directory already exists, it prompts you to backup existing docs, merge new sections, or abort the process.

Project Initialization Phase

Name: Project Initialization Phase
Author: marcusgoll

bymarcusgoll

•

학습 및 문서화

Orchestrates comprehensive project documentation and architectural foundations through interactive questionnaires and intelligent codebase scanning.

The Project Initialization Phase skill implements Spec-Driven Development by guiding users through a structured setup for both greenfield and brownfield projects. It automates the generation of eight critical architectural documents—including system design, data modeling, and deployment strategies—by conducting a 15-question interactive session and performing deep analysis of existing codebases. By prioritizing planning and architectural consistency, it ensures every project starts with a clear, auditable roadmap while minimizing AI hallucinations through 'Needs Clarification' tagging.

주요 기능

01Intelligent codebase scanning to auto-detect tech stacks and generate ERD diagrams from migrations

02Concurrent generation of eight standardized markdown documents covering architecture, API, and deployment

03Automated project type detection for greenfield and brownfield repositories

04Interactive 15-question survey to capture project vision, scale, and technical constraints

05Built-in cross-document consistency validation and quality gate checks

0618 GitHub stars

사용 사례

01Aligning technical teams on project vision, infrastructure, and development workflows

02Establishing a standardized documentation foundation for brand new software projects

03Auditing and documenting the architecture of existing brownfield codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add marcusgoll/spec-flow project-initialization-phase

For use in Claude.ai and ChatGPT

Download Skill