HarnessCommunity★ 1k

Context Forge

Updated Jul 7, 2026

A CLI tool by Jason Webdev (v4.0.0) that generates the complete modern .claude/ surface from an Ink TUI wizard: a schema-locked settings.json with all 8 hook lifecycle events, 5 default sub-agents, 3 skills, 21 slash commands, 14 hook scripts, CLAUDE.md, Implementation.md, and Product Requirement Prompts. Supports Claude, Cursor, Windsurf, Cline, Roo, Gemini, and GitHub Copilot. Run npx context-forge or install globally.

View on GitHub

What it does

context-forge init
Run the 10-screen Ink TUI wizard to scaffold CLAUDE.md, settings.json, agents, skills, hooks, commands, and PRPs.
context-forge init --ai-prp
Generate AI-enhanced Product Requirement Prompts using the Anthropic or OpenAI API alongside the standard scaffold.
context-forge analyze
Retrofit an existing codebase with CLAUDE.md, tech-stack detection, and per-feature PRPs without overwriting existing files.
context-forge run-prp <name>
Execute a named PRP end-to-end with validation gates between stages.
context-forge migrate
Plan a tech-stack migration with phased execution, dependency analysis, and rollback procedures.
/validate
Run the full validation gate (lint, tests, coverage, build, security) from inside Claude Code.

Files (1)

OVERVIEW.mdprimary · markdown · 2.9 KB

## What it does

Context Forge (v4.0.0) is a CLI that generates the complete modern Claude Code project surface from a 10-screen Ink TUI wizard (ESC = back, Enter = advance, Ctrl-C = exit). It produces:

- CLAUDE.md — tech-stack-aware project rules with KISS/YAGNI directives and pre-commit checklist
- .claude/settings.json — schema-locked, wires all 8 Claude Code hook lifecycle events (PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, PreCompact, Stop, SubagentStop, Notification) plus mcpServers, statusLine, outputStyles, and permissions
- .claude/agents/ — 5 default sub-agents: code-reviewer, test-runner, plan-architect, security-auditor, prp-executor
- .claude/skills/ — 3 default skills: testing-protocol (renders test command/framework), deployment-checklist (tailored to detected deploy target), codebase-navigation
- .claude/commands/ — 21 slash commands across 6 subdirs: PRPs/, orchestration/, checkpoints/, quality/, session/, migration/
- .claude/hooks/ — 14 bash scripts + 4 Python scripts registered through settings.json
- PRPs/ — Product Requirement Prompts, optionally AI-enhanced via Anthropic or OpenAI API
- Docs/ — staged Implementation.md, project_structure.md, UI_UX_doc.md, Bug_tracking.md

Also supports analyze (retrofit existing codebases), enhance (plan new features), migrate (plan stack migrations), validate (run quality gates), run-prp (execute a PRP end-to-end), orchestrate (deploy autonomous agent teams via tmux), and dashboard commands.

## Key commands

- context-forge init — run the 10-screen TUI wizard to scaffold the full surface
- context-forge init --no-tui — use the legacy inquirer flow for CI or non-TTY environments
- context-forge init --ai-prp — add AI-generated Product Requirement Prompts to the output
- context-forge analyze — detect an existing project's tech stack and retrofit CLAUDE.md and PRPs
- context-forge enhance — plan and scaffold a new feature with PRPs and progress-tracking commands
- context-forge migrate — plan a tech-stack migration with phased execution and rollback procedures
- context-forge validate — run the quality gate (lint, tests, coverage, build, security)
- context-forge run-prp <name> — execute a PRP end-to-end against the codebase
- /prp-create <feature> — generate a PRP for a new feature (slash command)
- /prp-execute <name> — execute an existing PRP (slash command)
- /validate — run the full validation gate from inside Claude Code
- /checkpoint-create <name> — create a named working-state checkpoint

## Install

    npm install -g context-forge
    context-forge init

Or run without installing:

    npx context-forge init

For AI-powered PRPs, set up the API key first:

    context-forge ai-keys --provider anthropic

## When to use

Use when starting a new project and you want the entire modern .claude/ surface — hooks, agents, skills, commands, PRPs — wired correctly in one command rather than assembled by hand.