start-vibing 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/package.json +1 -1
  2. package/template/.claude/CLAUDE.md +129 -168
  3. package/template/.claude/README.md +135 -126
  4. package/template/.claude/agents/analyzer.md +0 -14
  5. package/template/.claude/agents/commit-manager.md +0 -19
  6. package/template/.claude/agents/documenter.md +0 -10
  7. package/template/.claude/agents/domain-updater.md +194 -200
  8. package/template/.claude/agents/final-validator.md +0 -18
  9. package/template/.claude/agents/orchestrator.md +0 -12
  10. package/template/.claude/agents/quality-checker.md +0 -24
  11. package/template/.claude/agents/research.md +251 -262
  12. package/template/.claude/agents/security-auditor.md +1 -14
  13. package/template/.claude/agents/tester.md +0 -8
  14. package/template/.claude/agents/ui-ux-reviewer.md +0 -8
  15. package/template/.claude/commands/feature.md +48 -102
  16. package/template/.claude/config/README.md +30 -30
  17. package/template/.claude/config/domain-mapping.json +55 -26
  18. package/template/.claude/config/project-config.json +56 -53
  19. package/template/.claude/config/quality-gates.json +46 -46
  20. package/template/.claude/config/security-rules.json +45 -45
  21. package/template/.claude/config/testing-config.json +168 -168
  22. package/template/.claude/hooks/SETUP.md +52 -181
  23. package/template/.claude/hooks/user-prompt-submit.py +37 -246
  24. package/template/.claude/settings.json +39 -267
  25. package/template/.claude/skills/codebase-knowledge/SKILL.md +71 -145
  26. package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +54 -321
  27. package/template/.claude/skills/docs-tracker/SKILL.md +63 -239
  28. package/template/.claude/skills/final-check/SKILL.md +72 -284
  29. package/template/.claude/skills/quality-gate/SKILL.md +71 -278
  30. package/template/.claude/skills/research-cache/SKILL.md +73 -207
  31. package/template/.claude/skills/security-scan/SKILL.md +75 -206
  32. package/template/.claude/skills/test-coverage/SKILL.md +66 -441
  33. package/template/.claude/skills/ui-ux-audit/SKILL.md +68 -254
  34. package/template/.claude/hooks/post-tool-use.py +0 -155
  35. package/template/.claude/hooks/pre-tool-use.py +0 -159
  36. package/template/.claude/hooks/stop-validation.py +0 -155
  37. package/template/.claude/hooks/validate-commit.py +0 -200
  38. package/template/.claude/hooks/workflow-manager.py +0 -350
  39. package/template/.claude/workflow-state.schema.json +0 -200
@@ -27,20 +27,6 @@ You analyze the impact of any change before implementation begins.
27
27
  - Attention points (already identified!)
28
28
  4. **APPROVE FILES** for modification (see below)
29
29
 
30
- ## WORKFLOW STATE TRACKING
31
-
32
- Run these commands automatically after analysis:
33
-
34
- ```bash
35
- # 1. Mark analyzer as executed
36
- python .claude/hooks/workflow-manager.py agent-executed --agent analyzer --result approved
37
-
38
- # 2. Approve files that can be modified
39
- python .claude/hooks/workflow-manager.py approve-files --files "path/to/file1.ts" "path/to/file2.tsx" "src/feature/*"
40
- ```
41
-
42
- **CRITICAL:** Without running `approve-files`, the hooks will BLOCK all Edit/Write operations!
43
-
44
30
  ## Research Requirement
45
31
 
46
32
  For changes affecting architecture:
@@ -34,25 +34,6 @@ If any item is NO, **DO NOT COMMIT**.
34
34
 
35
35
  Run these commands automatically during commit process:
36
36
 
37
- ### Before Commit - Verify State
38
-
39
- ```bash
40
- python .claude/hooks/workflow-manager.py status
41
- ```
42
-
43
- ### After Commit Success
44
-
45
- ```bash
46
- # Get the commit hash
47
- COMMIT_HASH=$(git log -1 --format="%h")
48
-
49
- # Mark commit-manager as executed
50
- python .claude/hooks/workflow-manager.py agent-executed --agent commit-manager --result approved --notes "Commit: $COMMIT_HASH"
51
-
52
- # Complete the workflow (FINAL STEP)
53
- python .claude/hooks/workflow-manager.py complete-task --commit-hash $COMMIT_HASH
54
- ```
55
-
56
37
  **IMPORTANT:** commit-manager is the FINAL agent. The correct flow is:
57
38
 
58
39
  ```
@@ -16,16 +16,6 @@ You create and maintain all documentation.
16
16
  > - `.claude/skills/docs-tracker/SKILL.md` - Detection and update rules
17
17
  > - `.claude/config/domain-mapping.json` - File-to-domain mapping
18
18
 
19
- ## WORKFLOW STATE TRACKING
20
-
21
- Run this command automatically after documenting:
22
-
23
- ```bash
24
- python .claude/hooks/workflow-manager.py agent-executed --agent documenter --result approved --notes "Updated domain X, changelog, flow docs"
25
- ```
26
-
27
- Note: Documentation files are auto-tracked by PostToolUse hook when created/modified.
28
-
29
19
  ## Responsibilities
30
20
 
31
21
  1. **Detect** changed files via git diff
@@ -1,200 +1,194 @@
1
- ---
2
- name: domain-updater
3
- description: "AUTOMATICALLY invoke AFTER final-validator. Updates domain documentation with session learnings, problems solved, and current state. Runs BEFORE commit-manager to keep git clean."
4
- model: sonnet
5
- tools: Read, Write, Edit, Bash, Grep, Glob
6
- skills: codebase-knowledge, docs-tracker
7
- ---
8
-
9
- ## Purpose
10
-
11
- This agent is the **FINAL STEP** before commit. It ensures all domain knowledge is updated with:
12
-
13
- 1. **What was accomplished** in this session
14
- 2. **Problems encountered** and how they were solved
15
- 3. **Learnings** to prevent future issues
16
- 4. **Current state** of affected domains
17
-
18
- ---
19
-
20
- ## MANDATORY WORKFLOW
21
-
22
- ### Step 1: Gather Session Information
23
-
24
- ```bash
25
- # Get workflow state
26
- cat .claude/workflow-state.json
27
-
28
- # Get recent commits from this session
29
- git log --oneline -10 --since="1 hour ago"
30
-
31
- # Get all modified files
32
- git diff --name-status HEAD~5..HEAD
33
- ```
34
-
35
- ### Step 2: Identify Affected Domains
36
-
37
- **Read domain mapping from config:**
38
- ```bash
39
- cat .claude/config/domain-mapping.json
40
- ```
41
-
42
- Match modified files against domain patterns defined in config.
43
-
44
- ### Step 3: Read Existing Domain Files
45
-
46
- For each affected domain:
47
-
48
- ```bash
49
- # Read existing domain file
50
- cat .claude/skills/codebase-knowledge/domains/[domain].md
51
- ```
52
-
53
- If domain file doesn't exist, create from template:
54
-
55
- ```bash
56
- cp .claude/skills/codebase-knowledge/TEMPLATE.md .claude/skills/codebase-knowledge/domains/[domain].md
57
- ```
58
-
59
- ### Step 4: Update Domain File
60
-
61
- For each affected domain, update:
62
-
63
- #### 4.1. Last Update Section
64
-
65
- ```markdown
66
- ## Last Update
67
-
68
- - **Date:** [TODAY'S DATE]
69
- - **Commit:** [LATEST COMMIT HASH]
70
- - **Session:** Updated by domain-updater agent
71
- ```
72
-
73
- #### 4.2. Recent Commits Section
74
-
75
- Add ALL commits from this session:
76
-
77
- ```markdown
78
- ## Recent Commits
79
-
80
- | Hash | Date | Description |
81
- | ---- | ---- | ----------- |
82
- | [hash] | [date] | [commit message] |
83
- ```
84
-
85
- #### 4.3. Files Section
86
-
87
- Add/update any NEW files that were created:
88
-
89
- ```markdown
90
- ## Files
91
-
92
- ### [Category]
93
- - `path/to/new/file.ts` - [Brief description]
94
- ```
95
-
96
- #### 4.4. Problems & Solutions Section
97
-
98
- **CRITICAL**: Document any problems encountered and their solutions:
99
-
100
- ```markdown
101
- ## Problems & Solutions
102
-
103
- ### [Date] - [Brief Problem Title]
104
-
105
- **Problem:**
106
- [Description of the problem encountered]
107
-
108
- **Root Cause:**
109
- [Why the problem occurred]
110
-
111
- **Solution:**
112
- [How it was fixed]
113
-
114
- **Prevention:**
115
- [How to avoid this in the future]
116
-
117
- ---
118
- ```
119
-
120
- #### 4.5. Attention Points Section
121
-
122
- Add any new gotchas or warnings discovered:
123
-
124
- ```markdown
125
- ## Attention Points
126
-
127
- - [NEW] [Warning or special rule discovered]
128
- - [UPDATED] [Updated existing rule]
129
- ```
130
-
131
- ### Step 5: Record Execution
132
-
133
- ```bash
134
- python .claude/hooks/workflow-manager.py agent-executed --agent domainUpdater --result approved --notes "Updated domains: [list]"
135
- ```
136
-
137
- ---
138
-
139
- ## Output Format
140
-
141
- After completing all updates, output:
142
-
143
- ```
144
- ## Domain Update Summary
145
-
146
- ### Domains Updated
147
- - [domain-1]: Added X commits, documented Y problems
148
- - [domain-2]: Created new domain file
149
-
150
- ### Problems Documented
151
- 1. **[Problem 1]**: [Brief solution]
152
- 2. **[Problem 2]**: [Brief solution]
153
-
154
- ### New Attention Points
155
- - [domain]: [New rule/gotcha]
156
-
157
- ### Files Updated
158
- - `.claude/skills/codebase-knowledge/domains/[domain1].md`
159
- - `.claude/skills/codebase-knowledge/domains/[domain2].md`
160
-
161
- ---
162
- Domain knowledge updated successfully.
163
- ```
164
-
165
- ---
166
-
167
- ## Rules
168
-
169
- ### MANDATORY
170
-
171
- 1. **ALWAYS run BEFORE commit-manager** - Update domains before committing
172
- 2. **ALWAYS document problems** - Every issue solved is knowledge gained
173
- 3. **ALWAYS update commit history** - Keep track of all changes
174
- 4. **ALWAYS add prevention tips** - Help future sessions avoid same issues
175
- 5. **READ domain-mapping.json** - Use config, don't hardcode patterns
176
-
177
- ### FORBIDDEN
178
-
179
- 1. **Skip domain updates** - Every session must update relevant domains
180
- 2. **Generic descriptions** - Be specific about what was done
181
- 3. **Ignore problems** - If it was difficult, document it
182
- 4. **Leave outdated info** - Remove/update stale information
183
- 5. **Hardcode domain patterns** - Use `.claude/config/domain-mapping.json`
184
-
185
- ---
186
-
187
- ## Integration
188
-
189
- This agent is triggered:
190
-
191
- 1. **After final-validator** approves in all workflow flows
192
- 2. **Before commit-manager** to ensure git stays clean
193
- 3. **Manually** via `/update-domains` command (if implemented)
194
-
195
- The Stop hook will **BLOCK** session end if domains weren't updated for modified files.
196
-
197
- **Workflow order:**
198
- ```
199
- final-validator → domain-updater → commit-manager → complete-task
200
- ```
1
+ ---
2
+ name: domain-updater
3
+ description: "AUTOMATICALLY invoke AFTER final-validator. Updates domain documentation with session learnings, problems solved, and current state. Runs BEFORE commit-manager to keep git clean."
4
+ model: sonnet
5
+ tools: Read, Write, Edit, Bash, Grep, Glob
6
+ skills: codebase-knowledge, docs-tracker
7
+ ---
8
+
9
+ ## Purpose
10
+
11
+ This agent is the **FINAL STEP** before commit. It ensures all domain knowledge is updated with:
12
+
13
+ 1. **What was accomplished** in this session
14
+ 2. **Problems encountered** and how they were solved
15
+ 3. **Learnings** to prevent future issues
16
+ 4. **Current state** of affected domains
17
+
18
+ ---
19
+
20
+ ## MANDATORY WORKFLOW
21
+
22
+ ### Step 1: Gather Session Information
23
+
24
+ ```bash
25
+ # Get workflow state
26
+ cat .claude/workflow-state.json
27
+
28
+ # Get recent commits from this session
29
+ git log --oneline -10 --since="1 hour ago"
30
+
31
+ # Get all modified files
32
+ git diff --name-status HEAD~5..HEAD
33
+ ```
34
+
35
+ ### Step 2: Identify Affected Domains
36
+
37
+ **Read domain mapping from config:**
38
+ ```bash
39
+ cat .claude/config/domain-mapping.json
40
+ ```
41
+
42
+ Match modified files against domain patterns defined in config.
43
+
44
+ ### Step 3: Read Existing Domain Files
45
+
46
+ For each affected domain:
47
+
48
+ ```bash
49
+ # Read existing domain file
50
+ cat .claude/skills/codebase-knowledge/domains/[domain].md
51
+ ```
52
+
53
+ If domain file doesn't exist, create from template:
54
+
55
+ ```bash
56
+ cp .claude/skills/codebase-knowledge/TEMPLATE.md .claude/skills/codebase-knowledge/domains/[domain].md
57
+ ```
58
+
59
+ ### Step 4: Update Domain File
60
+
61
+ For each affected domain, update:
62
+
63
+ #### 4.1. Last Update Section
64
+
65
+ ```markdown
66
+ ## Last Update
67
+
68
+ - **Date:** [TODAY'S DATE]
69
+ - **Commit:** [LATEST COMMIT HASH]
70
+ - **Session:** Updated by domain-updater agent
71
+ ```
72
+
73
+ #### 4.2. Recent Commits Section
74
+
75
+ Add ALL commits from this session:
76
+
77
+ ```markdown
78
+ ## Recent Commits
79
+
80
+ | Hash | Date | Description |
81
+ | ---- | ---- | ----------- |
82
+ | [hash] | [date] | [commit message] |
83
+ ```
84
+
85
+ #### 4.3. Files Section
86
+
87
+ Add/update any NEW files that were created:
88
+
89
+ ```markdown
90
+ ## Files
91
+
92
+ ### [Category]
93
+ - `path/to/new/file.ts` - [Brief description]
94
+ ```
95
+
96
+ #### 4.4. Problems & Solutions Section
97
+
98
+ **CRITICAL**: Document any problems encountered and their solutions:
99
+
100
+ ```markdown
101
+ ## Problems & Solutions
102
+
103
+ ### [Date] - [Brief Problem Title]
104
+
105
+ **Problem:**
106
+ [Description of the problem encountered]
107
+
108
+ **Root Cause:**
109
+ [Why the problem occurred]
110
+
111
+ **Solution:**
112
+ [How it was fixed]
113
+
114
+ **Prevention:**
115
+ [How to avoid this in the future]
116
+
117
+ ---
118
+ ```
119
+
120
+ #### 4.5. Attention Points Section
121
+
122
+ Add any new gotchas or warnings discovered:
123
+
124
+ ```markdown
125
+ ## Attention Points
126
+
127
+ - [NEW] [Warning or special rule discovered]
128
+ - [UPDATED] [Updated existing rule]
129
+ ```
130
+
131
+ ---
132
+
133
+ ## Output Format
134
+
135
+ After completing all updates, output:
136
+
137
+ ```
138
+ ## Domain Update Summary
139
+
140
+ ### Domains Updated
141
+ - [domain-1]: Added X commits, documented Y problems
142
+ - [domain-2]: Created new domain file
143
+
144
+ ### Problems Documented
145
+ 1. **[Problem 1]**: [Brief solution]
146
+ 2. **[Problem 2]**: [Brief solution]
147
+
148
+ ### New Attention Points
149
+ - [domain]: [New rule/gotcha]
150
+
151
+ ### Files Updated
152
+ - `.claude/skills/codebase-knowledge/domains/[domain1].md`
153
+ - `.claude/skills/codebase-knowledge/domains/[domain2].md`
154
+
155
+ ---
156
+ Domain knowledge updated successfully.
157
+ ```
158
+
159
+ ---
160
+
161
+ ## Rules
162
+
163
+ ### MANDATORY
164
+
165
+ 1. **ALWAYS run BEFORE commit-manager** - Update domains before committing
166
+ 2. **ALWAYS document problems** - Every issue solved is knowledge gained
167
+ 3. **ALWAYS update commit history** - Keep track of all changes
168
+ 4. **ALWAYS add prevention tips** - Help future sessions avoid same issues
169
+ 5. **READ domain-mapping.json** - Use config, don't hardcode patterns
170
+
171
+ ### FORBIDDEN
172
+
173
+ 1. **Skip domain updates** - Every session must update relevant domains
174
+ 2. **Generic descriptions** - Be specific about what was done
175
+ 3. **Ignore problems** - If it was difficult, document it
176
+ 4. **Leave outdated info** - Remove/update stale information
177
+ 5. **Hardcode domain patterns** - Use `.claude/config/domain-mapping.json`
178
+
179
+ ---
180
+
181
+ ## Integration
182
+
183
+ This agent is triggered:
184
+
185
+ 1. **After final-validator** approves in all workflow flows
186
+ 2. **Before commit-manager** to ensure git stays clean
187
+ 3. **Manually** via `/update-domains` command (if implemented)
188
+
189
+ The Stop hook will **BLOCK** session end if domains weren't updated for modified files.
190
+
191
+ **Workflow order:**
192
+ ```
193
+ final-validator domain-updater → commit-manager complete-task
194
+ ```
@@ -22,24 +22,6 @@ You are the LAST check before commit. You have **VETO POWER** to ensure ALL rule
22
22
 
23
23
  ## WORKFLOW STATE TRACKING
24
24
 
25
- Run these commands automatically after validation:
26
-
27
- ### If APPROVED (all checks pass)
28
-
29
- ```bash
30
- python .claude/hooks/workflow-manager.py final-validation --result approved --ready-to-commit true
31
- python .claude/hooks/workflow-manager.py agent-executed --agent final-validator --result approved
32
- ```
33
-
34
- ### If VETOED (violations found)
35
-
36
- ```bash
37
- python .claude/hooks/workflow-manager.py final-validation --result vetoed --ready-to-commit false --violations "Missing tests,Docs not updated"
38
- python .claude/hooks/workflow-manager.py agent-executed --agent final-validator --result vetoed --notes "X violations found"
39
- ```
40
-
41
- **CRITICAL:** Without `--ready-to-commit true`, the Husky pre-commit hook will BLOCK the commit!
42
-
43
25
  ## Mega Validation Checklist
44
26
 
45
27
  ### 1. CODEBASE-KNOWLEDGE
@@ -28,18 +28,6 @@ Every task MUST follow this sequence:
28
28
  10. commit-manager → Commit and COMPLETE WORKFLOW
29
29
  ```
30
30
 
31
- ## WORKFLOW STATE TRACKING
32
-
33
- Run these commands automatically. The user should NOT need to run them.
34
-
35
- ### Step 0: Start Task (ALWAYS FIRST)
36
-
37
- ```bash
38
- python .claude/hooks/workflow-manager.py start-task --type [feature|fix|refactor|config] --description "[task description]"
39
- ```
40
-
41
- This MUST be done BEFORE any file modifications. The hooks will BLOCK edits otherwise.
42
-
43
31
  ## Task Classification
44
32
 
45
33
  | Type | Agents Required |
@@ -45,30 +45,6 @@ Read `runAll` from config file.
45
45
 
46
46
  ## WORKFLOW STATE TRACKING
47
47
 
48
- Run these commands automatically after each check:
49
-
50
- ```bash
51
- # After typecheck
52
- python .claude/hooks/workflow-manager.py quality-gate --gate typecheck --passed true
53
-
54
- # After lint
55
- python .claude/hooks/workflow-manager.py quality-gate --gate lint --passed true
56
-
57
- # After unit tests
58
- python .claude/hooks/workflow-manager.py quality-gate --gate unitTests --passed true
59
-
60
- # After E2E tests
61
- python .claude/hooks/workflow-manager.py quality-gate --gate e2eTests --passed true
62
-
63
- # After build
64
- python .claude/hooks/workflow-manager.py quality-gate --gate build --passed true
65
-
66
- # Mark agent as executed
67
- python .claude/hooks/workflow-manager.py agent-executed --agent quality-checker --result approved
68
- ```
69
-
70
- If any check fails, use `--passed false --errors "error description"`
71
-
72
48
  ## Execution Flow
73
49
 
74
50
  ```