context-engineer

Structured context management for AI coding agents. Install the .context/ system into any project with a single command.

Quick Start

# Run without installing globally
npx context-engineer init

# — or — install globally and invoke anywhere
npm install -g context-engineer
context-engineer init

This installs the context engineering system into your current project directory. Then open Claude Code and run:

/bootstrap-context

This analyzes your codebase and populates the context files with your project's specifics.

What Gets Installed

| Component | Contents | Default | |-----------|----------|---------| | Core | .context/ directory, scripts/, AGENTS.md | Always | | Claude Code | .claude/ (skills, rules, hooks), CLAUDE.md | Yes | | Cursor | .cursor/rules/, .cursorrules | Optional | | GitHub | Copilot instructions, CI drift detection workflow | Optional |

Usage

Interactive Install

npx context-engineer init

Prompts you to select which AI tool integrations to install.

Preset Install

# Core + Claude Code (most common)
npx context-engineer init --preset claude

# Everything
npx context-engineer init --preset all

# Core only (no tool integrations)
npx context-engineer init --preset core

# Core + Cursor
npx context-engineer init --preset cursor

Options

npx context-engineer init --force        # Overwrite existing files
npx context-engineer init --dry-run      # Preview without writing
npx context-engineer init --dir ./myapp  # Install to a specific directory

Update Templates

npx context-engineer update          # Smart update: framework files always, content files only if untouched
npx context-engineer update --check  # Check for updates without applying
npx context-engineer update --force  # Overwrite customized content too
npx context-engineer update --yes    # Auto-confirm (non-interactive)

Files are classified as:

• Framework (.claude/, scripts/, CLAUDE.md) — always updated to latest version
• Content (.context/architecture/, business/, AGENTS.md, etc.) — preserved if customized since install

Non-TTY environments (Claude Code Bash tool, CI) auto-confirm prompts.

After Installation

1. Claude Code: Run /bootstrap-context to populate templates from your codebase
2. Cursor: The .cursor/rules/ files activate automatically
3. GitHub Copilot: The .github/copilot-instructions.md activates automatically
4. All tools: Read AGENTS.md for the universal entry point

How It Works

The context system provides AI coding agents with structured project knowledge:

• .context/constitution.md — Project identity, principles, and a route table that tells agents what to load
• .context/architecture/ — Tech stack, data models, API surface, module graph
• .context/conventions/ — Code style, patterns, testing, error handling
• .context/experience/ — Lessons learned, debugging solutions, performance insights
• scripts/ — Drift detection, context sync, structure extraction

License

MIT