gl-life-claude-zen 1.0.0

package/templates/.claude/PLAN-SCHEMA.json

@@ -0,0 +1,240 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Project Plan Schema",
+  "description": "Hierarchical project plan with SDLC state machine",
+  "type": "object",
+  "required": ["version", "project"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "2.0",
+      "description": "Schema version"
+    },
+    "project": {
+      "type": "object",
+      "required": ["id", "name", "description", "status", "subprojects"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^PROJ-[0-9]{3}$"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["planning", "active", "on-hold", "completed", "cancelled"]
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "createdBy": {
+          "type": "string"
+        },
+        "locked": {
+          "type": "boolean"
+        },
+        "lockedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "subprojects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/subproject"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "subproject": {
+      "type": "object",
+      "required": ["id", "name", "description", "status", "milestones"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^SUB-[0-9]{3}$"
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "active", "on-hold", "completed", "cancelled"]
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^SUB-[0-9]{3}$"
+          }
+        },
+        "milestones": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/milestone"
+          }
+        }
+      }
+    },
+    "milestone": {
+      "type": "object",
+      "required": ["id", "name", "description", "status", "tasks"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^MILE-[0-9]{3}$"
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "active", "completed"]
+        },
+        "dueDate": {
+          "type": "string",
+          "format": "date"
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^MILE-[0-9]{3}$"
+          }
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/task"
+          }
+        }
+      }
+    },
+    "task": {
+      "type": "object",
+      "required": ["id", "title", "status", "phase"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^TASK-[0-9]{3}$"
+        },
+        "title": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "in_progress", "blocked", "review", "testing", "completed", "cancelled"]
+        },
+        "phase": {
+          "type": "string",
+          "enum": ["requirements", "design", "implementation", "testing", "deployment", "maintenance"],
+          "description": "SDLC phase"
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^TASK-[0-9]{3}$"
+          }
+        },
+        "assignee": {
+          "type": "string"
+        },
+        "estimatedHours": {
+          "type": "number",
+          "minimum": 0
+        },
+        "actualHours": {
+          "type": "number",
+          "minimum": 0
+        },
+        "completionCriteria": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "testCases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "artifacts": {
+          "type": "object",
+          "properties": {
+            "design": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "code": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "tests": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "documentation": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "completedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "blockedReason": {
+          "type": "string"
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "timestamp": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "author": {
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/.claude/PROJECT-PLAN-TEMPLATE.json

@@ -0,0 +1,223 @@
+{
+  "version": "2.0",
+  "project": {
+    "id": "PROJ-001",
+    "name": "E-commerce Platform",
+    "description": "Full-featured online store with payment processing",
+    "status": "planning",
+    "createdAt": "2025-12-18T00:00:00.000Z",
+    "createdBy": "human",
+    "locked": false,
+    "subprojects": [
+      {
+        "id": "SUB-001",
+        "name": "User Management System",
+        "description": "Authentication, authorization, and user profiles",
+        "status": "pending",
+        "dependencies": [],
+        "milestones": [
+          {
+            "id": "MILE-001",
+            "name": "Core Authentication",
+            "description": "Basic login/logout functionality",
+            "status": "pending",
+            "dependencies": [],
+            "tasks": [
+              {
+                "id": "TASK-001",
+                "title": "Design user database schema",
+                "description": "Create ERD for users, roles, sessions",
+                "status": "pending",
+                "phase": "design",
+                "dependencies": [],
+                "estimatedHours": 4,
+                "completionCriteria": [
+                  "ERD diagram completed",
+                  "Schema reviewed by team",
+                  "Migration scripts ready"
+                ],
+                "artifacts": {
+                  "design": ["./Agent/db/schema/users.sql"],
+                  "code": [],
+                  "tests": [],
+                  "documentation": ["./docs/database-design.md"]
+                }
+              },
+              {
+                "id": "TASK-002",
+                "title": "Implement user registration API",
+                "description": "POST /api/auth/register endpoint",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-001"],
+                "estimatedHours": 6,
+                "completionCriteria": [
+                  "Email validation implemented",
+                  "Password hashing with bcrypt",
+                  "Duplicate email check",
+                  "Returns JWT token"
+                ],
+                "testCases": [
+                  "Valid registration succeeds",
+                  "Invalid email rejected",
+                  "Weak password rejected",
+                  "Duplicate email rejected"
+                ],
+                "artifacts": {
+                  "design": [],
+                  "code": [
+                    "./Agent/src/controllers/authController.js",
+                    "./Agent/src/services/userService.js"
+                  ],
+                  "tests": ["./Agent/tests/auth.test.js"],
+                  "documentation": []
+                }
+              },
+              {
+                "id": "TASK-003",
+                "title": "Write unit tests for registration",
+                "description": "Test all registration edge cases",
+                "status": "pending",
+                "phase": "testing",
+                "dependencies": ["TASK-002"],
+                "estimatedHours": 3,
+                "completionCriteria": [
+                  "100% code coverage for registration",
+                  "All edge cases tested",
+                  "Integration tests pass"
+                ],
+                "artifacts": {
+                  "code": [],
+                  "tests": [
+                    "./Agent/tests/auth.test.js",
+                    "./Agent/tests/integration/register.test.js"
+                  ]
+                }
+              }
+            ]
+          },
+          {
+            "id": "MILE-002",
+            "name": "User Profile Management",
+            "description": "Profile viewing and editing",
+            "status": "pending",
+            "dependencies": ["MILE-001"],
+            "tasks": [
+              {
+                "id": "TASK-004",
+                "title": "Create profile update API",
+                "description": "PATCH /api/users/:id endpoint",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-003"],
+                "estimatedHours": 5,
+                "completionCriteria": [
+                  "Can update name, email, avatar",
+                  "Email uniqueness validated",
+                  "Authorization checked"
+                ],
+                "artifacts": {
+                  "code": ["./Agent/src/controllers/userController.js"],
+                  "tests": ["./Agent/tests/userProfile.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "id": "SUB-002",
+        "name": "Product Catalog System",
+        "description": "Product listings, search, and categories",
+        "status": "pending",
+        "dependencies": [],
+        "milestones": [
+          {
+            "id": "MILE-003",
+            "name": "Basic Product CRUD",
+            "description": "Create, read, update, delete products",
+            "status": "pending",
+            "dependencies": [],
+            "tasks": [
+              {
+                "id": "TASK-005",
+                "title": "Design product database schema",
+                "description": "Tables for products, categories, images",
+                "status": "pending",
+                "phase": "design",
+                "dependencies": [],
+                "estimatedHours": 3,
+                "completionCriteria": [
+                  "Schema supports multiple categories",
+                  "Image URLs stored properly",
+                  "Price and inventory tracked"
+                ],
+                "artifacts": {
+                  "design": ["./Agent/db/schema/products.sql"]
+                }
+              },
+              {
+                "id": "TASK-006",
+                "title": "Implement product listing API",
+                "description": "GET /api/products with pagination",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-005"],
+                "estimatedHours": 4,
+                "completionCriteria": [
+                  "Pagination works (limit/offset)",
+                  "Filtering by category",
+                  "Sorting by price, name, date"
+                ],
+                "artifacts": {
+                  "code": ["./Agent/src/controllers/productController.js"],
+                  "tests": ["./Agent/tests/products.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "id": "SUB-003",
+        "name": "Shopping Cart & Checkout",
+        "description": "Cart management and order processing",
+        "status": "pending",
+        "dependencies": ["SUB-001", "SUB-002"],
+        "milestones": [
+          {
+            "id": "MILE-004",
+            "name": "Shopping Cart",
+            "description": "Add/remove/update cart items",
+            "status": "pending",
+            "dependencies": ["MILE-001", "MILE-003"],
+            "tasks": [
+              {
+                "id": "TASK-007",
+                "title": "Implement cart management",
+                "description": "Session-based cart for guests, DB for users",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-002", "TASK-006"],
+                "estimatedHours": 8,
+                "completionCriteria": [
+                  "Add items to cart",
+                  "Update quantities",
+                  "Calculate totals",
+                  "Persist cart for logged-in users"
+                ],
+                "artifacts": {
+                  "code": [
+                    "./Agent/src/services/cartService.js",
+                    "./Agent/src/controllers/cartController.js"
+                  ],
+                  "tests": ["./Agent/tests/cart.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.claude/settings.json

@@ -0,0 +1,157 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(**)",
+      "Glob",
+      "Grep",
+      "Bash(npm run *)",
+      "Bash(git status*)",
+      "Bash(git log*)",
+      "Bash(git diff*)",
+      "Bash(git branch*)",
+      "Bash(git checkout -b feature/*)",
+      "Bash(git checkout -b bugfix/*)",
+      "Bash(git checkout -b hotfix/*)",
+      "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 checkout main*)",
+      "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/**)",
+      "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"
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '=== Context Loaded ===' && git rev-parse --abbrev-ref HEAD 2>/dev/null && echo 'Current branch' || echo 'Not in git repo'"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-git-workflow.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-task-completion.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/enforce-structured-development.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/auto-format.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-test-quality.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-ui-integration.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-database-changes.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-migration-impact.js"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-test-results.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/validate-e2e-coverage.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/enforce-test-pyramid.js"
+          },
+          {
+            "type": "command",
+            "command": "node node_modules/.gl-life-claude/hooks/enforce-migration-workflow.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/README.md

@@ -0,0 +1,72 @@
+# {{PROJECT_NAME}}
+
+Project initialized with [GL.Life Claude Code Framework](https://github.com/ajayhanda/gl-life-claude)
+
+## 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
+
+## Development
+
+Your code goes here!