Skip to content
legacy-to-ai-ready logo

Legacy to AI-Ready

legacy-to-ai-ready

Transform legacy codebases into AI-ready projects with Claude Code configurations. Use when (1) analyzing old projects to generate AI coding configurations, (2) creating CLAUDE.md, skills, subagents, slash commands, hooks, or rules for existing projects, (3) user wants to enable vibe coding for a...

SKILL.md

Full skill instructions

Legacy to AI-Ready

Transform legacy codebases into AI-ready projects by generating Claude Code configurations.

Quick Start (5-Minute Setup)

For most projects, start with just CLAUDE.md:

  1. Analyze: python scripts/​analyze_codebase.py [path]
  2. Create CLAUDE.md with build commands, code style, architecture overview
  3. Done - Claude can now write code following your project's conventions

Expand to full configuration only when needed.

Interactive Discovery

Before generating configs, ask these questions:

Project Scope:

  • What is this project? (web app, API, CLI, library)
  • Primary language and frameworks?
  • Team size? (solo, small team, enterprise)

Pain Points:

  • What mistakes do new developers commonly make?
  • What patterns should always be followed?
  • What operations are repeated frequently?

Integration Needs:

  • External services used? (databases, APIs, cloud)
  • CI/​CD pipeline? (GitHub Actions, Jenkins)
  • Code quality tools? (linters, formatters)

Configuration Decision Tree

Start
│
├─ Small project / Solo dev
│  └─ CLAUDE.md only
│
├─ Team project
│  ├─ Multi-language? → Add .claude/​rules/
│  ├─ Complex domain? → Add .claude/​skills/
│  ├─ Code reviews? → Add .claude/​agents/
│  └─ Repeated tasks? → Add .claude/​commands/
│
└─ Enterprise / Large team
   └─ All configurations + MCP servers + Hooks

Generated Configurations

ConfigPurposeWhen to Create
CLAUDE.mdProject memory (shared)Always (required)
CLAUDE.local.mdPersonal preferences (git-ignored)Individual customization
.claudeignoreFiles Claude should not accessSensitive files exist
.claude/​rules/​Path-specific rulesMulti-module projects
.claude/​skills/​Domain knowledgeComplex business logic
.claude/​agents/​Task specialistsRepeated review/​debug tasks
.claude/​commands/​Quick promptsCommon workflows
.claude/​settings.jsonHooks + permissionsAuto-formatting, security
MCP serversExternal toolsDatabase/​API integrations

Workflow

Phase 1: Automated Analysis

python scripts/​analyze_codebase.py [project-path]

The script detects:

  • Languages and frameworks
  • Directory structure patterns
  • Development tools (linters, formatters)
  • Git commit patterns
  • Environment variables
  • Code style indicators
  • CI/​CD configurations (GitHub Actions, etc.)
  • Sensitive files (warns about .env, credentials)

Output includes:

  • Recommendations for which configs to create
  • Security warnings for sensitive files
  • Suggested .claudeignore patterns

Phase 2: Context Gathering

Claude should read:

  1. 3-5 representative source files - understand naming, patterns
  2. Test files - understand testing approach
  3. Config files - package.json, tsconfig, etc.
  4. README/​docs - project overview
  5. Recent commits - understand commit style

Phase 2.5: Discover Existing Resources

Before creating custom configs, search for existing skills and MCP servers:

  1. Search skill marketplaces - SkillsMP, SkillHub.club, Claude Skills Hub
  2. Check GitHub repositories - awesome-claude-skills, themed skill collections
  3. Find relevant MCP servers - Glama, MCP Market, official registry

See references/​resource-discovery.md for complete directory of sources.

Tip: Many common needs (git commit, code review, database patterns) already have well-maintained skills available.

Phase 3: Generate Configurations

1. CLAUDE.md (Required)

Create at project root with:

  • Quick reference commands (build, test, lint)
  • Naming conventions
  • Architecture overview
  • Testing guidelines
  • Git workflow

See references/​claude-md-patterns.md.

2. Rules (If Multi-Module)

