lumiflare-claude-context-generator

lumiflare-claude-context-generator

Any repository → Claude Code context files in seconds.

Auto-generate REPOSITORY_OVERVIEW.md, feature_list.md, CLAUDE.md, and agent definitions for Claude Code.

Features

• Framework-agnostic — Detects PHP/Laravel, JS/TS/Next.js, Python/Django, Go/Gin, Ruby/Rails, Rust/Axum, and more
• Static analysis — Scans directory structure, routes, controllers, models, services, configs
• Agent team scaffolding — Generates 9 specialized agent definitions (architect, reviewer, implementer, etc.)
• Hybrid approach — CLI generates 80% from static analysis, then context-bootstrap agent refines with Claude's intelligence

Quick Start

# Run directly with npx
npx lumiflare-claude-context-generator init

# Or install globally
npm install -g lumiflare-claude-context-generator
ccg init

What It Generates

project/
  CLAUDE.md                              ← Claude Code instructions (adapted to your stack)
  docs/
    REPOSITORY_OVERVIEW.md               ← Architecture, tech stack, directory structure
    DOCUMENT_GUIDE.md                    ← Documentation standards
    feature/
      feature_list.md                    ← Feature map from controllers/routes/models
  .claude/
    agents/
      orchestrator.md                    ← Team workflow coordinator
      architect.md                       ← Design agent
      reviewer.md                        ← Code review agent
      implementer.md                     ← Implementation agent
      test-writer.md                     ← Test generation agent
      bug-investigator.md               ← Bug investigation agent
      refactoring-specialist.md          ← Refactoring agent
      doc-generator.md                   ← Documentation agent
      context-bootstrap.md               ← Deep analysis agent (refines CLI output)

Usage

Basic

# Analyze current directory (default: Japanese)
ccg init

# Generate in English
ccg init --lang en

# Analyze a specific directory
ccg init /path/to/project

# Preview without writing files
ccg init --dry-run

# Overwrite existing files
ccg init --force

Options

Option	Description
-l, --lang <language>	Language for generated context: ja (default), en
-f, --force	Overwrite existing files
--skip-agents	Skip generating .claude/agents/
--skip-docs	Skip generating docs/
--dry-run	Show analysis without writing files

Two-Phase Workflow

Phase 1: CLI Static Analysis (automatic)

The CLI detects your tech stack and scans the codebase:

✔ Detected: TypeScript + Next.js
✔ Scanned: 24 controllers, 18 models, 67 routes, 12 services
✔ Generated 13 files

Phase 2: Claude Deep Analysis (manual)

Open Claude Code in your project and say:

コンテキストを詳細化して

The context-bootstrap agent will:

1. Read your actual source code deeply
2. Refine REPOSITORY_OVERVIEW.md with architecture insights
3. Enhance feature_list.md with business logic details
4. Adapt CLAUDE.md rules to your project's conventions
5. Customize agent definitions for your stack

Detection Support

Language	Frameworks	ORM	Test
PHP	Laravel, Symfony, CakePHP, Slim	Eloquent, Doctrine	PHPUnit, Pest
JavaScript/TypeScript	Next.js, Nuxt, Express, Fastify, NestJS, Hono	Prisma, TypeORM, Sequelize, Drizzle, Mongoose	Jest, Vitest, Mocha, Playwright, Cypress
Python	Django, Flask, FastAPI	Django ORM, SQLAlchemy	pytest
Ruby	Rails, Sinatra	ActiveRecord	RSpec, Minitest
Go	Gin, Echo, Fiber	GORM	(built-in)
Rust	Actix Web, Rocket, Axum	Diesel, SeaORM	(built-in)
Java/Kotlin	(detected from manifest)	—	—

License

MIT