create-claude-context

Set up Claude Context Engineering for any project with a single command. Automatically analyzes your codebase and generates real documentation.

Quick Start

npx create-claude-context

Or with npm init:

npm init claude-context

What It Does

This CLI tool performs real codebase analysis and creates a complete context engineering system:

1. Analyzes codebase - Discovers entry points, workflows, architecture
2. Creates .claude/ directory - Populated with real project data
3. Creates CLAUDE.md - Entry point with actual file references
4. Detects tech stack - Auto-configures for your project
5. AI handoff - Creates instructions for @context-engineer (when in Claude Code)

Automatic Analysis

| What's Detected | Description | |-----------------|-------------| | Entry Points | API routes, CLI handlers, event listeners | | Workflows | Authentication, payments, data processing patterns | | Architecture | Directory structure, layers, dependencies | | Tech Stack | Languages, frameworks, package managers |

Options

npx create-claude-context [project-name] [options]

Options:
  -y, --yes          Skip prompts, use defaults
  --no-plugin        Skip Claude Code plugin installation
  -t, --template     Use a tech stack preset
  --no-git           Skip git initialization
  --dry-run          Show what would be done
  --ai               Force AI mode (requires Claude Code)
  --static           Force static-only analysis
  --analyze-only     Run analysis without installation
  -v, --verbose      Show detailed output
  -V, --version      Output version number
  -h, --help         Display help

Execution Modes

| Mode | Condition | Capabilities | |------|-----------|--------------| | full-ai | Claude Code + API key | Complete AI-enhanced analysis | | hybrid | Claude Code (no API) | Static analysis + AI handoff | | standalone | No Claude Code | Static analysis only |

In hybrid mode, INIT_REQUEST.md is created for @context-engineer to complete setup.

Tech Stack Presets

# Python
npx create-claude-context -t python-fastapi
npx create-claude-context -t python-django

# JavaScript/TypeScript
npx create-claude-context -t node-express
npx create-claude-context -t node-nestjs
npx create-claude-context -t typescript-nextjs
npx create-claude-context -t typescript-remix

# Other Languages
npx create-claude-context -t go-gin
npx create-claude-context -t rust-actix
npx create-claude-context -t ruby-rails
npx create-claude-context -t java-spring
npx create-claude-context -t csharp-dotnet
npx create-claude-context -t php-laravel

Features

After setup, you get:

RPI Workflow

• /rpi-research - Systematic codebase exploration
• /rpi-plan - Implementation blueprints with file:line precision
• /rpi-implement - Atomic changes with continuous testing

Specialized Agents

• @context-engineer - Setup and maintenance
• @core-architect - System design
• @database-ops - Database operations
• @api-developer - API development
• @integration-hub - External services
• @deployment-ops - CI/CD and infrastructure

Documentation System

• 3-level index hierarchy
• File:line references
• Self-maintaining documentation
• Validation commands

Directory Structure

your-project/
├── CLAUDE.md                 # Entry point for Claude
└── .claude/
    ├── agents/               # Specialized agents
    ├── commands/             # Slash commands
    ├── context/              # Pre-computed knowledge
    │   ├── workflows/        # Workflow documentation
    │   └── WORKFLOW_INDEX.md # Master index
    ├── indexes/              # Navigation hierarchy
    ├── plans/                # Implementation plans
    ├── research/             # Research documents
    └── schemas/              # JSON validation

Requirements

• Node.js 18+
• Claude Code CLI

Development

# Clone the repo
git clone https://github.com/SireJeff/claude-context-engineering-template.git
cd claude-context-engineering-template/packages/create-claude-context

# Install dependencies
npm install

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test:watch

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Run tests (npm test)
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

MIT

Links

• GitHub
• Documentation
• Issues