@agentic15.com/agentic15-claude-zen 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-12-24
+
+### Added
+- Initial release of Agentic15 Claude Zen framework
+- Structured project planning with hierarchical organization (Project → Subproject → Milestone → Task)
+- Automated quality enforcement through Git hooks
+- Smart testing that runs only changed files during commits
+- UI component workflow enforcement (component + test + integration site)
+- Framework-agnostic support (React, Vue, Angular, Svelte)
+- Complete Jest + Babel configuration for testing
+- Token-optimized prompts with caching support
+- Minified and bundled hooks for fast execution
+- Comprehensive documentation and examples
+- Post-install guide for quick setup
+- Task management scripts (start, done, next, status)
+- Plan management scripts (generate, init, amend)
+- Integration testing site for UI previews
+- Dependency tracking and validation
+- Progress monitoring and time estimation
+
+### Features
+- **Pre-commit hooks** validate tests, code quality, and UI components
+- **Smart testing** runs only changed files during commits (scales to 43,000+ line codebases)
+- **Test quality validation** blocks empty tests and missing assertions
+- **UI integration validation** enforces complete component workflow
+- **Immutable plans** with audit trail for amendments
+- **SOLID architecture** with clean separation of concerns
+
+### Documentation
+- Getting Started guide
+- User Workflows documentation
+- Agent Workflows documentation
+- Plan Management guide
+- Task Management guide
+- Test Execution strategies
+- Architecture documentation with SOLID principles
+
+[1.0.0]: https://github.com/agentic15/claude-zen/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024-2025 Agentic15
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,204 @@
+# Agentic15 Claude Zen
+
+> **Code with Intelligence, Ship with Confidence**
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![npm version](https://badge.fury.io/js/@agentic15.com%2Fagentic15-claude-zen.svg)](https://www.npmjs.com/package/@agentic15.com/agentic15-claude-zen)
+[![GitHub stars](https://img.shields.io/github/stars/agentic15/claude-zen.svg)](https://github.com/agentic15/claude-zen/stargazers)
+
+**Agentic15 Claude Zen** is a professional, enterprise-grade framework for structured AI-assisted software development with Claude Code. It enforces quality standards, automates testing, and ensures every commit meets production requirements.
+
+## 🎯 What is Agentic15 Claude Zen?
+
+A comprehensive development framework that transforms Claude Code into a disciplined, production-ready development environment through:
+
+- **Structured Project Management**: Hierarchical plans, task tracking, and progress monitoring
+- **Automated Quality Enforcement**: Git hooks that validate tests, code quality, and UI components
+- **Smart Testing**: Only test changed files (perfect for 43,000+ line codebases)
+- **UI Component Workflows**: Enforced 3-file pattern (component, test, integration site)
+- **Framework Agnostic**: Works with React, Vue, Angular, Svelte, and more
+
+## 🚀 Quick Start
+
+```bash
+# Create a new project
+npx @agentic15.com/agentic15-claude-zen my-project
+
+# Navigate to project
+cd my-project
+
+# Read the post-install guide
+cat .claude/POST-INSTALL.md
+
+# Start developing
+npm run plan:generate "Build a todo app with React"
+```
+
+## 📚 Documentation
+
+Comprehensive documentation is available in the [GitHub repository](https://github.com/agentic15/claude-zen):
+
+- **[Getting Started](https://github.com/agentic15/claude-zen/blob/main/docs/getting-started/README.md)** - Installation, configuration, quick start
+- **[User Workflows](https://github.com/agentic15/claude-zen/blob/main/docs/workflows/user-workflow.md)** - How humans interact with the framework
+- **[Agent Workflows](https://github.com/agentic15/claude-zen/blob/main/docs/workflows/agent-workflow.md)** - How Claude Code operates within the framework
+- **[Plan Management](https://github.com/agentic15/claude-zen/blob/main/docs/workflows/plan-management.md)** - Creating, locking, and amending plans
+- **[Task Management](https://github.com/agentic15/claude-zen/blob/main/docs/workflows/task-management.md)** - Starting, tracking, and completing tasks
+- **[Test Execution](https://github.com/agentic15/claude-zen/blob/main/docs/workflows/test-execution.md)** - Smart testing strategies for all project sizes
+- **[Architecture](https://github.com/agentic15/claude-zen/blob/main/docs/architecture/README.md)** - Design principles, SOLID patterns, directory structure
+
+## ✨ Key Features
+
+### 📋 Structured Development
+- Hierarchical project planning (Project → Subproject → Milestone → Task)
+- Immutable plans with audit trail for amendments
+- Dependency tracking and validation
+- Progress monitoring and time estimation
+
+### 🔒 Quality Enforcement
+- **Pre-commit hooks** validate tests, code quality, and UI components
+- **Smart testing** runs only changed files during commits
+- **Test quality validation** blocks empty tests, missing assertions
+- **UI integration validation** enforces component + test + integration site pattern
+
+### ⚡ Performance
+- Token-optimized with prompt caching
+- Smart file change detection for testing
+- Minified and bundled hooks for fast execution
+- Scales to projects with 43,000+ lines of code
+
+### 🎨 UI Development
+- Framework-agnostic (React, Vue, Angular, Svelte)
+- Complete Jest + Babel configuration included
+- Testing Library integration
+- Integration site for stakeholder previews
+
+## 🏗️ Directory Structure
+
+```
+your-project/
+├── .claude/              # Framework configuration (DO NOT EDIT)
+│   ├── hooks/            # Git hooks for enforcement
+│   ├── plans/            # Project plans and task tracking
+│   ├── CLAUDE.md         # Instructions for Claude Code
+│   ├── POST-INSTALL.md   # Setup guide
+│   └── settings.json     # Claude Code hook configuration
+├── Agent/                # Your workspace (EDIT HERE)
+│   ├── src/              # Source code
+│   ├── tests/            # Test files
+│   └── db/               # Database scripts
+├── scripts/              # Build and deployment scripts
+├── test-site/            # Integration testing site (UI projects)
+├── jest.config.js        # Test configuration
+├── .babelrc              # Transpiler configuration
+└── package.json          # Project dependencies
+```
+
+## 🔧 Core Workflows
+
+### For Project Owners (Humans)
+
+1. **Create a plan**: `npm run plan:generate "Your project description"`
+2. **Review and approve**: Claude creates `PROJECT-PLAN.json`
+3. **Lock the plan**: `npm run plan:init`
+4. **Start a task**: `npm run task:start TASK-001`
+5. **Monitor progress**: `npm run task:status`
+6. **Complete task**: `npm run task:done TASK-001`
+
+### For AI Agents (Claude Code)
+
+1. **Read task requirements**: `.claude/plans/*/tasks/TASK-XXX.json`
+2. **Write code** in `Agent/` directory
+3. **Write tests** with real assertions
+4. **Run tests**: `npm test` (must pass)
+5. **Commit**: Git hooks validate automatically
+6. **Mark complete**: After all criteria met
+
+## 🧪 Smart Testing
+
+**Problem**: Large codebases with 43,000+ lines take too long to test on every commit.
+
+**Solution**: Git hooks test ONLY changed files:
+
+- Detects staged files
+- Maps source files to test files
+- Runs related tests only
+- Manual `npm test` still runs full suite
+
+```bash
+# During git commit (fast - changed files only)
+git commit -m "Fix bug"
+# → Tests 3 files in 2 seconds
+
+# Manual full test suite (slower - all files)
+npm test
+# → Tests 500 files in 45 seconds
+```
+
+## 🎨 UI Component Workflow
+
+Every UI component requires 3 files:
+
+1. **Component**: `Agent/src/components/Button.jsx`
+2. **Test**: `Agent/tests/components/Button.test.jsx`
+3. **Integration**: `test-site/src/components/Button.jsx`
+
+Git hooks BLOCK commits missing any of these files.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](https://github.com/agentic15/claude-zen/blob/main/CONTRIBUTING.md) for guidelines.
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/agentic15/claude-zen.git
+cd claude-zen
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build package
+npm run build
+```
+
+## 🔐 Security
+
+For security vulnerabilities, please email security@agentic15.com
+
+See [SECURITY.md](https://github.com/agentic15/claude-zen/blob/main/SECURITY.md) for our security policy.
+
+## 📄 License
+
+Copyright 2024-2025 Agentic15
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+See [LICENSE](https://github.com/agentic15/claude-zen/blob/main/LICENSE) for full text.
+
+## 🏢 About Agentic15
+
+**Agentic15** is a software development company specializing in AI-assisted development tools and frameworks.
+
+- **Website**: https://agentic15.com
+- **Documentation**: https://docs.agentic15.com
+- **GitHub**: https://github.com/agentic15
+- **Twitter**: https://twitter.com/agentic15
+- **Email**: hello@agentic15.com
+
+---
+
+**"Code with Intelligence, Ship with Confidence"** - Agentic15

package/bin/create-agentic15-claude-zen.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+
+/**
+ * Copyright 2024-2025 Agentic15
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * create-agentic15-claude-zen
+ *
+ * CLI entry point for creating new projects with Agentic15 Claude Zen framework
+ *
+ * Usage: npx create-agentic15-claude-zen [project-name]
+ *        npx create-agentic15-claude-zen (interactive mode)
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { createInterface } from 'readline';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get package version
+function getVersion() {
+  const pkgPath = join(__dirname, '..', 'package.json');
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  return pkg.version;
+}
+
+// Show help message
+function showHelp() {
+  const version = getVersion();
+  console.log(`
+Agentic15 Claude Zen Project Generator v${version}
+"Code with Intelligence, Ship with Confidence"
+
+Usage:
+  npx create-agentic15-claude-zen [project-name] [options]
+
+Options:
+  --help, -h       Show this help message
+  --version, -v    Show version number
+
+Examples:
+  npx create-agentic15-claude-zen my-project    Create project with defaults
+  npx create-agentic15-claude-zen               Interactive mode with prompts
+
+Interactive Mode:
+  When run without a project name, you will be prompted for:
+  - Project name (lowercase, numbers, hyphens, underscores)
+  - Git initialization (Y/n)
+  - Install dependencies (Y/n)
+
+Framework Features:
+  - Structured task-based development workflow
+  - Git workflow enforcement with hooks
+  - Smart testing (tests only changed files)
+  - Pre-commit validation and auto-formatting
+  - Task tracking with dependencies
+  - Immutable project plan management
+  - UI component workflow (Agent + test-site)
+
+For more information: https://github.com/agentic15/claude-zen
+`);
+}
+
+// Helper: Create readline interface
+function createPrompt() {
+  return createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
+
+// Helper: Prompt user for input
+function question(rl, query) {
+  return new Promise(resolve => rl.question(query, resolve));
+}
+
+// Helper: Validate project name
+function isValidProjectName(name) {
+  return /^[a-z0-9-_]+$/.test(name);
+}
+
+// Main execution
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Handle --help flag
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    process.exit(0);
+  }
+
+  // Handle --version flag
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(getVersion());
+    process.exit(0);
+  }
+
+  let projectName = args[0];
+  let initGit = true;
+  let installDeps = true;
+
+  console.log('\n🚀 Agentic15 Claude Zen Project Generator');
+  console.log('   "Code with Intelligence, Ship with Confidence"\n');
+
+  // Interactive mode if no project name provided
+  if (!projectName) {
+    const rl = createPrompt();
+
+    // Ask for project name
+    while (!projectName || !isValidProjectName(projectName)) {
+      projectName = await question(rl, '📁 Project name (lowercase, numbers, hyphens, underscores): ');
+      projectName = projectName.trim();
+
+      if (!projectName) {
+        console.log('❌ Project name is required');
+        continue;
+      }
+
+      if (!isValidProjectName(projectName)) {
+        console.log('❌ Invalid name. Use only lowercase letters, numbers, hyphens, and underscores');
+        projectName = null;
+      }
+    }
+
+    // Ask about git initialization
+    const gitAnswer = await question(rl, '\n🔧 Initialize git repository? (Y/n): ');
+    initGit = !gitAnswer.trim() || gitAnswer.toLowerCase() === 'y';
+
+    // Ask about npm install
+    const depsAnswer = await question(rl, '📦 Install dependencies after creation? (Y/n): ');
+    installDeps = !depsAnswer.trim() || depsAnswer.toLowerCase() === 'y';
+
+    rl.close();
+    console.log('');
+  }
+
+  // Validate project name
+  if (!isValidProjectName(projectName)) {
+    console.error('❌ ERROR: Invalid project name\n');
+    console.log('Project name must:');
+    console.log('  - Use only lowercase letters, numbers, hyphens, and underscores');
+    console.log('  - Not contain spaces or special characters\n');
+    console.log('Example: my-app, my_app, myapp123\n');
+    process.exit(1);
+  }
+
+  // Check if directory already exists
+  const targetDir = join(process.cwd(), projectName);
+  if (existsSync(targetDir)) {
+    console.error(`❌ ERROR: Directory "${projectName}" already exists\n`);
+    console.log('Please choose a different name or remove the existing directory.\n');
+    process.exit(1);
+  }
+
+  console.log('🚀 Creating new project with Agentic15 Claude Zen framework...\n');
+  console.log(`📁 Project: ${projectName}`);
+  console.log(`📂 Location: ${targetDir}`);
+  console.log(`🔧 Git: ${initGit ? 'Yes' : 'No'}`);
+  console.log(`📦 Install deps: ${installDeps ? 'Yes' : 'No'}\n`);
+
+  // Import and run initialization
+  try {
+    const { initializeProject } = await import('../dist/index.js');
+    await initializeProject(projectName, targetDir, { initGit, installDeps });
+
+    console.log('\n✅ Project created successfully!\n');
+    console.log('Next steps:');
+    console.log(`  cd ${projectName}`);
+    if (!installDeps) {
+      console.log('  npm install');
+    }
+    console.log('  cat .claude/POST-INSTALL.md\n');
+
+  } catch (error) {
+    console.error('\n❌ ERROR: Failed to create project\n');
+    console.error(error.message);
+    if (error.stack) {
+      console.error('\nStack trace:');
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/dist/hooks/auto-format.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+function _0x3c64(_0x302c1a,_0x9eef54){_0x302c1a=_0x302c1a-0x94;var _0x44d243=_0x226f();var _0x3e1e5a=_0x44d243[_0x302c1a];return _0x3e1e5a;}var _0x4791ea=_0x3c64;(function(_0x31064e,_0x12b6a5){var _0x4704fc=_0x3c64,_0x4e83f9=_0x31064e();while(!![]){try{var _0x178d75=parseInt(_0x4704fc(0xb0))/0x1*(parseInt(_0x4704fc(0xa5))/0x2)+parseInt(_0x4704fc(0x9d))/0x3*(parseInt(_0x4704fc(0xbf))/0x4)+-parseInt(_0x4704fc(0x9e))/0x5*(-parseInt(_0x4704fc(0xa2))/0x6)+parseInt(_0x4704fc(0xab))/0x7+parseInt(_0x4704fc(0xc3))/0x8+-parseInt(_0x4704fc(0x9c))/0x9*(-parseInt(_0x4704fc(0x95))/0xa)+-parseInt(_0x4704fc(0xad))/0xb*(parseInt(_0x4704fc(0xae))/0xc);if(_0x178d75===_0x12b6a5)break;else _0x4e83f9['push'](_0x4e83f9['shift']());}catch(_0x419a83){_0x4e83f9['push'](_0x4e83f9['shift']());}}}(_0x226f,0xe30d7));var _0x322c2d=(function(){var _0x420116=_0x3c64,_0x8458f6={};_0x8458f6['vymdq']=_0x420116(0x9f),_0x8458f6['kEGvH']='PmtNV',_0x8458f6[_0x420116(0xa6)]=function(_0x2f523d,_0x1a746a){return _0x2f523d!==_0x1a746a;},_0x8458f6[_0x420116(0xc0)]=_0x420116(0xa0);var _0x2a54f0=_0x8458f6,_0x5ec5bb=!![];return function(_0x41d288,_0x10ef5b){var _0x1657c0=_0x420116,_0x4bbe1c={};_0x4bbe1c['udesG']=_0x2a54f0[_0x1657c0(0x94)],_0x4bbe1c['tcNlY']=_0x2a54f0[_0x1657c0(0xb8)];var _0x5a434b=_0x4bbe1c;if(_0x2a54f0['YiaAD'](_0x2a54f0[_0x1657c0(0xc0)],_0x2a54f0['CHYHZ']))return _0x337223[_0x1657c0(0x9a)]()[_0x1657c0(0xc1)](_0x5a434b[_0x1657c0(0xa3)])[_0x1657c0(0x9a)]()[_0x1657c0(0xbc)](_0xec7b82)[_0x1657c0(0xc1)](_0x5a434b['udesG']);else{var _0x3121f6=_0x5ec5bb?function(){var _0x223ede=_0x1657c0;if(_0x5a434b[_0x223ede(0xa7)]===_0x223ede(0xb7))_0x1b8d76[_0x223ede(0xa1)](_0x223ede(0xb5)+_0x187d5f);else{if(_0x10ef5b){var _0x471eee=_0x10ef5b[_0x223ede(0xaf)](_0x41d288,arguments);return _0x10ef5b=null,_0x471eee;}}}:function(){};return _0x5ec5bb=![],_0x3121f6;}};}()),_0x3e1e5a=_0x322c2d(this,function(){var _0x165b39=_0x3c64,_0x407316={};_0x407316[_0x165b39(0xb1)]=_0x165b39(0x9f);var _0x3b8086=_0x407316;return _0x3e1e5a[_0x165b39(0x9a)]()[_0x165b39(0xc1)](_0x3b8086[_0x165b39(0xb1)])[_0x165b39(0x9a)]()[_0x165b39(0xbc)](_0x3e1e5a)[_0x165b39(0xc1)](_0x3b8086[_0x165b39(0xb1)]);});function _0x226f(){var _0x42c162=['kEGvH','llesW','python\x20-m\x20black\x20--version','file_path','constructor','\x22\x20is\x20not\x20supported','HkdLj','12ZTFWzp','CHYHZ','search','child_process','9877328zXkfkg','vymdq','80QzZlPu','Dynamic\x20require\x20of\x20\x22','tool_input','ignore','match','toString','existsSync','1432071iXABub','234147MJoLtJ','60890ZXVOAV','(((.+)+)+)+$','DkNTk','warn','438VASfZQ','udesG','stdio','188554oaxsFC','YiaAD','tcNlY','npx\x20prettier\x20--version','argv','Formatted:\x20','11908463wojzaP','XXIdb','22xWZCLm','29240076sgWHxi','apply','5EZjVuf','gFnuB','exit','VSLAx','log','Warning:\x20Could\x20not\x20format\x20','parse','JOXHM'];_0x226f=function(){return _0x42c162;};return _0x226f();}_0x3e1e5a();var r=(_0x2f8d52=>typeof require<'u'?require:typeof Proxy<'u'?new Proxy(_0x2f8d52,{'get':(_0x43f87f,_0x54da00)=>(typeof require<'u'?require:_0x43f87f)[_0x54da00]}):_0x2f8d52)(function(_0x32112d){var _0x2c7494=_0x3c64,_0x3d681f={'XXIdb':function(_0x25c6a9,_0xdbc220){return _0x25c6a9<_0xdbc220;},'GKkIG':function(_0x2b101c,_0x37e673){return _0x2b101c(_0x37e673);},'llesW':function(_0x41b022,_0x4487a5){return _0x41b022+_0x4487a5;},'HkdLj':function(_0x1e9bc5,_0x14ca8f){return _0x1e9bc5+_0x14ca8f;},'VSLAx':_0x2c7494(0x96)};if(_0x3d681f[_0x2c7494(0xac)](typeof require,'u'))return require[_0x2c7494(0xaf)](this,arguments);throw _0x3d681f['GKkIG'](Error,_0x3d681f[_0x2c7494(0xb9)](_0x3d681f[_0x2c7494(0xbe)](_0x3d681f[_0x2c7494(0xb3)],_0x32112d),_0x2c7494(0xbd)));}),{execSync:e}=r(_0x4791ea(0xc2)),i=r('fs'),c=process[_0x4791ea(0xa9)][0x2]||'{}',a=JSON[_0x4791ea(0xb6)](c),t=a[_0x4791ea(0x97)]?.[_0x4791ea(0xbb)];(!t||!i[_0x4791ea(0x9b)](t))&&process['exit'](0x0);try{if(t['match'](/\.(ts|tsx|js|jsx|json)$/))try{var _0x247836={};_0x247836[_0x4791ea(0xa4)]='ignore';var _0xfc8130={};_0xfc8130[_0x4791ea(0xa4)]=_0x4791ea(0x98),(e(_0x4791ea(0xa8),_0x247836),e('npx\x20prettier\x20--write\x20\x22'+t+'\x22',_0xfc8130),console[_0x4791ea(0xb4)](_0x4791ea(0xaa)+t));}catch{}else{if(t[_0x4791ea(0x99)](/\.py$/))try{var _0x3fe97f={};_0x3fe97f['stdio']=_0x4791ea(0x98);var _0x3299d4={};_0x3299d4[_0x4791ea(0xa4)]=_0x4791ea(0x98),(e(_0x4791ea(0xba),_0x3fe97f),e('python\x20-m\x20black\x20\x22'+t+'\x22',_0x3299d4),console[_0x4791ea(0xb4)](_0x4791ea(0xaa)+t));}catch{}}}catch{console[_0x4791ea(0xa1)]('Warning:\x20Could\x20not\x20format\x20'+t);}process[_0x4791ea(0xb2)](0x0);