Claude 최신 AI 개발 컨텍스트 엔진 — 단 하나의 CLI로 현대적인 Claude Code의 모든 환경을 생성합니다

단 하나의 CLI. settings.json, 에이전트(agents), 스킬(skills), 슬래시 명령어(slash commands), 훅(hooks), PRP 등 현대적인 .claude/ 환경 전체를 처음부터 올바르게 연결합니다.

2026년 Claude 라인업 추적: Opus 4.7 · Sonnet 4.6 · Haiku 4.5

멀티 IDE 지원: Claude · Cursor · Windsurf · Cline · Roo · Gemini · Copilot

새로운 기능 · 빠른 시작 · 생성되는 항목 · 명령어 · 로드맵

9개월 만의 첫 번째 대규모 업데이트입니다. Context-forge는 이제 현대적인 (2026년 5월 기준) Claude Code 프로젝트가 기대하는 모든 것을 생성하며, init 마법사는 전체 화면 Ink TUI(Text User Interface)로 제공됩니다.

키 검증(Key validation)에는 Haiku 4.5를 사용하며, 기본 계획(planning)에는 Opus 4.7이, 균형 잡힌 기본 설정에는 Sonnet 4.6이 사용됩니다. SDK 버전은 ^0.94.0입니다.

변경 사항에 대한 전체 기록은 CHANGELOG.md를 참조하세요.

불필요한 작업(yak-shaving) 감소. 설정, 에이전트(agents), 기술(skills), 훅(hooks), 슬래시 명령어(slash commands)를 포함한 전체 .claude/ 표면(surface)을 단 한 번의 명령으로 구성합니다. 프런트매터(frontmatter)를 복사하여 붙여넣거나 적절한 스키마 URL을 찾아 헤맬 필요가 없습니다.

더 나은 Claude 컨텍스트(context). 기술 스택을 인식하는 CLAUDE.md, 스테이징된 Docs/Implementation.md, 그리고 기능별 PRP(선택적으로 AI 강화 가능)를 생성하여, Claude Code가 첫 번째 턴부터 사용자의 코드베이스를 파악할 수 있게 합니다.

즉시 사용 가능한 현대적인 Claude Code 표면(surface). 2026년 5월 컨벤션(settings.json 훅, 에이전트, 기술, 파일로서의 슬래시 명령어)을 추적합니다. 한 번의 업그레이드로 어디에서나 배포할 수 있습니다.

멀티 IDE 지원. 동일한 프로젝트 컨텍스트를 7개의 IDE에서 사용합니다: Claude · Cursor · Windsurf · Cline · Roo · Gemini · Copilot.

무료 및 오프라인 사용 가능. AI 기반의 PRP 생성은 선택 사항이며, 결정론적(deterministic) 템플릿 경로는 완전히 오프라인에서도 작동합니다.

어댑터 중심의 깔끔한 구조. 각 IDE는 고유의 어댑터를 가지며, 모든 생성기는 동일한 GeneratedFile[] 형태를 반환합니다. 확장이 용이합니다.

현대적인 .claude/settings.json + 에이전트 + 기술 표면은 현재 Claude 전용입니다. 다른 모든 IDE는 CLAUDE.md에 상응하는 파일, PRPs/, 그리고 각 IDE의 네이티브 설정 파일을 포함하는 범용 아티팩트(artifacts)를 전달받습니다. IDE별 상세 분석은 docs/ide-configs/를 참조하세요.

npm install -g context-forge
context-forge init

Ink TUI 화면이 나타납니다:

┌─ context-forge · init ───────────────────────────────────────────────┐
│ │
│ Welcome to context-forge │
...

CI / non-TTY / 스크립트용의 경우, TUI (Terminal User Interface)를 사용하지 않도록 설정할 수 있습니다:

context-forge init --no-tui # inquirer 폴백 (fallback)
context-forge init --config ./context-forge.json # 완전한 스크립트 방식

• Node.js 18+ 및 npm 7+
• 코드 에디터 (현대적인 Claude Code 환경을 위해 VS Code 권장)

프로젝트 의존성(dependency)이 아닌 전역(globally)으로 설치하세요 — context-forge는 라이브러리가 아닌 CLI (Command Line Interface)입니다.

Claude를 대상으로 하는 일반적인 init 결과물은 다음과 같습니다:

my-project/
├── CLAUDE.md # 기술 스택을 인식하는 프로젝트 규칙
├── Docs/
...

TUI의 Options 화면을 통해 생성기(generators)를 개별적으로 토글하거나, config.extras.{claudeSettings, agents, skills, hooks, claudeCommands, prp, validation, aiDocs, docker, cicd}를 사용하여 설정할 수 있습니다.

기술 스택을 인식하는 프로젝트 규칙 — KISS/YAGNI 지침, 코드 구조 제한, 테스트 요구 사항, 프리 커밋 (pre-commit) 체크리스트, 그리고 templates/claude/tech-stacks/에서 가져온 기술 스택별 섹션이 포함됩니다. 항상 생성됩니다.

단계별 개발 계획 (Implementation.md), 폴더 구성 (project_structure.md), UX 명세 (UI_UX_doc.md), 그리고 버그 로그 템플릿 (Bug_tracking.md)이 포함됩니다. 명시적으로 비활성화하지 않는 한 생성됩니다.

제품 요구 사항 프롬프트 (Product Requirement Prompts) — 검증 게이트(validation gates)가 포함된 Andre Karpathy 스타일의 구현 청사진입니다. 하나의 기본 PRP와 필수 기능당 하나의 PRP가 생성됩니다. 선택적으로 AI 기능이 강화될 수 있습니다 (AI 기반 PRPs 참조). extras.prp: false를 통해 제외할 수 있습니다.

