start-vibing 1.1.1

package/template/.claude/workflow-state.schema.json

@@ -0,0 +1,200 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Claude Workflow State",
+	"description": "Tracks agent workflow execution state for enforcement",
+	"type": "object",
+	"required": ["version", "currentTask", "sessions"],
+	"properties": {
+		"version": {
+			"type": "string",
+			"description": "Schema version"
+		},
+		"currentTask": {
+			"oneOf": [{ "type": "null" }, { "$ref": "#/definitions/task" }],
+			"description": "Currently active task (null if no task in progress)"
+		},
+		"sessions": {
+			"type": "array",
+			"items": { "$ref": "#/definitions/session" },
+			"description": "History of completed sessions"
+		}
+	},
+	"definitions": {
+		"task": {
+			"type": "object",
+			"required": [
+				"id",
+				"type",
+				"description",
+				"startedAt",
+				"agents",
+				"approvedFiles",
+				"modifiedFiles"
+			],
+			"properties": {
+				"id": {
+					"type": "string",
+					"description": "Unique task ID (timestamp-based)"
+				},
+				"type": {
+					"type": "string",
+					"enum": ["feature", "fix", "refactor", "config", "research"],
+					"description": "Task classification"
+				},
+				"description": {
+					"type": "string",
+					"description": "Task description from user"
+				},
+				"startedAt": {
+					"type": "string",
+					"format": "date-time",
+					"description": "When task started"
+				},
+				"agents": {
+					"$ref": "#/definitions/agentExecution",
+					"description": "Track which agents have executed"
+				},
+				"approvedFiles": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Files approved for modification by analyzer"
+				},
+				"modifiedFiles": {
+					"type": "array",
+					"items": { "$ref": "#/definitions/fileModification" },
+					"description": "Files actually modified"
+				},
+				"testsCreated": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Test files created"
+				},
+				"docsUpdated": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Documentation files updated"
+				},
+				"qualityGates": {
+					"$ref": "#/definitions/qualityGates",
+					"description": "Quality gate results"
+				},
+				"securityAudit": {
+					"$ref": "#/definitions/securityAudit",
+					"description": "Security audit result"
+				},
+				"finalValidation": {
+					"$ref": "#/definitions/finalValidation",
+					"description": "Final validation result"
+				}
+			}
+		},
+		"agentExecution": {
+			"type": "object",
+			"properties": {
+				"orchestrator": { "$ref": "#/definitions/agentStatus" },
+				"analyzer": { "$ref": "#/definitions/agentStatus" },
+				"uiUxReviewer": { "$ref": "#/definitions/agentStatus" },
+				"documenter": { "$ref": "#/definitions/agentStatus" },
+				"tester": { "$ref": "#/definitions/agentStatus" },
+				"securityAuditor": { "$ref": "#/definitions/agentStatus" },
+				"qualityChecker": { "$ref": "#/definitions/agentStatus" },
+				"finalValidator": { "$ref": "#/definitions/agentStatus" },
+				"commitManager": { "$ref": "#/definitions/agentStatus" }
+			}
+		},
+		"agentStatus": {
+			"type": "object",
+			"required": ["executed"],
+			"properties": {
+				"executed": {
+					"type": "boolean",
+					"description": "Whether this agent has executed"
+				},
+				"executedAt": {
+					"type": "string",
+					"format": "date-time",
+					"description": "When executed"
+				},
+				"result": {
+					"type": "string",
+					"enum": ["pending", "approved", "vetoed", "skipped"],
+					"description": "Agent result"
+				},
+				"notes": {
+					"type": "string",
+					"description": "Any notes from execution"
+				}
+			}
+		},
+		"fileModification": {
+			"type": "object",
+			"required": ["path", "action", "timestamp"],
+			"properties": {
+				"path": {
+					"type": "string",
+					"description": "File path"
+				},
+				"action": {
+					"type": "string",
+					"enum": ["created", "modified", "deleted"],
+					"description": "Type of modification"
+				},
+				"timestamp": {
+					"type": "string",
+					"format": "date-time"
+				},
+				"approved": {
+					"type": "boolean",
+					"description": "Was this file in approvedFiles list?"
+				}
+			}
+		},
+		"qualityGates": {
+			"type": "object",
+			"properties": {
+				"typecheck": { "$ref": "#/definitions/gateResult" },
+				"lint": { "$ref": "#/definitions/gateResult" },
+				"unitTests": { "$ref": "#/definitions/gateResult" },
+				"e2eTests": { "$ref": "#/definitions/gateResult" },
+				"build": { "$ref": "#/definitions/gateResult" }
+			}
+		},
+		"gateResult": {
+			"type": "object",
+			"properties": {
+				"passed": { "type": "boolean" },
+				"executedAt": { "type": "string", "format": "date-time" },
+				"errors": { "type": "array", "items": { "type": "string" } }
+			}
+		},
+		"securityAudit": {
+			"type": "object",
+			"properties": {
+				"executed": { "type": "boolean" },
+				"executedAt": { "type": "string", "format": "date-time" },
+				"result": { "type": "string", "enum": ["approved", "vetoed"] },
+				"vulnerabilities": { "type": "array", "items": { "type": "string" } }
+			}
+		},
+		"finalValidation": {
+			"type": "object",
+			"properties": {
+				"executed": { "type": "boolean" },
+				"executedAt": { "type": "string", "format": "date-time" },
+				"result": { "type": "string", "enum": ["approved", "vetoed"] },
+				"violations": { "type": "array", "items": { "type": "string" } },
+				"readyToCommit": { "type": "boolean" }
+			}
+		},
+		"session": {
+			"type": "object",
+			"required": ["id", "task", "completedAt", "commitHash"],
+			"properties": {
+				"id": { "type": "string" },
+				"task": { "$ref": "#/definitions/task" },
+				"completedAt": { "type": "string", "format": "date-time" },
+				"commitHash": { "type": "string" }
+			}
+		}
+	}
+}

