@agentic15.com/agentic15-claude-zen 1.0.0

package/templates/.claude/settings.json

@@ -0,0 +1,262 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(**)",
+      "Glob",
+      "Grep",
+      "Bash(npm run *)",
+      "Bash(git status*)",
+      "Bash(git log*)",
+      "Bash(git diff*)",
+      "Bash(git branch*)",
+      "Bash(git checkout main)",
+      "Bash(git add *)",
+      "Bash(git commit*)",
+      "Bash(git push*)",
+      "Edit(./Agent/**)",
+      "Write(./Agent/**)",
+      "Edit(./scripts/**)",
+      "Write(./scripts/**)",
+      "Write(./.claude/PROJECT-PLAN.json)"
+    ],
+    "ask": [
+      "Edit(./package.json)",
+      "Edit(./tsconfig.json)",
+      "Edit(./jest.config.*)",
+      "Write(./config/**)"
+    ],
+    "deny": [
+      "Edit(**/*.md)",
+      "Write(**/*.md)",
+      "Edit(./docs/**)",
+      "Write(./docs/**)",
+      "Edit(./README.md)",
+      "Edit(./CHANGELOG.md)",
+      "Edit(./.env*)",
+      "Write(./.env*)",
+      "Edit(./.claude/PROJECT-PLAN.json)",
+      "Edit(./.claude/settings.json)",
+      "Edit(./.claude/hooks/**)",
+      "Write(./.claude/hooks/**)",
+      "Edit(./.claude/CLAUDE.md)",
+      "Edit(./.claude/TASK-TRACKER.json)",
+      "Bash(curl*)",
+      "Bash(wget*)",
+      "Bash(rm -rf*)",
+      "Bash(sudo*)",
+      "Bash(npm install*)",
+      "Bash(npm publish*)",
+      "Bash(git push --force*)",
+      "Bash(git merge*)",
+      "Bash(psql*)",
+      "Bash(mysql*)",
+      "Bash(sqlite3*)",
+      "Bash(mongosh*)",
+      "Bash(redis-cli*)",
+      "Bash(node ./scripts/**)",
+      "Bash(node ./Agent/db/**)",
+      "Bash(bash ./scripts/**)",
+      "Bash(sh ./scripts/**)",
+      "Bash(git checkout -b *)",
+      "WebFetch",
+      "WebSearch"
+    ]
+  },
+  "sandbox": {
+    "enabled": true,
+    "autoAllowBashIfSandboxed": true,
+    "allowUnsandboxedCommands": false
+  },
+  "env": {
+    "DISABLE_PROMPT_CACHING": "0",
+    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
+    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
+  },
+  "testing": {
+    "ui": {
+      "strictMode": true,
+      "requireTestFile": true,
+      "requireImport": true,
+      "requireRender": true,
+      "requireProps": true,
+      "requireEventTests": true,
+      "requireApiMocking": true,
+      "requireStateTests": true,
+      "requireFormTests": true,
+      "requireConditionalTests": true,
+      "requireIntegrationSite": true,
+      "integrationSiteDir": "test-site",
+      "conditionalThreshold": 3,
+      "requireVisualCheck": true,
+      "requireContract": false,
+      "comment": "⚠️  ALL UI testing requirements are HARD REQUIREMENTS (cannot be disabled). Commits will be blocked if any requirement is violated."
+    },
+    "visual": {
+      "enabled": true,
+      "strictMode": false,
+      "autoApprove": false,
+      "requireBaseline": true,
+      "pixelMatchThreshold": 0.1,
+      "diffThreshold": 1.0,
+      "browsers": ["chromium"],
+      "viewports": [
+        {
+          "name": "desktop",
+          "width": 1920,
+          "height": 1080,
+          "deviceScaleFactor": 1
+        },
+        {
+          "name": "tablet",
+          "width": 768,
+          "height": 1024,
+          "deviceScaleFactor": 2
+        },
+        {
+          "name": "mobile",
+          "width": 375,
+          "height": 667,
+          "deviceScaleFactor": 2
+        }
+      ],
+      "excludePatterns": [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**"
+      ],
+      "baselineDir": ".claude/visual-baselines",
+      "diffDir": ".claude/visual-diffs",
+      "tempDir": ".claude/visual-temp",
+      "comment": "Visual regression testing configuration. Triggers on UI component changes (.tsx, .jsx, .vue, .svelte). Set enabled:false to disable."
+    }
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/session-start-context.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/detect-pending-reviews.js"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-hard-requirements.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/prevent-read-bypass.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-plan-template.js"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-git-workflow.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-task-completion.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/auto-format.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-syntax.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-runtime.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-visual-native.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-component-contract.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-quality.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-integration.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-integration-site.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-database-changes.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-migration-impact.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-visual-regression.js"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-results.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/validate-e2e-coverage.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-test-pyramid.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-migration-workflow.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.gitignore

@@ -0,0 +1,14 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+.env
+.env.local
+*.tgz
+
+# Claude Code local settings
+.claude/settings.local.json
+
+# Build artifacts
+build/
+coverage/

package/templates/Agent/.gitkeep

@@ -0,0 +1,3 @@
+# Agent Directory
+# Your source code, tests, and database files go here
+# Edit files in this directory as part of your tasks

package/templates/README.md

@@ -0,0 +1,76 @@
+# {{PROJECT_NAME}}
+
+Project initialized with [Agentic15 Claude Code Framework](https://github.com/ajayhanda/agentic15-claude-zen)
+
+## Structured Development Workflow
+
+This project uses the Claude Code enforcement framework for task-based development with built-in guardrails.
+
+### Quick Start
+
+1. **Create a project plan:**
+   ```bash
+   npm run plan:create
+   ```
+
+2. **Initialize the plan:**
+   ```bash
+   npm run plan:init
+   ```
+
+3. **Start the next available task (recommended):**
+   ```bash
+   npm run task:next
+   ```
+
+   Or manually start a specific task:
+   ```bash
+   npm run task:start TASK-001
+   ```
+
+4. **Check task status:**
+   ```bash
+   npm run task:status
+   ```
+
+5. **Complete a task:**
+   ```bash
+   npm run task:done TASK-001
+   ```
+
+### Available Commands
+
+- `npm run help` - Show all available commands
+- `npm run plan:create` - Create a new project plan
+- `npm run plan:init` - Initialize and lock the plan
+- `npm run plan:manager` - Manage plans (switch, archive, delete)
+- `npm run plan:amend` - Amend locked plan with audit trail
+- `npm run task:next` - Start next available task (auto-picks based on dependencies)
+- `npm run task:start TASK-XXX` - Start a specific task
+- `npm run task:done TASK-XXX` - Complete a task
+- `npm run task:status` - View task status
+- `npm run task:merge TASK-XXX` - Merge completed task to main
+
+### Framework Features
+
+- **Task-Based Development** - Structured workflow with dependencies
+- **Git Workflow Enforcement** - Automatic branch management
+- **Pre-commit Hooks** - Code quality and test validation
+- **Project Plan Management** - Hierarchical plans with milestones
+- **Task Tracking** - Automatic progress tracking and time estimates
+
+### Documentation
+
+Configuration files are in [.claude/](.claude/):
+- `CLAUDE.md` - Complete framework documentation
+- `settings.json` - Permissions and hook configuration
+- `PLAN-SCHEMA.json` - Project plan schema
+- `PROJECT-PLAN-TEMPLATE.json` - Plan template
+
+### Framework Updates
+
+See the [agentic15-claude-zen CHANGELOG](https://github.com/ajayhanda/agentic15-claude-zen/blob/main/create-agentic15-claude-zen/CHANGELOG.md) for framework version history and breaking changes.
+
+## Development
+
+Your code goes here!

package/templates/__mocks__/fileMock.js

@@ -0,0 +1,9 @@
+/**
+ * Mock for static assets (images, fonts, etc.)
+ * Used by Jest to handle imports of non-JS files
+ *
+ * @version 1.4.4
+ * @package agentic15-claude-zen
+ */
+
+module.exports = 'test-file-stub';

package/templates/jest.config.js

@@ -0,0 +1,48 @@
+/**
+ * Jest Configuration
+ * Framework-agnostic configuration supporting React, Vue, Angular, Svelte
+ *
+ * @version 1.4.4
+ * @package agentic15-claude-zen
+ */
+
+module.exports = {
+  // Use jsdom for DOM testing (React, Vue, Svelte, Angular)
+  testEnvironment: 'jsdom',
+
+  // Transform JS/JSX/TS/TSX files with babel-jest
+  transform: {
+    '^.+\\.(js|jsx|ts|tsx)$': 'babel-jest',
+  },
+
+  // Support JS, JSX, TS, TSX file extensions
+  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx', 'json'],
+
+  // Find test files in tests/ directory
+  testMatch: [
+    '**/tests/**/*.test.{js,jsx,ts,tsx}',
+    '**/tests/**/*.spec.{js,jsx,ts,tsx}',
+  ],
+
+  // Coverage collection
+  collectCoverageFrom: [
+    'Agent/src/**/*.{js,jsx,ts,tsx}',
+    '!Agent/src/**/*.d.ts',
+    '!Agent/src/index.{js,ts}',
+  ],
+
+  // Setup files for different frameworks
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
+
+  // Module name mapper for CSS/asset imports
+  moduleNameMapper: {
+    '\\.(css|less|scss|sass)$': 'identity-obj-proxy',
+    '\\.(jpg|jpeg|png|gif|svg)$': '<rootDir>/__mocks__/fileMock.js',
+  },
+
+  // Ignore patterns
+  testPathIgnorePatterns: ['/node_modules/', '/test-site/'],
+
+  // Verbose output
+  verbose: true,
+};

package/templates/jest.setup.js

@@ -0,0 +1,13 @@
+/**
+ * Jest Setup File
+ * Configures testing environment for UI components
+ *
+ * @version 1.4.4
+ * @package agentic15-claude-zen
+ */
+
+// Import jest-dom matchers for better assertions
+import '@testing-library/jest-dom';
+
+// Suppress console errors during tests (optional)
+// global.console.error = jest.fn();

package/templates/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "description": "Project with Claude Code structured development framework",
+  "type": "commonjs",
+  "scripts": {
+    "test": "jest",
+    "help": "node node_modules/.agentic15-claude-zen/scripts/help.js",
+    "plan:generate": "node node_modules/.agentic15-claude-zen/scripts/plan-generate.js",
+    "plan:create": "node node_modules/.agentic15-claude-zen/scripts/plan-create.js",
+    "plan:init": "node node_modules/.agentic15-claude-zen/scripts/plan-init.js",
+    "plan:manager": "node node_modules/.agentic15-claude-zen/scripts/plan-manager.js",
+    "plan:amend": "node node_modules/.agentic15-claude-zen/scripts/plan-amend.js",
+    "plan:help": "node node_modules/.agentic15-claude-zen/scripts/plan-help.js",
+    "task:start": "node node_modules/.agentic15-claude-zen/scripts/task-start.js",
+    "task:done": "node node_modules/.agentic15-claude-zen/scripts/task-done.js",
+    "task:next": "node node_modules/.agentic15-claude-zen/scripts/task-next.js",
+    "task:status": "node node_modules/.agentic15-claude-zen/scripts/task-status.js",
+    "task:merge": "node node_modules/.agentic15-claude-zen/scripts/task-merge.js",
+    "setup:git-hooks": "node node_modules/.agentic15-claude-zen/scripts/setup-git-hooks.js"
+  },
+  "keywords": [
+    "claude-code",
+    "structured-development",
+    "task-tracking"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "jest": "^30.2.0",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/user-event": "^14.5.2",
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-react": "^7.26.3",
+    "babel-jest": "^30.0.0",
+    "jest-environment-jsdom": "^30.0.0",
+    "prop-types": "^15.8.1",
+    "identity-obj-proxy": "^3.0.0"
+  }
+}

package/templates/scripts/.gitkeep

@@ -0,0 +1,3 @@
+# Scripts Directory
+# Your custom scripts go here (build, deploy, utilities, etc.)
+# Claude can write scripts here, human executes them