src/generators/claudeSettings.ts에 의해 생성됩니다. 현대적인 전체 환경을 연결하는 하나의 정전 파일(canonical file)입니다:

{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"model": "claude-opus-4-7",
...

extras.claudeSettings: false를 통해 제외할 수 있습니다. ProjectConfig의 preferredModel, mcpServers, statusLine, outputStyles, permissionsAllow, permissionsDeny 필드를 사용하여 개별 필드를 재정의(override)할 수 있습니다.

src/generators/agents.ts에 의해 생성됩니다. 프론트매터(frontmatter)가 포함된 서브 에이전트(sub-agent)당 하나의 .md 파일이 생성됩니다:

---
name: code-reviewer
description: 스타일, 보안 및 컨벤션 준수 여부를 위해 최근 편집 사항을 검토합니다.
...

5개의 기본 에이전트(agents)가 제공됩니다. ProjectConfig의 customAgents를 통해 자신만의 에이전트를 추가할 수 있습니다.

. extras.agents: false를 통해 사용을 중단할 수 있습니다.

. src/generators/skills.ts에 의해 생성됩니다.

. 스킬당 하나의 <name>/SKILL.md 파일이 생성되며, 여기에는 프론트매터(frontmatter) (name, description, when_to_use)와 Handlebars로 렌더링된 본문이 포함됩니다. 사용자의 기술 스택으로부터 {{testCommand}}, {{testFramework}} (Jest / Vitest / Pytest / JUnit / RSpec), {{primaryLanguage}}, {{deployTarget}}를 자동으로 도출합니다.

3개의 기본 스킬(skills)이 제공됩니다. ProjectConfig의 customSkills를 통해 자신만의 스킬을 추가할 수 있습니다.

. extras.skills: false를 통해 사용을 중단할 수 있습니다.

. src/generators/slashCommands.ts에 의해 생성됩니다. 전체 프론트매터가 포함된 실제 .md 파일 형태의 21개 명령어가 생성됩니다:

---
allowed-tools: [Bash, Read, Grep]
argument-hint: "<feature-name>"
...

명령어 목록을 CLAUDE.md에 직접 포함하는 프로젝트를 위해 기존의 renderCommandsForClaudeMd(config) export가 유지됩니다.

. src/generators/hooks.ts, enhancementHooks.ts, migrationHooks.ts에 의해 생성됩니다. 스크립트는 .claude/hooks/에 위치하며, 등록은 settings.json의 hooks 블록을 통해 이루어집니다 (기존의 .claude/hooks.yaml 관례를 사용하지 않음). 모든 스크립트는 자동으로 chmod 0o755 권한이 부여됩니다.

14개의 bash 스크립트와 4개의 Python 스크립트가 있습니다. Python은 stdin-JSON 또는 마크다운 스캐닝이 진정으로 필요한 경우에만 유지됩니다: prp-tracking.py, dart-progress-updater.py, auto-task-commenter.py, task-code-mapper.py.

삭제됨: ContextRotation.py — pre-compact.sh의 스냅샷 전략으로 통합되었습니다.

선택 사항. --ai-prp (또는 TUI를 통해) 활성화 시, context-forge는 Anthropic 또는 OpenAI를 호출하여 일반적인 템플릿 플레이스홀더 대신 구현 전략, 주의 사항(gotchas), 모범 사례(best practices), 검증 접근 방식 및 선별된 문서 링크를 포함하는 기능별 PRP를 생성합니다.

context-forge ai-keys --provider anthropic # 1회성 설정, ~/.context-forge-keys에 AES-256-CBC로 암호화됨
context-forge init --ai-prp # 그 다음 정상적으로 초기화

30초 타임아웃 발생 시 결정론적 템플릿 (deterministic templates)으로 폴백(fallback)합니다. 현재 AI 호출은 @anthropic-ai/claude-code의 query() 래퍼 (wrapper)를 통해 이루어집니다. v4.1.0의 W11 작업에서는 프롬프트 캐싱 (prompt caching) 및 확장된 사고 (extended thinking) 기능을 활성화하기 위해 AI 경로를 직접적인 @anthropic-ai/sdk의 messages.create 호출로 전환할 예정입니다.

6개의 하위 디렉토리에 걸쳐 21개의 명령어가 있으며, 각 명령어는 프론트매터 (frontmatter)를 포함하여 .claude/commands/<subdir>/<name>.md 형식으로 생성됩니다.

전체 본문은 생성된 .claude/commands/ 디렉토리에 존재합니다 — 파일을 열고, 편집하고, 커밋하세요.

다섯 가지 기본 서브 에이전트 (sub-agents)가 .claude/agents/에 배치됩니다:

각 에이전트는 YAML 프론트매터 (frontmatter) (name, description, tools, model)와 시스템 프롬프트 (system-prompt) 본문로 구성된 하나의 .md 파일입니다. ProjectConfig의 customAgents를 통해 커스텀할 수 있습니다.

세 가지 기본 스킬 (skills)이 .claude/skills/<name>/SKILL.md에 배치됩니다:

ProjectConfig의 customSkills를 통해 커스텀할 수 있습니다.

8개의 모든 Claude Code 라이프사이클 이벤트 (lifecycle events)는 settings.json을 통해 연결됩니다.

스크립트 (Scripts)는 .claude/hooks/에 위치합니다.