package/template/CLAUDE.md

@@ -0,0 +1,96 @@
+# Development Rules
+
+> **THESE RULES ARE MANDATORY. NO EXCEPTIONS.**
+
+---
+
+## Workflow
+
+```
+1. READ AGENTS    →  .claude/agents/*.md
+2. START TASK     →  python .claude/hooks/workflow-manager.py start-task --type feature --description "..."
+3. IMPLEMENT      →  Follow project rules
+4. QUALITY CHECK  →  Run all quality gates
+5. COMMIT         →  Conventional commits
+```
+
+---
+
+## Agent System
+
+This project uses 11 specialized AI agents:
+
+| Agent            | Purpose                           | Priority |
+| ---------------- | --------------------------------- | -------- |
+| orchestrator     | Coordinates entire workflow       | 1        |
+| analyzer         | Analyzes change impact            | 2        |
+| research         | Researches best practices         | 3        |
+| documenter       | Creates/updates documentation     | 3        |
+| tester           | Creates unit and E2E tests        | 4        |
+| security-auditor | Audits security (VETO POWER)      | 5        |
+| ui-ux-reviewer   | Reviews UI/UX patterns            | 6        |
+| quality-checker  | Runs quality gates                | 7        |
+| final-validator  | Final validation (VETO POWER)     | 8        |
+| domain-updater   | Updates domain knowledge          | 9        |
+| commit-manager   | Manages commits (FINAL step)      | 10       |
+
+---
+
+## Configuration
+
+Edit these files in `.claude/config/` for your project:
+
+| File                  | Purpose                    |
+| --------------------- | -------------------------- |
+| `project-config.json` | Stack, structure, commands |
+| `quality-gates.json`  | Quality check commands     |
+| `testing-config.json` | Test framework config      |
+| `security-rules.json` | Security audit rules       |
+
+---
+
+## Quick Start
+
+```bash
+# 1. Start a task
+python .claude/hooks/workflow-manager.py start-task --type feature --description "Add user authentication"
+
+# 2. Approve files for modification
+python .claude/hooks/workflow-manager.py approve-files --files "src/auth/*.ts"
+
+# 3. Mark agents as executed
+python .claude/hooks/workflow-manager.py agent-executed --agent analyzer --result approved
+
+# 4. Run quality gates
+python .claude/hooks/workflow-manager.py quality-gate --gate typecheck --passed true
+
+# 5. Final validation
+python .claude/hooks/workflow-manager.py final-validation --result approved --ready-to-commit true
+
+# 6. Complete task
+python .claude/hooks/workflow-manager.py complete-task --commit-hash abc123
+```
+
+---
+
+## Critical Rules
+
+1. **ALWAYS start task first** - Hooks block without active task
+2. **ALWAYS approve files** - Pre-tool-use hook blocks unapproved edits
+3. **NEVER skip agents** - Stop hook blocks incomplete workflows
+4. **ALWAYS use conventional commits** - feat:, fix:, refactor:, docs:
+
+---
+
+## Documentation
+
+- [Agent System](.claude/CLAUDE.md) - Full agent documentation
+- [Skills](.claude/skills/) - Available skills and templates
+- [Hooks](.claude/hooks/) - Workflow enforcement hooks
+
+---
+
+## Setup by start-vibing
+
+This project was set up with `npx start-vibing`.
+For updates: `npx start-vibing --force`