Create .claude/​rules/ when:

  • Multiple languages need different conventions
  • Modules have distinct patterns (frontend/​backend)
  • Path-specific requirements exist

See references/​rules-patterns.md.

3. Skills (If Complex Domain)

Create .claude/​skills/ when:

  • Domain-specific workflows exist (database, API patterns)
  • Team knowledge needs preservation
  • Complex procedures are repeated

See references/​skills-patterns.md.

4. Subagents (If Specialized Tasks)

Create .claude/​agents/ for:

  • Code review automation
  • Debugging assistance
  • Security auditing
  • Documentation generation

See references/​agents-patterns.md.

5. Commands (If Common Operations)

Create .claude/​commands/ for:

  • Git commit workflow
  • PR review process
  • Deployment steps
  • Test running

See references/​commands-patterns.md.

6. Hooks (If Auto-Formatting Needed)

Configure .claude/​settings.json for:

  • Auto-format on file edit
  • Protected files
  • Command logging

See references/​hooks-patterns.md.

7. MCP Servers (If External Integrations)

Configure MCP for:

  • Database access
  • GitHub integration
  • Slack notifications
  • Custom internal tools

See references/​mcp-patterns.md.

Phase 4: Validate

  1. Ask Claude to perform a typical task
  2. Verify it follows project conventions
  3. Iterate based on gaps discovered

Output Structure

Minimal (small projects):

project/
├── CLAUDE.md
└── [existing files]

Standard (team projects):

project/
├── CLAUDE.md
├── .claude/
│   ├── rules/
│   │   └── code-style.md
│   └── commands/
│       └── commit.md
└── [existing files]

Complete (enterprise):

project/
├── CLAUDE.md              # Shared project memory
├── CLAUDE.local.md        # Personal (git-ignored)
├── .claudeignore          # Files to protect
├── .claude/
│   ├── settings.json      # Hooks + permissions
│   ├── rules/
│   ├── skills/
│   ├── agents/
│   └── commands/
└── [existing files]

Reference Materials

ReferenceWhen to Read
examples.mdComplete real-world examples
resource-discovery.mdFind existing skills & MCP servers
advanced-patterns.mdMigrations, team collab, monorepos
claude-md-patterns.mdCreating CLAUDE.md
rules-patterns.mdModule-specific rules
skills-patterns.mdDomain knowledge
agents-patterns.mdTask specialists
commands-patterns.mdQuick prompts
hooks-patterns.mdAuto-formatting
mcp-patterns.mdExternal tools

Templates & Bundled Skills

Templates:

  • assets/​CLAUDE.md.template - Project memory template
  • assets/​settings.json.template - Hooks configuration
  • assets/​claudeignore.template - File ignore patterns

Bundled skills to install in target project:

  • assets/​skill-creator/ - For creating new project-specific skills
  • assets/​skill-downloader/ - For downloading additional skills
  • assets/​resource-scout/ - For discovering existing skills & MCP servers

Installing Bundled Skills

Copy these skills to the target project's .claude/​skills/ directory:

cp -r assets/​skill-creator [target-project]/​.claude/​skills/
cp -r assets/​skill-downloader [target-project]/​.claude/​skills/
cp -r assets/​resource-scout [target-project]/​.claude/​skills/

This enables the target project to:

  1. resource-scout - Discover existing skills & MCP servers before building custom
  2. skill-downloader - Download and install skills from GitHub or archives
  3. skill-creator - Create custom skills tailored to their domain

Language Quick Reference

TypeScript/​JavaScript

  • Extract: eslint, prettier, tsconfig
  • Hooks: prettier auto-format
  • Skills: API patterns, component patterns

Python

  • Extract: black, ruff, mypy, pyproject.toml
  • Hooks: black/​ruff auto-format
  • Skills: API patterns, ORM patterns

Go

  • Extract: gofmt, golangci-lint
  • Hooks: gofmt auto-format
  • Skills: error handling patterns

Rust

  • Extract: rustfmt, clippy
  • Hooks: rustfmt auto-format
  • Skills: error handling, async patterns

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View