Wcpaxx Spec Kit Brownfield Extensions Brownfield Skills

Brownfield Developer Skills Generator

Generate Claude Code Project Skills for brownfield (existing) projects.

What This Skill Does

Analyze an existing project and generate structured Skills files that enable AI to:

1. Master the project - Deep understanding of tech stack, architecture, and code style
2. Follow conventions - Work according to existing coding patterns
3. Ensure compatibility - Maintain backward compatibility when extending
4. Reuse code first - Prioritize existing implementations over new code

Quick Start

1. Run this skill in your project root
2. Generated Skills are placed in .claude/skills/brownfield-developer-[project-name]/
3. Claude Code automatically loads these Skills

Output Structure

.claude/skills/brownfield-developer-[project-name]/
├── SKILL.md                    # Entry point with project overview
└── references/
    ├── architecture.md         # Architecture and layering
    ├── tech-stack.md           # Tech stack and versions
    ├── coding-conventions.md   # Coding standards
    ├── module-structure.md     # Module responsibilities
    └── development-patterns.md # Development patterns

Execution Process

Phase 0: Deep Project Analysis

Analyze the project like a senior engineer taking over:

1. Tech Stack Identification - See references/analysis-guide.md
2. Architecture Recognition - See references/analysis-guide.md
3. Conventions Extraction - See references/analysis-guide.md
4. Module Analysis - See references/analysis-guide.md
5. Pattern Recognition - See references/analysis-guide.md

Phase 1: Generate Skills Files

Transform analysis into structured Skills using templates in references/templates.md.

Phase 2: Validation

Verify generated Skills:

• Directory structure is correct
• All 5 reference files exist
• SKILL.md entry is valid
• Reference links work

Pre-Output Checklist

Brownfield Principles

1. Respect existing architecture - Don't "improve", follow accurately
2. Code reuse first - Search existing code before creating new
3. Forward compatibility - New features must not break existing
4. Refactor on-demand - Only when necessary

Reference Files

• references/analysis-guide.md - Detailed analysis procedures
• references/templates.md - Output file templates
• references/templates-cn.md - Chinese templates

Integration

Works alongside Repomix:

1. Run repomix --skill-generate for code snapshots
2. Run this skill for development expertise
3. Together they provide complete project mastery

Converted and distributed by TomeVault — claim your Tome and manage your conversions.