{"id":29806260,"url":"https://github.com/webdevtodayjason/context-forge","last_synced_at":"2025-09-21T05:05:34.094Z","repository":{"id":303831739,"uuid":"1016919067","full_name":"webdevtodayjason/context-forge","owner":"webdevtodayjason","description":"CLI tool that scaffolds context engineering documentation for Claude Code projects. Transforms requirements into staged implementation plans, project structures, and workflow rules. From idea to AI-ready project in minutes.","archived":false,"fork":false,"pushed_at":"2025-08-20T14:40:56.000Z","size":4067,"stargazers_count":110,"open_issues_count":0,"forks_count":14,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-21T05:03:51.922Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdevtodayjason.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-09T18:21:59.000Z","updated_at":"2025-09-20T13:58:19.000Z","dependencies_parsed_at":"2025-07-09T21:18:51.286Z","dependency_job_id":"1e3fab0a-75bb-4397-acb8-b53cdcdd5858","html_url":"https://github.com/webdevtodayjason/context-forge","commit_stats":null,"previous_names":["webdevtodayjason/context-forge"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/webdevtodayjason/context-forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fcontext-forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fcontext-forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fcontext-forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fcontext-forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdevtodayjason","download_url":"https://codeload.github.com/webdevtodayjason/context-forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fcontext-forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276195600,"owners_count":25601145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-21T02:00:07.055Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-28T14:05:55.246Z","updated_at":"2025-09-21T05:05:34.087Z","avatar_url":"https://github.com/webdevtodayjason.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\n# 🛠️ Context Forge\n\n**CLI tool for instant Claude Code project scaffolding with context engineering best practices**\n\n[![npm version](https://img.shields.io/npm/v/context-forge.svg)](https://www.npmjs.com/package/context-forge)\n[![npm downloads](https://img.shields.io/npm/dm/context-forge.svg)](https://www.npmjs.com/package/context-forge)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)\n[![GitHub release](https://img.shields.io/github/release/webdevtodayjason/context-forge.svg)](https://github.com/webdevtodayjason/context-forge/releases)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/webdevtodayjason/context-forge/pulls)\n[![Made with ❤️](https://img.shields.io/badge/Made%20with-❤️-red.svg)](https://github.com/webdevtodayjason/context-forge)\n\n![Context Forge Banner](./img/context-forge-banner.png)\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTransform your project ideas into AI-ready applications with intelligent context engineering\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e🎯 Optimized for Claude Code with deep integration for slash commands, hooks, and PRPs\u003c/em\u003e\u003cbr\u003e\n  \u003cem\u003eAlso supports Cursor, Windsurf, Cline, Copilot, Gemini, and more AI coding assistants\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch2\u003e🎉 What's New in v3.2.9\u003c/h2\u003e\n  \n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003ch3\u003e🦄 Nuxt 4 Support\u003c/h3\u003e\n        \u003cp\u003e\u003cstrong\u003eNEW: Full Nuxt 4 Integration\u003c/strong\u003e\u003c/p\u003e\n        \u003cp\u003eComplete support for Nuxt 4 with Vue 3 and modern development!\u003c/p\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003e🏗️ New app/ directory structure support\u003c/li\u003e\n          \u003cli\u003e⚡ Enhanced TypeScript integration\u003c/li\u003e\n          \u003cli\u003e🎯 Vue 3 Composition API guidelines\u003c/li\u003e\n          \u003cli\u003e🔄 Auto-imports and server-side rendering\u003c/li\u003e\n          \u003cli\u003e📊 Nuxt-specific validation commands\u003c/li\u003e\n        \u003c/ul\u003e\n        \u003ccode\u003econtext-forge init\u003c/code\u003e\u003cbr/\u003e\n        \u003cem\u003eSelect \"Nuxt 4\" as frontend framework\u003c/em\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003ch3\u003e🤖 AI-Powered PRP Generation\u003c/h3\u003e\n        \u003cp\u003e\u003cstrong\u003eContinued: \u003ccode\u003econtext-forge init --ai-prp\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n        \u003cp\u003eIntelligent, feature-specific PRPs with AI enhancement!\u003c/p\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003e🧠 OpenAI \u0026 Anthropic Claude integration\u003c/li\u003e\n          \u003cli\u003e🔐 Secure API key management with encryption\u003c/li\u003e\n          \u003cli\u003e🎯 Feature-specific implementation strategies\u003c/li\u003e\n          \u003cli\u003e⚡ Real-time progress feedback\u003c/li\u003e\n          \u003cli\u003e🛡️ Timeout handling \u0026 fallback systems\u003c/li\u003e\n        \u003c/ul\u003e\n        \u003ccode\u003econtext-forge ai-keys --provider openai\u003c/code\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n  \n  \u003ch3\u003e🚀 Enhanced Claude Code Integration\u003c/h3\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003ch4\u003e⚡ 25+ Slash Commands\u003c/h4\u003e\n        \u003cp\u003eComprehensive command library:\u003c/p\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003e\u003cstrong\u003ePRPs:\u003c/strong\u003e create, execute, validate, parallel\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eDev:\u003c/strong\u003e prime-context (NEW: architect mode), debug-issue, review-code\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eGit:\u003c/strong\u003e smart-commit, create-pr\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eOrchestration:\u003c/strong\u003e orchestrate-status, team-health\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eEnhancement:\u003c/strong\u003e track-features, update-progress\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003ch4\u003e🪝 7 Claude Code Hooks\u003c/h4\u003e\n        \u003cp\u003e\u003ccode\u003econtext-forge copy-hooks\u003c/code\u003e\u003c/p\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003e\u003cstrong\u003ePreCompact:\u003c/strong\u003e Preserve context\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eContextRotation:\u003c/strong\u003e Smart file switching\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003ePreSubmit:\u003c/strong\u003e Quality gates\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003ePRPTracking:\u003c/strong\u003e Progress monitoring\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eDartProgressUpdater:\u003c/strong\u003e Auto task progress\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eAutoTaskCommenter:\u003c/strong\u003e Smart task docs\u003c/li\u003e\n          \u003cli\u003e\u003cstrong\u003eTaskCodeMapper:\u003c/strong\u003e File-task mapping\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n  \n  \u003ch3\u003e📁 Complete Project Structure\u003c/h3\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"33%\"\u003e\n        \u003ch4\u003e📄 Core Files\u003c/h4\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003eCLAUDE.md\u003c/li\u003e\n          \u003cli\u003eDocs/\u003c/li\u003e\n          \u003cli\u003ePRPs/\u003c/li\u003e\n          \u003cli\u003eai_docs/\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"33%\"\u003e\n        \u003ch4\u003e⚡ .claude/commands/\u003c/h4\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003ePRPs/\u003c/li\u003e\n          \u003cli\u003edevelopment/\u003c/li\u003e\n          \u003cli\u003echeckpoints/\u003c/li\u003e\n          \u003cli\u003emigration/\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"33%\"\u003e\n        \u003ch4\u003e🪝 .claude/hooks/\u003c/h4\u003e\n        \u003cul align=\"left\"\u003e\n          \u003cli\u003ePreCompact.py\u003c/li\u003e\n          \u003cli\u003eContextRotation.py\u003c/li\u003e\n          \u003cli\u003ePreSubmit.py\u003c/li\u003e\n          \u003cli\u003eDartProgressUpdater.py\u003c/li\u003e\n          \u003cli\u003eAutoTaskCommenter.py\u003c/li\u003e\n          \u003cli\u003eTaskCodeMapper.py\u003c/li\u003e\n          \u003cli\u003eMigrationHooks/\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n  \n  \u003ch3\u003e🎯 PRP Support for 6 AI IDEs!\u003c/h3\u003e\n  \u003cp\u003e\u003cstrong\u003eProduct Requirement Prompts (PRP) now available for Claude, Cursor, Windsurf, Cline, Copilot \u0026 Gemini!\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Claude%20Code-red?style=for-the-badge\" alt=\"Claude Code\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Cursor%20IDE-blue?style=for-the-badge\" alt=\"Cursor IDE\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Windsurf-cyan?style=for-the-badge\" alt=\"Windsurf\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Cline-green?style=for-the-badge\" alt=\"Cline\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Copilot-black?style=for-the-badge\" alt=\"GitHub Copilot\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PRP-Gemini-orange?style=for-the-badge\" alt=\"Gemini\" /\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\u003cem\u003eStructured feature implementation with validation gates across all major AI coding assistants!\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n[Features](#-features) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Credits](#-credits)\n\n\u003c/div\u003e\n\n---\n\n## 🌟 Overview\n\nContext Forge is a powerful CLI tool that bridges the gap between project requirements and AI-assisted development. By implementing Andre Karpathy's context engineering principles, it generates comprehensive documentation structures that enable AI IDEs to understand and build your project efficiently—without hallucinations or context confusion.\n\n### 🚀 Why Choose Context Forge?\n\n**🌐 Universal AI IDE Support** - Works with ALL major AI coding assistants  \n**⚡ Zero Configuration** - Intelligent defaults for each IDE  \n**🎯 One Command** - Generate configs for multiple IDEs simultaneously  \n**🔄 Format Conversion** - Switch between IDEs without starting over  \n**🔗 Claude Hooks Integration** - Seamless context preservation during compaction\n**📦 No Lock-in** - Your project, your choice of AI assistant\n\n### 🤖 Supported AI IDEs \u0026 Assistants\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Claude%20Code-Anthropic-black?style=flat-square\u0026logo=anthropic\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/claude/\"\u003eClaude Code\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003eFull PRP support\u003c/em\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Cursor-IDE-blue?style=flat-square\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/cursor/\"\u003eCursor IDE\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003ePRP + MDC format\u003c/em\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Windsurf-IDE-cyan?style=flat-square\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/windsurf/\"\u003eWindsurf\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003ePRP + Cascade AI\u003c/em\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Cline-Extension-green?style=flat-square\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/cline/\"\u003eCline\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003ePRP + Context mgmt\u003c/em\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Roo%20Code-Extension-purple?style=flat-square\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/roo/\"\u003eRoo Code\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003eHierarchical rules\u003c/em\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/Gemini-Google-orange?style=flat-square\u0026logo=google\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/gemini/\"\u003eGemini\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003ePRP + CLI \u0026 Code Assist\u003c/em\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cimg src=\"https://img.shields.io/badge/GitHub%20Copilot-black?style=flat-square\u0026logo=github\" /\u003e\u003cbr\u003e\u003cb\u003e\u003ca href=\"./docs/ide-configs/copilot/\"\u003eGitHub Copilot\u003c/a\u003e\u003c/b\u003e\u003cbr\u003e\u003cem\u003eCustom instructions\u003c/em\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003e **Coming Soon:** Amazon CodeWhisperer, Tabnine, and more!\n\n### 📚 IDE Configuration Guides\n\nNeed help understanding how each IDE uses its configuration? Check out our detailed guides:\n\n- **[🤖 Claude Code Guide](./docs/ide-configs/claude/)** - Full PRP support, validation system, tech-stack templates\n- **[🔵 Cursor IDE Guide](./docs/ide-configs/cursor/)** - PRP support, MDC format, hierarchical rules\n- **[🟩 Windsurf Guide](./docs/ide-configs/windsurf/)** - PRP support, Cascade AI integration, workflows\n- **[🟢 Cline Guide](./docs/ide-configs/cline/)** - PRP support, context management, code patterns, advanced commands\n- **[🟣 Roo Code Guide](./docs/ide-configs/roo/)** - Workspace rules, YAML configuration, team settings\n- **[🟠 Gemini Guide](./docs/ide-configs/gemini/)** - PRP support, hierarchical context, CLI commands, Code Assist integration\n- **[⚫ GitHub Copilot Guide](./docs/ide-configs/copilot/)** - Custom instructions, VS Code settings, language-specific rules\n\n### 📖 Claude Code Advanced Features Documentation\n\n**[📚 Complete Claude Features Guide](./docs/claude-features/README.md)** - Master the new advanced features:\n\n- **[⚡ Slash Commands Reference](./docs/claude-features/slash-commands.md)** - 20+ pre-built commands for rapid development\n- **[🤖 PRP Runner Guide](./docs/claude-features/prp-runner.md)** - Automated PRP execution with validation gates\n- **[📝 Enhanced PRP Templates](./docs/claude-features/enhanced-prp-templates.md)** - Four specialized templates for different scenarios\n- **[🎯 Orchestration Workflow](./docs/claude-features/orchestration-workflow.md)** - How all components work together\n\n## 🤖 AI-Powered PRP Generation (NEW in v3.2.8)\n\nTransform your project development with intelligent, feature-specific **Product Requirement Prompts (PRPs)** powered by OpenAI and Anthropic Claude.\n\n### 🧠 What are AI-Powered PRPs?\n\nUnlike template-based PRPs, AI-powered PRPs are dynamically generated for each specific feature in your project, containing:\n\n- **Feature-specific implementation strategies** tailored to your tech stack\n- **Intelligent gotchas and best practices** based on your architecture\n- **Custom validation approaches** optimized for the feature type\n- **Relevant documentation links** curated by AI\n- **Complexity assessments** and dependency analysis\n\n### 🚀 Quick Setup\n\n```bash\n# 1. Set up your AI provider (one-time setup)\ncontext-forge ai-keys --provider openai\n# OR\ncontext-forge ai-keys --provider anthropic\n\n# 2. Initialize project with AI-powered PRPs\ncontext-forge init --ai-prp\n\n# Your API keys are securely encrypted and stored in ~/.context-forge-keys\n```\n\n### 🔐 Secure Key Management\n\n- **AES-256-CBC encryption** for API key storage\n- **User-specific salt generation** for enhanced security\n- **Cross-project key sharing** - set up once, use everywhere\n- **Multi-provider support** - OpenAI, Anthropic Claude, and more coming soon\n\n### ⚡ Real-time Generation Process\n\nWatch as Context Forge generates intelligent PRPs for each feature:\n\n```\n🤖 Generating AI PRP for: User Authentication \u0026 Authorization...\n✅ AI content generated for: User Authentication \u0026 Authorization\n📝 Generated: PRPs/feature-auth-prp.md\n\n🤖 Generating AI PRP for: Google Drive Cloud Streaming...\n✅ AI content generated for: Google Drive Cloud Streaming\n📝 Generated: PRPs/feature-google-drive-cloud-streaming-prp.md\n```\n\n### 🎯 Example: Feature-Specific Content\n\n**Traditional Template PRP:**\n```markdown\n# TODO: Add implementation details\n# TODO: Add data models based on requirements\n```\n\n**AI-Powered PRP for Google Drive Integration:**\n```markdown\n### AI-Generated Implementation Strategy\nLeverage Google Drive API for file organization, streaming, and redundancy. \nUse Google's Picker API for intelligent folder structure management. \nImplement JWT for access control.\n\n### ⚠️ AI-Identified Gotchas\n- Make sure to have proper error handling for API failures\n- Ensure you're not exceeding Google Drive API's rate limits\n- Be careful with user's OAuth tokens\n\n### ✅ AI-Recommended Best Practices\n- Encrypt OAuth tokens\n- Use Google's recommended best practices for Drive API\n- Always validate files before streaming\n```\n\n### 🛡️ Fallback \u0026 Reliability\n\n- **30-second timeout** with automatic fallback to template content\n- **Progress feedback** so you always know what's happening\n- **Graceful error handling** ensures project generation never fails\n- **Offline mode** - AI enhancement is always optional\n\n## ✨ Features\n\n### Core Features\n\n- 🚀 **No AI Dependencies** - Works completely offline without API keys\n- 🤖 **Multi-IDE Support** - Generate configs for multiple AI IDEs at once\n- 📋 **Interactive CLI** - Guided project setup with IDE selection\n- 🎯 **Template-based Generation** - IDE-specific documentation formats\n- 🛠️ **Multiple Tech Stacks** - Support for 9+ frameworks with specific configurations\n- 📁 **Structured Output** - Organized documentation following each IDE's conventions\n- ⚡ **Fast Setup** - Go from zero to AI-ready project in minutes\n- 🔄 **Technology Migration** - Safe migration planning between tech stacks\n- 🔧 **Retrofit Existing Projects** - Analyze and upgrade existing codebases with AI documentation\n- 🏗️ **Smart Project Detection** - Automatically detects new vs existing projects\n- 📊 **Transparent File Operations** - Shows actual file paths and comprehensive logging\n\n### Advanced Features\n\n- 🤖 **AI-Powered PRP Generation** - Intelligent, feature-specific PRPs with OpenAI \u0026 Anthropic (NEW in v3.2.8!)\n- 🔍 **PRP Integration** - Product Requirement Prompts with validation loops (Claude, Cursor, Windsurf, Cline, Copilot \u0026 Gemini)\n- 🔐 **Secure API Key Management** - AES-256-CBC encrypted storage for AI provider keys\n- ✅ **Validation System** - Built-in code quality checks and gates\n- 🛑 **Human-in-the-Loop Checkpoints** - Pause for verification at critical milestones\n- 🪝 **Claude Code Hooks** - PreCompact, ContextRotation, PreSubmit, and PRPTracking hooks\n- ⚡ **20+ Slash Commands** - Comprehensive command library for rapid development\n- 🎨 **Tech-Stack Specific Templates** - Optimized CLAUDE.md for each framework\n- 📊 **Comprehensive Reporting** - Validation reports and progress tracking\n- 🔄 **Phased Migration Plans** - Step-by-step migration with rollback strategies\n- 🔧 **Extensible Architecture** - Easy to add new tech stacks and features\n\n## 🔗 Claude Hooks Manager Integration\n\nContext Forge provides deep integration with [Claude Hooks Manager](https://github.com/webdevtodayjason/claude-hooks) through 4 powerful hooks that enhance your development workflow and maintain context throughout long sessions.\n\n### The 4 Claude Code Hooks\n\n#### 1. **PreCompact Hook** - Context Preservation\nWith Claude Code v1.0.48+, the PreCompact hook ensures your PRPs and project context survive conversation compaction:\n- 🧠 Critical project structure persists\n- 🎯 Current implementation stage maintained\n- 📋 Validation gates remain active\n\n#### 2. **ContextRotation Hook** - Smart File Management\nIntelligently manages which files stay in context as you work:\n- 📁 Prioritizes relevant files based on current task\n- 🔄 Automatically rotates less relevant files out\n- 💾 Preserves critical configuration files\n\n#### 3. **PreSubmit Hook** - Quality Gates\nRuns validation before code submission:\n- ✅ Syntax and type checking\n- 🧪 Test execution\n- 📊 Coverage requirements\n- 🔒 Security scanning\n\n#### 4. **PRPTracking Hook** - Progress Monitoring\nTracks PRP implementation progress:\n- 📈 Monitors task completion\n- ⏱️ Time tracking per feature\n- 📋 Automatic status updates\n- 🎯 Milestone achievements\n\n### 🎯 NEW: Dart Integration Hooks (v3.2.1)\n\nWhen **Dart task management** is enabled, Context Forge generates additional hooks for comprehensive task tracking:\n\n#### 5. **DartProgressUpdater Hook** - Automatic Task Progress\nAutomatically updates Dart task progress based on code changes:\n- 📁 Detects tasks from file path patterns\n- 🔄 Updates task status on file modifications\n- 📝 Tracks git commit messages for task completion\n- 📊 Maintains progress history and suggestions\n\n#### 6. **AutoTaskCommenter Hook** - Detailed Task Documentation\nAdds intelligent comments to Dart tasks with code analysis:\n- 🔧 Analyzes code structure and complexity\n- 📈 Tracks functions added/modified and line changes\n- 🎯 Categorizes changes by project area (auth, API, UI, etc.)\n- 📋 Creates milestone comments for builds/tests/commits\n\n#### 7. **TaskCodeMapper Hook** - Intelligent File-Task Mapping\nMaintains smart mapping between Dart tasks and code files:\n- 🧠 Infers task categories from file paths and content\n- 📊 Confidence-based task assignment suggestions\n- 🎯 Project-specific pattern recognition\n- 📈 Learning from successful mappings\n\n**Enable Dart Integration:**\n```bash\ncontext-forge init\n# Select \"Enable Dart task integration? Yes\"\n```\n\n**Generated Dart Integration Files:**\n- `.claude/dart_progress.json` - Task progress tracking\n- `.claude/task_mapping.json` - File-to-task relationships\n- `.claude/task_comments.json` - Automated task comments\n- `.claude/task_suggestions.json` - AI-generated task suggestions\n\n### Setup\n\n```bash\n# Generate project with hooks\ncontext-forge init  # Select \"Enable Claude Code hooks? Yes\"\n\n# Or copy hooks from another project\ncontext-forge copy-hooks --source ../claude-hooks-repo/hooks\n\n# Hooks are created in:\n# .claude/hooks/\n```\n\nThis integration is especially powerful for:\n- Long-running development sessions\n- Complex multi-phase implementations\n- Team projects requiring consistency\n- Migration projects with checkpoints\n\n## 🛑 Human-in-the-Loop Checkpoints\n\nContext Forge introduces a powerful checkpoint system that pauses AI development at critical milestones for human verification, ensuring you maintain control over the implementation process.\n\n### Why Checkpoints?\n\n- **Prevent Breaking Changes**: Verify database migrations before data modification\n- **Quality Assurance**: Review architectural decisions before proceeding\n- **Safety First**: Human approval for production deployments\n- **Learning Opportunity**: Understand what the AI has implemented\n\n### How Checkpoints Work\n\n1. **Automatic Triggers**: AI pauses at predefined critical points\n2. **Manual Checkpoints**: Use `/checkpoint` command anytime\n3. **Verification Request**: AI presents what was done and what needs testing\n4. **Human Decision**: Approve to continue or request fixes\n\n### Checkpoint Commands\n\n- `/checkpoint [description]` - Create manual checkpoint\n- `/should-checkpoint` - AI asks if checkpoint is needed\n- `/milestone-gate [milestone]` - Major milestone verification\n\n### Example Checkpoint Flow\n\n```\n🛑 CHECKPOINT: Human Verification Required\n\nAnalytics Dashboard - I've completed database schema setup:\n\n✅ What I've Accomplished:\n- Created PostgreSQL schema with 5 tables\n- Set up foreign key relationships\n- Added indexes for query optimization\n\n🧪 Please Test:\n1. Run: npm run db:migrate\n2. Check tables exist: psql -c \"\\dt\"\n3. Verify foreign keys: psql -c \"\\d+ users\"\n\n📋 Critical Verification Points:\n- [ ] All tables created successfully\n- [ ] Foreign keys properly linked\n- [ ] No data loss from existing tables\n\nPlease respond:\n- ✅ \"Approved\" - Continue to next task\n- ❌ \"Issues: [description]\" - Fix before proceeding\n```\n\n### Configuring Checkpoints\n\nCheckpoints are configured during project initialization or can be added to existing projects:\n\n```yaml\n# .context-forge/checkpoints.yaml\ncheckpoints:\n  - name: \"Database Migration\"\n    phase: \"infrastructure\"\n    requires_approval: true\n    validation_steps:\n      - \"Run migration scripts\"\n      - \"Verify data integrity\"\n      - \"Check rollback procedures\"\n```\n\n## 📦 Installation\n\n```bash\nnpm install -g context-forge\n```\n\n[![npm](https://nodei.co/npm/context-forge.png)](https://npmjs.org/package/context-forge)\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 18+ and npm 7+\n- Git (for version control)\n- A code editor (VS Code recommended)\n\n### Basic Usage\n\n```bash\n# Initialize a new project\ncontext-forge init\n\n# Initialize with AI-powered PRPs (optional)\ncontext-forge init --ai-prp\n\n# Set up AI provider keys (optional)\ncontext-forge ai-keys\n\n# Or use npx without installation\nnpx context-forge init\n```\n\n**Note**: Context Forge is a CLI tool and should be installed globally. Do not install it as a project dependency with `npm install context-forge` as this will add unnecessary files to your project.\n\n```bash\n# Initialize in current directory\ncontext-forge init\n\n# Specify output directory\ncontext-forge init --output ./my-project\n\n# Use with existing PRD file\ncontext-forge init --prd ./requirements.md\n\n# Skip interactive prompts with config\ncontext-forge init --config ./context-forge.json\n\n# Run validation on existing project\ncontext-forge validate\n\n# Retrofit existing projects with AI-optimized documentation\ncontext-forge analyze\n\n# Execute PRPs with Claude Code for one-pass implementation\ncontext-forge run-prp feature-name\n\n# NEW: Plan technology migration\ncontext-forge migrate --target \"Next.js\"\n\n# NEW: Copy Claude Code hooks from another project\ncontext-forge copy-hooks --source ../claude-hooks-repo/hooks\n\n# NEW: Set up AI provider keys for enhanced PRP generation\ncontext-forge ai-keys --provider openai\ncontext-forge ai-keys --provider anthropic\n```\n\n## 💡 Usage Examples\n\n### Example 1: SaaS Dashboard Project\n\n```bash\n$ context-forge init\n\n? Project name: Analytics Dashboard\n? Project type: fullstack\n? Project description: Real-time analytics dashboard with data visualization\n? How would you like to provide the PRD? Create new PRD\n? Frontend framework: nextjs\n? Backend framework: fastapi\n? Database: postgresql\n? Select features: authentication, dashboard, realtime-updates, data-export\n? Project timeline: standard\n? Team size: small\n? Enable PRP generation? Yes\n? Enable AI-powered PRP generation? Yes\n? Enable validation system? Yes\n? Enable Human-in-the-Loop checkpoints? Yes\n? Enable Claude Code hooks? Yes\n\n✅ Project initialized successfully!\n\nGenerated files:\n- CLAUDE.md (Next.js 15 specific configuration)\n- Docs/Implementation.md (4 development stages)\n- Docs/project_structure.md\n- PRPs/base.md (Implementation prompt with validation gates)\n- .claude/commands/ (20+ slash commands)\n- .claude/hooks/ (4 Claude Code hooks)\n- .context-forge/config.json\n\nNext steps:\n1. cd analytics-dashboard\n2. Set up AI keys (optional): context-forge ai-keys\n3. Review CLAUDE.md for project rules\n4. Use /prime-context to load project knowledge and activate architect mode\n5. Start with Stage 1 in Docs/Implementation.md\n```\n\n### Example 2: API-Only Microservice\n\n```bash\n$ context-forge init --output user-service\n\n? Project name: User Service\n? Project type: api\n? Project description: User management microservice with JWT auth\n? Frontend framework: none\n? Backend framework: express\n? Database: mongodb\n? Authentication method: jwt\n? Enable Docker support? Yes\n? Enable GitHub Actions? Yes\n\nGenerated structure:\nuser-service/\n├── CLAUDE.md              # Express.js specific rules\n├── Docs/\n├── PRPs/\n├── Dockerfile\n├── docker-compose.yml\n└── .github/workflows/\n```\n\n### Example 3: Nuxt 4 Vue Application\n\n```bash\n$ context-forge init --output nuxt-dashboard\n\n? Project name: Analytics Dashboard  \n? Project type: fullstack\n? Project description: Modern analytics dashboard with real-time data\n? Frontend framework: nuxt4  # NEW: Nuxt 4 option\n? Styling framework: tailwind\n? State management: pinia\n? Backend framework: fastapi\n? Database: postgresql\n? Authentication method: jwt\n? Enable AI-powered PRP generation? Yes\n\nGenerated structure:\nnuxt-dashboard/\n├── CLAUDE.md              # Nuxt 4 + Vue 3 specific rules\n├── Docs/\n├── PRPs/\n│   ├── nuxt-dashboard-prp.md\n│   └── feature-auth-prp.md  # AI-enhanced for Nuxt 4\n└── .claude/commands/       # 25+ slash commands\n\n✨ Nuxt 4 Features Included:\n- New app/ directory structure documented\n- Vue 3 Composition API guidelines  \n- TypeScript integration with auto-imports\n- SSR and data fetching best practices\n- Pinia state management setup\n```\n\n### Example 4: Using Configuration File\n\n```bash\n# context-forge.json\n{\n  \"projectName\": \"E-Commerce Platform\",\n  \"projectType\": \"fullstack\",\n  \"description\": \"Modern e-commerce platform with AI recommendations\",\n  \"prd\": {\n    \"content\": \"# E-Commerce Platform\\n\\n## Overview\\n...\",\n    \"features\": [\n      {\n        \"id\": \"auth\",\n        \"name\": \"User Authentication\",\n        \"priority\": \"must-have\",\n        \"complexity\": \"medium\"\n      },\n      {\n        \"id\": \"catalog\",\n        \"name\": \"Product Catalog\",\n        \"priority\": \"must-have\",\n        \"complexity\": \"complex\"\n      },\n      {\n        \"id\": \"cart\",\n        \"name\": \"Shopping Cart\",\n        \"priority\": \"must-have\",\n        \"complexity\": \"medium\"\n      },\n      {\n        \"id\": \"ai-recommendations\",\n        \"name\": \"AI Product Recommendations\",\n        \"priority\": \"should-have\",\n        \"complexity\": \"complex\"\n      }\n    ]\n  },\n  \"techStack\": {\n    \"frontend\": \"react\",\n    \"backend\": \"django\",\n    \"database\": \"postgresql\",\n    \"cache\": \"redis\",\n    \"search\": \"elasticsearch\"\n  },\n  \"extras\": {\n    \"prp\": true,\n    \"validation\": true,\n    \"docker\": true,\n    \"cicd\": true,\n    \"testing\": true\n  }\n}\n\n# Run with config\n$ context-forge init --config context-forge.json --output ecommerce-platform\n```\n\n## 🎯 Real-World Scenarios\n\n### Scenario 1: Startup MVP\n\nYou're building an MVP for a startup. You need to move fast but maintain quality:\n\n```bash\n# 1. Initialize with MVP timeline\ncontext-forge init --preset startup-mvp\n\n# 2. Review generated Implementation.md\ncat Docs/Implementation.md\n# Shows 2-week sprint plan with daily tasks\n\n# 3. Start development with Claude Code\n# Open CLAUDE.md in Claude Code\n# Follow Stage 1 tasks systematically\n\n# 4. Validate progress daily\ncontext-forge validate --levels syntax,tests\n```\n\n### Scenario 2: Enterprise Migration\n\nMigrating a legacy system to modern stack:\n\n```bash\n# 1. Create detailed PRD first\ncontext-forge init --prd legacy-migration-prd.md\n\n# 2. Select enterprise options\n# - Choose 'enterprise' timeline\n# - Enable all validation options\n# - Select comprehensive testing\n\n# 3. Generated structure includes:\n# - Migration strategy in Implementation.md\n# - Rollback procedures\n# - Comprehensive test suites\n# - Security audit checklists\n```\n\n### Scenario 3: Hackathon Project\n\n24-hour hackathon, need to prototype fast:\n\n```bash\n# 1. Quick setup\nnpx context-forge init --preset hackathon\n\n# 2. Skip optional features\n# - Disable PRP (too detailed for hackathon)\n# - Basic validation only\n# - Focus on core features\n\n# 3. Get building in \u003c 5 minutes\n# CLAUDE.md has simplified rules for rapid development\n```\n\n## 🔧 Retrofitting Existing Projects\n\n**NEW in v3.1.3+**: The `analyze` command allows you to retrofit existing codebases with AI-optimized documentation. This is perfect for:\n\n- Adding AI assistance to legacy projects\n- Upgrading existing projects with modern context engineering\n- Planning new features for established codebases\n- Generating PRPs for upcoming development work\n\n### How it Works\n\n1. **Smart Analysis**: Automatically detects your tech stack, project structure, and existing documentation\n2. **Interactive Setup**: Asks about your future development plans\n3. **Non-Destructive**: Never overwrites existing files (appends to CLAUDE.md with clear markers)\n4. **Feature PRPs**: Generates individual PRP files for each planned feature\n5. **Comprehensive Summary**: Creates a detailed retrofit summary with file tree visualization\n\n### Usage\n\n```bash\n# Run in your existing project directory\ncd /path/to/your/project\ncontext-forge analyze\n\n# Specify output directory\ncontext-forge analyze --output ./ai-docs\n\n# Target specific IDEs\ncontext-forge analyze --ide claude,cursor\n\n# Skip AI analysis for faster setup\ncontext-forge analyze --no-ai\n```\n\n### Example Output\n\n```\n📁 Generated Files:\n   ├── CLAUDE.md (UPDATED - appended retrofit section)\n   ├── Docs/\n   │   ├── Implementation.md\n   │   ├── project_structure.md\n   │   ├── UI_UX_doc.md\n   │   └── Bug_tracking.md\n   └── PRPs/\n       ├── user-authentication-prp.md\n       ├── payment-integration-prp.md\n       └── api-v2-prp.md\n```\n\nThe analyze command is intelligent enough to:\n\n- Detect if you're using TypeScript, Python, or other languages\n- Identify frameworks like React, Next.js, Express, FastAPI\n- Find existing documentation to use as context\n- Ask about your future plans to generate relevant PRPs\n\n## 🔄 Technology Migration\n\n**NEW in v3.1.4**: The `migrate` command helps you safely transition between technology stacks with comprehensive planning, risk analysis, and rollback strategies.\n\n### When to Use Migration\n\nPerfect for:\n- Modernizing legacy applications (e.g., jQuery → React, Flask → FastAPI)\n- Switching frameworks (e.g., Express → Next.js, Django → FastAPI)\n- Adopting new technologies while maintaining production stability\n- Planning complex migrations with shared resources (databases, auth systems)\n\n### How Migration Works\n\n1. **Analyzes Current Stack**: Detects your existing technology and architecture\n2. **Assesses Complexity**: Calculates migration risks and shared resource dependencies\n3. **Creates Phased Plan**: Generates step-by-step migration with checkpoints\n4. **Provides Safety Net**: Includes comprehensive rollback procedures\n5. **Monitors Progress**: Tracks migration status with validation gates\n\n### Usage\n\n```bash\n# Interactive migration planning\ncontext-forge migrate\n\n# Specify target technology\ncontext-forge migrate --target \"Next.js\"\n\n# Quick mode (skip detailed analysis)\ncontext-forge migrate --quick --target \"FastAPI\"\n\n# Analyze only (no file generation)\ncontext-forge migrate --analyze-only\n```\n\n### Example Migration Output\n\n```\n🔄 Migration Analysis Complete!\n\nSource: Flask + Jinja2 + SQLAlchemy\nTarget: Next.js + FastAPI + Prisma\nComplexity: HIGH (Score: 78/100)\nRecommended Strategy: parallel-run\n\n📁 Generated Migration Files:\n   ├── CLAUDE.md (Migration-aware configuration)\n   ├── PRPs/\n   │   ├── migration-overview.md\n   │   ├── phase-1-infrastructure.md\n   │   ├── phase-2-api-migration.md\n   │   ├── phase-3-frontend-migration.md\n   │   └── rollback-procedures.md\n   └── .claude/\n       ├── commands/migration/\n       │   ├── migration-status.md\n       │   ├── migration-checkpoint.md\n       │   └── migration-rollback.md\n       └── hooks/\n           ├── MigrationCheckpoint.py\n           └── DataIntegrityCheck.py\n```\n\n### Migration Features\n\n- **Shared Resource Detection**: Identifies databases, auth systems, and APIs used by both systems\n- **Risk Assessment**: Analyzes potential breaking changes and data integrity risks\n- **Parallel-Run Support**: Enables running old and new systems simultaneously\n- **Checkpoint System**: Human verification at critical migration milestones\n- **Rollback Planning**: One-command rollback to any checkpoint\n- **Progress Monitoring**: Real-time migration status and health checks\n\n### Migration Strategies\n\n1. **Big-Bang**: Complete cutover (low complexity projects)\n2. **Incremental**: Feature-by-feature migration (medium complexity)\n3. **Parallel-Run**: Both systems active during transition (high complexity)\n\n## 📚 Documentation\n\n### Generated Files Structure\n\nContext Forge creates IDE-specific documentation structures:\n\n#### Claude Code (Default)\n\n```\nproject-folder/\n├── CLAUDE.md                    # Main context file with tech-stack specific rules\n├── Docs/\n│   ├── Implementation.md        # Staged development plan\n│   ├── project_structure.md     # Folder organization\n│   ├── UI_UX_doc.md            # Design specifications\n│   └── Bug_tracking.md         # Bug tracking template\n├── PRPs/                       # Product Requirement Prompts (if enabled)\n│   ├── {project}-prp.md        # Base implementation PRP\n│   ├── {project}-planning.md   # Architecture planning (if enterprise/team)\n│   └── {feature}-prp.md        # Feature-specific PRPs (if retrofit)\n├── .claude/                    # Claude Code specific configuration\n│   ├── commands/               # Slash commands (20+ commands)\n│   │   ├── PRPs/              # PRP management commands\n│   │   ├── development/       # Development workflow commands\n│   │   ├── checkpoints/       # Human-in-the-loop commands\n│   │   └── migration/         # Migration commands (if applicable)\n│   └── hooks/                 # Claude Code hooks (if enabled)\n│       ├── PreCompact.py      # Context preservation hook\n│       ├── ContextRotation.py # Smart file switching\n│       ├── PreSubmit.py       # Quality gates\n│       ├── PRPTracking.py     # Progress monitoring\n│       ├── DartProgressUpdater.py # Dart task progress tracking\n│       ├── AutoTaskCommenter.py   # Automated task documentation\n│       └── TaskCodeMapper.py      # File-to-task mapping\n└── ai_docs/                   # AI documentation curation (if enabled)\n    └── README.md              # Documentation guide\n```\n\n#### Cursor IDE\n\n```\nproject-folder/\n├── .cursorrules               # Main Cursor rules file\n└── .cursor/\n    └── rules/\n        ├── global.md         # Global development rules\n        ├── project.md        # Project-specific rules\n        ├── prp-overview.mdc  # PRP implementation overview\n        ├── prp-stage-1.mdc   # Foundation setup tasks\n        ├── prp-stage-2.mdc   # Core feature implementation\n        ├── prp-stage-3.mdc   # Advanced features \u0026 polish\n        └── prp-validation.mdc # Validation gates \u0026 checks\n```\n\n#### Cline\n\n```\nproject-folder/\n└── .clinerules/              # Configuration directory\n    ├── README.md            # Main configuration\n    ├── context.md           # Project context\n    ├── rules.md             # Development rules\n    ├── patterns.md          # Code patterns\n    ├── prp-overview.md      # PRP implementation overview\n    ├── prp-stage-1.md       # Foundation setup tasks\n    ├── prp-stage-2.md       # Core feature implementation\n    ├── prp-stage-3.md       # Advanced features \u0026 polish\n    └── prp-validation.md    # Validation gates \u0026 checks\n```\n\n#### Gemini\n\n```\nproject-folder/\n├── GEMINI.md                 # Main Gemini configuration\n└── .gemini/\n    ├── context/\n    │   ├── project.md       # Project context\n    │   ├── architecture.md  # Architecture docs\n    │   └── guidelines.md    # Development guidelines\n    ├── prp/                 # PRP files (if features defined)\n    │   ├── overview.md      # PRP implementation overview\n    │   ├── stage-1-foundation.md\n    │   ├── stage-2-core.md\n    │   ├── stage-3-advanced.md\n    │   └── validation.md\n    └── config.yaml          # Gemini config with PRP settings\n```\n\n### Understanding Generated Files\n\n#### CLAUDE.md\n\nThe main context file that Claude Code reads first. It contains:\n\n- Project overview and tech stack\n- Development philosophy (KISS, YAGNI)\n- Code structure rules and limits\n- Tech-stack specific guidelines\n- Testing requirements\n- Pre-commit checklist\n\n#### Docs/Implementation.md\n\nYour roadmap with staged development:\n\n- **Stage 1**: Foundation (1-2 weeks) - Setup, configuration, base structure\n- **Stage 2**: Core Features (2-3 weeks) - Must-have functionality\n- **Stage 3**: Advanced Features (2-3 weeks) - Should-have features\n- **Stage 4**: Polish \u0026 Optimization (1-2 weeks) - Testing, performance\n\nEach stage contains:\n\n- Dependencies and prerequisites\n- Detailed task checklist\n- Validation requirements\n- Expected deliverables\n\n#### PRPs (Product Requirement Prompts)\n\nAdvanced prompts for complex implementations:\n\n- **base.md** - Implementation blueprint with pseudocode\n- **planning.md** - Architecture diagrams and decisions\n- **spec.md** - Technical specifications\n- **validation-gate.md** - Quality checkpoints\n\n### Interactive Setup Flow\n\nWhen you run `context-forge init`, you'll be guided through:\n\n1. **Project Information** - Name, type, and description\n2. **PRD Input** - Provide or create product requirements\n3. **Tech Stack Selection** - Choose frontend, backend, and database\n4. **Feature Selection** - Pick core features for your MVP\n5. **Configuration** - Timeline, team size, and deployment\n6. **Advanced Options** - PRP, validation, AI docs\n\n### Supported Tech Stacks\n\n#### Frontend Frameworks\n\n- **Next.js 15** - App Router, Server Components, React 19\n- **Nuxt 4** - NEW! Vue-based full-stack with enhanced TypeScript support\n- **React** - SPA with TypeScript and modern patterns\n- **Vue.js 3** - Composition API and TypeScript\n- **Angular** - Standalone components, RxJS\n- **Vanilla JavaScript** - No framework approach\n\n#### Backend Frameworks\n\n- **FastAPI** (Python) - Async, Pydantic v2, type hints\n- **Express.js** (Node.js) - TypeScript, middleware patterns\n- **Django** (Python) - MVT, ORM, admin interface\n- **Spring Boot** (Java) - REST APIs, dependency injection\n- **Ruby on Rails** - Convention over configuration\n\n#### Databases\n\n- PostgreSQL, MySQL, MongoDB, SQLite, Redis\n\n### Validation System\n\nContext Forge includes a powerful validation system that ensures code quality:\n\n```bash\n# Run all critical validations\ncontext-forge validate\n\n# Run specific validation levels\ncontext-forge validate --levels syntax,tests\n\n# Run all validations including optional ones\ncontext-forge validate --all\n\n# Generate detailed report\ncontext-forge validate --report\n\n# Validate in specific directory\ncontext-forge validate --path ./my-project\n```\n\n#### Validation Levels\n\n| Level        | Description                | Critical | Commands                        |\n| ------------ | -------------------------- | -------- | ------------------------------- |\n| **syntax**   | Type checking and linting  | ✅ Yes   | `tsc`, `eslint`, `mypy`, etc.   |\n| **tests**    | Unit and integration tests | ✅ Yes   | `jest`, `pytest`, `rspec`, etc. |\n| **coverage** | Code coverage analysis     | ❌ No    | With coverage reporters         |\n| **build**    | Production build           | ✅ Yes   | Framework-specific build        |\n| **security** | Vulnerability scanning     | ❌ No    | `npm audit`, `safety`, etc.     |\n\n#### Example Validation Report\n\n```\n📊 Validation Report - Analytics Dashboard\n==================================================\n✅ Status: PASSED\n\nTotal: 5 | Passed: 5 | Failed: 0\n\n✅ syntax:tsc --noEmit (342ms)\n✅ syntax:eslint src --ext .ts,.tsx (567ms)\n✅ tests:jest --coverage (4521ms)\n✅ build:next build (8234ms)\n✅ security:npm audit (1023ms)\n\nFull report saved to: .validation-reports/latest-report.md\n```\n\n### Configuration File\n\nSkip interactive prompts with a configuration file:\n\n```json\n{\n  \"projectName\": \"My App\",\n  \"projectType\": \"fullstack\",\n  \"description\": \"A collaborative platform\",\n  \"techStack\": {\n    \"frontend\": \"nextjs\",\n    \"backend\": \"fastapi\",\n    \"database\": \"postgresql\",\n    \"auth\": \"jwt\"\n  },\n  \"features\": [\n    {\n      \"id\": \"auth\",\n      \"name\": \"Authentication\",\n      \"priority\": \"must-have\"\n    }\n  ],\n  \"extras\": {\n    \"prp\": true,\n    \"validation\": true,\n    \"docker\": true\n  }\n}\n```\n\nUse with: `context-forge init --config context-forge.json`\n\n## 🔄 Complete Workflow\n\n### Step 1: Initialize Your Project\n\n```bash\n# Run the init command\ncontext-forge init\n\n# Answer the interactive prompts\n# Context Forge will analyze your requirements and generate appropriate documentation\n```\n\n### Step 2: Review Generated Documentation\n\n```bash\n# 1. Start with CLAUDE.md\ncat CLAUDE.md\n# This is your project's \"constitution\" - rules Claude Code will follow\n\n# 2. Check your implementation plan\ncat Docs/Implementation.md\n# This breaks down development into manageable stages\n\n# 3. Review project structure\ncat Docs/project_structure.md\n# This defines how your code should be organized\n```\n\n### Step 3: Start Development with Claude Code\n\n1. Open your project in Claude Code\n2. Add the entire project folder to Claude's context\n3. Start with Stage 1 tasks from Implementation.md\n4. Claude will follow the rules in CLAUDE.md automatically\n\n### Step 4: Validate Your Progress\n\n```bash\n# After completing each stage\ncontext-forge validate\n\n# Before committing code\ncontext-forge validate --levels syntax,tests\n\n# For comprehensive check\ncontext-forge validate --all --report\n```\n\n### Step 5: Iterate and Improve\n\n- Update Bug_tracking.md when you encounter issues\n- Claude Code will learn from documented bugs\n- Run validation frequently to maintain quality\n\n## 🎮 Advanced Usage\n\n### Custom Templates\n\nCreate your own templates in `~/.context-forge/templates/`:\n\n```bash\n# Custom tech stack template\n~/.context-forge/templates/claude/my-stack.md\n\n# Custom validation commands\n~/.context-forge/templates/validation/my-validation.json\n```\n\n### Hooks and Automation\n\nAdd pre/post hooks in `.context-forge/hooks/`:\n\n```bash\n# pre-init.sh - Run before initialization\n#!/bin/bash\necho \"Setting up environment...\"\n\n# post-init.sh - Run after initialization\n#!/bin/bash\necho \"Installing dependencies...\"\nnpm install\n```\n\n### CI/CD Integration\n\n```yaml\n# .github/workflows/validate.yml\nname: Context Forge Validation\non: [push, pull_request]\n\njobs:\n  validate:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n      - uses: actions/setup-node@v3\n      - run: npm install -g context-forge\n      - run: context-forge validate --all\n```\n\n## 🏗️ Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/webdevtodayjason/context-forge.git\ncd context-forge\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n\n# Run linting\nnpm run lint\n```\n\n### Project Structure\n\n```\ncontext-forge/\n├── src/\n│   ├── cli/              # CLI entry point and commands\n│   ├── commands/         # Command implementations\n│   ├── generators/       # Document generators\n│   ├── templates/        # Handlebars templates\n│   ├── data/            # Tech stack configurations\n│   └── types/           # TypeScript definitions\n├── templates/           # Document templates\n└── tests/              # Test files\n```\n\n## 🙏 Credits\n\n### Special Thanks\n\nThis project was inspired by and built upon the work of amazing developers:\n\n- **[Rasmus Widing (Wirasm)](https://github.com/Wirasm)** - For the incredible [PRPs-agentic-eng](https://github.com/Wirasm/PRPs-agentic-eng) project that provided the foundation for our PRP (Product Requirement Prompt) system. The PRP methodology and validation loops are directly inspired by Rasmus's groundbreaking work.\n- **[AILABS (@AILABS-393)](https://www.youtube.com/@AILABS-393)** - For the excellent educational content and YouTube tutorials on AI-assisted development, prompt engineering, and Claude Code workflows\n- **[AI Labs Discord Community](https://discord.gg/tqU6S6qZ)** - For feedback, ideas, and support\n- **[Dynamous.ai Community](https://dynamous.ai)** - For pioneering work in AI-assisted development and collaborative innovation\n\n### Built With\n\n- **[Andre Karpathy](https://karpathy.ai/)** - Context engineering principles\n- **[Claude Code by Anthropic](https://claude.ai/code)** - The AI assistant this tool is designed for\n- **[Commander.js](https://github.com/tj/commander.js/)** - CLI framework\n- **[Inquirer.js](https://github.com/SBoudrias/Inquirer.js/)** - Interactive prompts\n- **[Handlebars](https://handlebarsjs.com/)** - Template engine\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n### Ways to Contribute\n\n- 🐛 Report bugs and issues\n- 💡 Suggest new features\n- 📝 Improve documentation\n- 🔧 Add new tech stack templates\n- 🌐 Translate documentation\n- ⭐ Star the project!\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🔗 Links\n\n- **Repository**: [github.com/webdevtodayjason/context-forge](https://github.com/webdevtodayjason/context-forge)\n- **npm Package**: [npmjs.com/package/context-forge](https://www.npmjs.com/package/context-forge)\n- **Issues**: [GitHub Issues](https://github.com/webdevtodayjason/context-forge/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/webdevtodayjason/context-forge/discussions)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the Context Forge community**\n\n_Empowering developers to build smarter, not harder_\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./img/context-forge-logo.png\" alt=\"Context Forge Logo\" height=\"60\" /\u003e\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"./img/sem-logo.png\" alt=\"SimFreak Logo\" height=\"60\" /\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \n[![Star History Chart](https://api.star-history.com/svg?repos=webdevtodayjason/context-forge\u0026type=Date)](https://star-history.com/#webdevtodayjason/context-forge\u0026Date)\n\n\u003c/div\u003e\n","funding_links":[],"categories":["Tools \u0026 Utilities"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fcontext-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdevtodayjason%2Fcontext-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fcontext-forge/lists"}