create-claude-context 1.0.0 → 1.2.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 SireJeff
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 SireJeff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,146 +1,169 @@
-# create-claude-context
-
-Set up Claude Context Engineering for any project with a single command.
-
-## Quick Start
-
-```bash
-npx create-claude-context
-```
-
-Or with npm init:
-
-```bash
-npm init claude-context
-```
-
-## What It Does
-
-This CLI tool sets up a complete context engineering system for your codebase:
-
-1. **Creates `.claude/` directory** - Context engineering documentation
-2. **Creates `CLAUDE.md`** - Entry point for Claude Code
-3. **Detects tech stack** - Auto-configures for your project
-4. **Installs plugin** - Adds ongoing commands (optional)
-
-## Options
-
-```bash
-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
-  -v, --verbose      Show detailed output
-  -V, --version      Output version number
-  -h, --help         Display help
-```
-
-## Tech Stack Presets
-
-```bash
-# 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
-
-```bash
-# 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](https://github.com/SireJeff/claude-context-engineering-template)
-- [Documentation](https://github.com/SireJeff/claude-context-engineering-template#readme)
-- [Issues](https://github.com/SireJeff/claude-context-engineering-template/issues)
+# 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
+
+```bash
+npx create-claude-context
+```
+
+Or with npm init:
+
+```bash
+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
+
+```bash
+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
+
+```bash
+# 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
+
+```bash
+# 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](https://github.com/SireJeff/claude-context-engineering-template)
+- [Documentation](https://github.com/SireJeff/claude-context-engineering-template#readme)
+- [Issues](https://github.com/SireJeff/claude-context-engineering-template/issues)

package/bin/create-claude-context.js

@@ -1,61 +1,75 @@
-#!/usr/bin/env node
-
-/**
- * create-claude-context CLI
- *
- * Set up Claude Context Engineering for any project with a single command.
- *
- * Usage:
- *   npx create-claude-context
- *   npx create-claude-context my-project
- *   npx create-claude-context --yes
- */
-
-const { program } = require('commander');
-const chalk = require('chalk');
-const { run } = require('../lib');
-const packageJson = require('../package.json');
-
-// ASCII Banner
-const banner = `
-${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
-${chalk.cyan('║')}  ${chalk.bold.white('Claude Context Engineering')}                               ${chalk.cyan('║')}
-${chalk.cyan('║')}  ${chalk.gray('Optimize AI-assisted development with pre-computed')}       ${chalk.cyan('║')}
-${chalk.cyan('║')}  ${chalk.gray('system knowledge and structured documentation.')}           ${chalk.cyan('║')}
-${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
-`;
-
-program
-  .name('create-claude-context')
-  .description('Set up Claude Context Engineering for your project')
-  .version(packageJson.version)
-  .argument('[project-name]', 'Name of the project (defaults to current directory name)')
-  .option('-y, --yes', 'Skip prompts and use defaults')
-  .option('--no-plugin', 'Skip Claude Code plugin installation')
-  .option('-t, --template <preset>', 'Use a tech stack preset (python-fastapi, node-express, etc.)')
-  .option('--no-git', 'Skip git initialization')
-  .option('--dry-run', 'Show what would be done without making changes')
-  .option('-v, --verbose', 'Show detailed output')
-  .action(async (projectName, options) => {
-    console.log(banner);
-
-    try {
-      await run({
-        projectName,
-        skipPrompts: options.yes,
-        installPlugin: options.plugin !== false,
-        template: options.template,
-        initGit: options.git !== false,
-        dryRun: options.dryRun,
-        verbose: options.verbose
-      });
-    } catch (error) {
-      console.error(chalk.red('\n✖ Error:'), error.message);
-      if (options.verbose) {
-        console.error(chalk.gray(error.stack));
-      }
-      process.exit(1);
-    }
-  });
-
-program.parse();
+#!/usr/bin/env node
+
+/**
+ * create-claude-context CLI
+ *
+ * Set up Claude Context Engineering for any project with a single command.
+ *
+ * Usage:
+ *   npx create-claude-context
+ *   npx create-claude-context my-project
+ *   npx create-claude-context --yes
+ */
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { run } = require('../lib');
+const packageJson = require('../package.json');
+
+// ASCII Banner
+const banner = `
+${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
+${chalk.cyan('║')}  ${chalk.bold.white('Claude Context Engineering')}                               ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('Optimize AI-assisted development with pre-computed')}       ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('system knowledge and structured documentation.')}           ${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
+`;
+
+program
+  .name('create-claude-context')
+  .description('Set up Claude Context Engineering for your project')
+  .version(packageJson.version)
+  .argument('[project-name]', 'Name of the project (defaults to current directory name)')
+  .option('-y, --yes', 'Skip prompts and use defaults')
+  .option('--no-plugin', 'Skip Claude Code plugin installation')
+  .option('-t, --template <preset>', 'Use a tech stack preset (python-fastapi, node-express, etc.)')
+  .option('--no-git', 'Skip git initialization')
+  .option('--dry-run', 'Show what would be done without making changes')
+  .option('-v, --verbose', 'Show detailed output')
+  // New options for context engineering initialization
+  .option('--ai', 'Force AI mode (creates INIT_REQUEST.md for @context-engineer)')
+  .option('--static', 'Force standalone mode (static analysis only, no AI setup)')
+  .option('--analyze-only', 'Run codebase analysis without installation')
+  .action(async (projectName, options) => {
+    console.log(banner);
+
+    // Validate mutually exclusive options
+    if (options.ai && options.static) {
+      console.error(chalk.red('\n✖ Error: --ai and --static are mutually exclusive'));
+      process.exit(1);
+    }
+
+    try {
+      await run({
+        projectName,
+        skipPrompts: options.yes,
+        installPlugin: options.plugin !== false,
+        template: options.template,
+        initGit: options.git !== false,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+        // New options
+        forceAi: options.ai,
+        forceStatic: options.static,
+        analyzeOnly: options.analyzeOnly
+      });
+    } catch (error) {
+      console.error(chalk.red('\n✖ Error:'), error.message);
+      if (options.verbose) {
+        console.error(chalk.gray(error.stack));
+      }
+      process.exit(1);
+    }
+  });
+
+program.parse();