start-vibing 1.1.2 → 1.1.4

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 (38) hide show
  1. package/package.json +1 -1
  2. package/template/.claude/CLAUDE.md +129 -168
  3. package/template/.claude/agents/analyzer.md +0 -14
  4. package/template/.claude/agents/commit-manager.md +0 -19
  5. package/template/.claude/agents/documenter.md +0 -10
  6. package/template/.claude/agents/domain-updater.md +194 -200
  7. package/template/.claude/agents/final-validator.md +0 -18
  8. package/template/.claude/agents/orchestrator.md +36 -34
  9. package/template/.claude/agents/quality-checker.md +0 -24
  10. package/template/.claude/agents/research.md +299 -262
  11. package/template/.claude/agents/security-auditor.md +1 -14
  12. package/template/.claude/agents/tester.md +0 -8
  13. package/template/.claude/agents/ui-ux-reviewer.md +80 -18
  14. package/template/.claude/commands/feature.md +48 -102
  15. package/template/.claude/config/README.md +30 -30
  16. package/template/.claude/config/project-config.json +53 -53
  17. package/template/.claude/config/quality-gates.json +46 -46
  18. package/template/.claude/config/security-rules.json +45 -45
  19. package/template/.claude/config/testing-config.json +168 -168
  20. package/template/.claude/hooks/SETUP.md +52 -181
  21. package/template/.claude/hooks/user-prompt-submit.py +184 -46
  22. package/template/.claude/settings.json +0 -39
  23. package/template/.claude/skills/codebase-knowledge/SKILL.md +145 -145
  24. package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +260 -321
  25. package/template/.claude/skills/docs-tracker/SKILL.md +239 -239
  26. package/template/.claude/skills/final-check/SKILL.md +284 -284
  27. package/template/.claude/skills/quality-gate/SKILL.md +278 -278
  28. package/template/.claude/skills/research-cache/SKILL.md +207 -207
  29. package/template/.claude/skills/security-scan/SKILL.md +206 -206
  30. package/template/.claude/skills/test-coverage/SKILL.md +441 -441
  31. package/template/.claude/skills/ui-ux-audit/SKILL.md +254 -254
  32. package/template/.claude/config/domain-mapping.json +0 -26
  33. package/template/.claude/hooks/post-tool-use.py +0 -155
  34. package/template/.claude/hooks/pre-tool-use.py +0 -159
  35. package/template/.claude/hooks/stop-validation.py +0 -155
  36. package/template/.claude/hooks/validate-commit.py +0 -200
  37. package/template/.claude/hooks/workflow-manager.py +0 -350
  38. package/template/.claude/workflow-state.schema.json +0 -200
@@ -1,239 +1,239 @@
1
- ---
2
- name: docs-tracker
3
- description: Automates documentation maintenance. Detects modified files via git diff, creates docs for new files, updates docs for modified files, generates changelog. Use after implementation to keep docs current.
4
- allowed-tools: Read, Glob, Grep, Bash
5
- ---
6
-
7
- # Docs Tracker - Automatic Documentation System
8
-
9
- ## Purpose
10
-
11
- This skill automates documentation maintenance:
12
-
13
- - **Detects** modified files via git diff
14
- - **Compares** with existing documentation
15
- - **Creates** docs for new files
16
- - **Updates** docs for modified files
17
- - **Removes** docs for deleted files
18
- - **Generates** automatic changelog
19
-
20
- ---
21
-
22
- ## Execution Flow
23
-
24
- ```
25
- 1. DETECT CHANGES → git diff --name-status
26
-
27
- 2. CLASSIFY CHANGES → A=Added, M=Modified, D=Deleted
28
-
29
- 3. CHECK EXISTING DOCS → docs/, codebase-knowledge/domains/
30
-
31
- 4. EXECUTE ACTIONS → Create, update, or remove docs
32
- ```
33
-
34
- ---
35
-
36
- ## Detection Commands
37
-
38
- ### Changes Since Last Commit
39
-
40
- ```bash
41
- git diff --name-status HEAD~1
42
- ```
43
-
44
- ### Changes vs Main
45
-
46
- ```bash
47
- git diff --name-status main..HEAD
48
- ```
49
-
50
- ### Added Files
51
-
52
- ```bash
53
- git diff --name-status main..HEAD | grep "^A"
54
- ```
55
-
56
- ### Modified Files
57
-
58
- ```bash
59
- git diff --name-status main..HEAD | grep "^M"
60
- ```
61
-
62
- ### Deleted Files
63
-
64
- ```bash
65
- git diff --name-status main..HEAD | grep "^D"
66
- ```
67
-
68
- ### Detailed File Diff
69
-
70
- ```bash
71
- git diff main..HEAD -- path/to/file.ts
72
- ```
73
-
74
- ---
75
-
76
- ## File → Doc Mapping
77
-
78
- | File Type | Related Documentation |
79
- | --------------------- | --------------------------------------------- |
80
- | `server/routers/*.ts` | `codebase-knowledge/domains/[domain].md` |
81
- | `server/models/*.ts` | `codebase-knowledge/domains/[domain].md` |
82
- | `app/**/page.tsx` | `docs/flows/[feature].md` |
83
- | `components/**/*.tsx` | `docs/components/[component].md` (if complex) |
84
- | `lib/**/*.ts` | `docs/utils/[lib].md` (if exported) |
85
-
86
- ---
87
-
88
- ## Update Rules
89
-
90
- ### CREATE Doc When:
91
-
92
- - [ ] New file in `server/routers/` → Update domain
93
- - [ ] New file in `server/models/` → Update domain
94
- - [ ] New page in `app/` → Create flow doc if complex
95
- - [ ] New complex component → Consider doc
96
-
97
- ### UPDATE Doc When:
98
-
99
- - [ ] tRPC procedure changed signature
100
- - [ ] Model changed schema
101
- - [ ] Page changed main flow
102
- - [ ] Connections between domains changed
103
-
104
- ### REMOVE Doc When:
105
-
106
- - [ ] File was deleted
107
- - [ ] Feature was completely removed
108
- - [ ] Component was discontinued
109
-
110
- ---
111
-
112
- ## Changelog Template
113
-
114
- ```markdown
115
- ## [Unreleased] - YYYY-MM-DD
116
-
117
- ### Added
118
-
119
- - New feature X in `path/to/file.ts`
120
- - New component Y
121
-
122
- ### Changed
123
-
124
- - Changed behavior of Z
125
- - Refactored module W
126
-
127
- ### Fixed
128
-
129
- - Fixed bug in A
130
- - Resolved issue #123
131
-
132
- ### Removed
133
-
134
- - Removed obsolete feature B
135
-
136
- ### Docs Updated
137
-
138
- - Updated `codebase-knowledge/domains/[domain].md`
139
- - Created `docs/flows/[feature].md`
140
- ```
141
-
142
- ---
143
-
144
- ## Pre-Commit Checklist
145
-
146
- ### 1. Detect Changes
147
-
148
- ```bash
149
- git diff --name-status --cached
150
- ```
151
-
152
- ### 2. For Each Modified File
153
-
154
- - [ ] Which domain does it belong to?
155
- - [ ] Is domain updated in `codebase-knowledge/domains/`?
156
- - [ ] Has flow doc in `docs/flows/`? Needs update?
157
- - [ ] Commit hash will be added to domain?
158
-
159
- ### 3. For Added Files
160
-
161
- - [ ] Which domain? Add to file list
162
- - [ ] Needs own doc or just update domain?
163
- - [ ] Connections with other domains?
164
-
165
- ### 4. For Deleted Files
166
-
167
- - [ ] Remove from `codebase-knowledge/domains/`
168
- - [ ] Remove flow doc if exists
169
- - [ ] Update connections in related domains
170
-
171
- ---
172
-
173
- ## Integration with Codebase-Knowledge
174
-
175
- ### Update Domain After Change
176
-
177
- ```markdown
178
- ## Domain Update: [name]
179
-
180
- ### Changes Detected
181
-
182
- | File | Status | Description |
183
- | ------------ | -------- | -------------- |
184
- | path/file.ts | Modified | [what changed] |
185
-
186
- ### Required Updates in domains/[domain].md
187
-
188
- - [ ] Update "Last Update" with date and commit
189
- - [ ] Add/remove files from list
190
- - [ ] Update "Recent Commits"
191
- - [ ] Check "Connections" if integration changed
192
- - [ ] Update "Attention Points" if applicable
193
- ```
194
-
195
- ---
196
-
197
- ## Output Format
198
-
199
- ```markdown
200
- ## DOCS TRACKER - Report
201
-
202
- ### Changes Detected
203
-
204
- - **Added:** X files
205
- - **Modified:** Y files
206
- - **Deleted:** Z files
207
-
208
- ### Docs That Need Update
209
-
210
- | Doc | Type | Action | Priority |
211
- | ---------------- | ------ | ------ | -------- |
212
- | domains/auth.md | domain | update | HIGH |
213
- | flows/feature.md | flow | create | MEDIUM |
214
-
215
- ### Actions Executed
216
-
217
- - [x] Updated `domains/auth.md` with commit abc123
218
- - [x] Created `flows/new-feature.md`
219
- - [x] Removed `flows/obsolete.md`
220
-
221
- ### Changelog Generated
222
-
223
- [changelog preview]
224
- ```
225
-
226
- ---
227
-
228
- ## Critical Rules
229
-
230
- 1. **ALWAYS run before commit** - Outdated docs are technical debt
231
- 2. **NEVER ignore new files** - Every file deserves documentation
232
- 3. **KEEP changelog updated** - Facilitates releases
233
- 4. **SYNC with codebase-knowledge** - It's the source of truth
234
-
235
- ---
236
-
237
- ## Version
238
-
239
- - **v2.0.0** - Generic template
1
+ ---
2
+ name: docs-tracker
3
+ description: Automates documentation maintenance. Detects modified files via git diff, creates docs for new files, updates docs for modified files, generates changelog. Use after implementation to keep docs current.
4
+ allowed-tools: Read, Glob, Grep, Bash
5
+ ---
6
+
7
+ # Docs Tracker - Automatic Documentation System
8
+
9
+ ## Purpose
10
+
11
+ This skill automates documentation maintenance:
12
+
13
+ - **Detects** modified files via git diff
14
+ - **Compares** with existing documentation
15
+ - **Creates** docs for new files
16
+ - **Updates** docs for modified files
17
+ - **Removes** docs for deleted files
18
+ - **Generates** automatic changelog
19
+
20
+ ---
21
+
22
+ ## Execution Flow
23
+
24
+ ```
25
+ 1. DETECT CHANGES → git diff --name-status
26
+
27
+ 2. CLASSIFY CHANGES → A=Added, M=Modified, D=Deleted
28
+
29
+ 3. CHECK EXISTING DOCS → docs/, codebase-knowledge/domains/
30
+
31
+ 4. EXECUTE ACTIONS → Create, update, or remove docs
32
+ ```
33
+
34
+ ---
35
+
36
+ ## Detection Commands
37
+
38
+ ### Changes Since Last Commit
39
+
40
+ ```bash
41
+ git diff --name-status HEAD~1
42
+ ```
43
+
44
+ ### Changes vs Main
45
+
46
+ ```bash
47
+ git diff --name-status main..HEAD
48
+ ```
49
+
50
+ ### Added Files
51
+
52
+ ```bash
53
+ git diff --name-status main..HEAD | grep "^A"
54
+ ```
55
+
56
+ ### Modified Files
57
+
58
+ ```bash
59
+ git diff --name-status main..HEAD | grep "^M"
60
+ ```
61
+
62
+ ### Deleted Files
63
+
64
+ ```bash
65
+ git diff --name-status main..HEAD | grep "^D"
66
+ ```
67
+
68
+ ### Detailed File Diff
69
+
70
+ ```bash
71
+ git diff main..HEAD -- path/to/file.ts
72
+ ```
73
+
74
+ ---
75
+
76
+ ## File → Doc Mapping
77
+
78
+ | File Type | Related Documentation |
79
+ | --------------------- | --------------------------------------------- |
80
+ | `server/routers/*.ts` | `codebase-knowledge/domains/[domain].md` |
81
+ | `server/models/*.ts` | `codebase-knowledge/domains/[domain].md` |
82
+ | `app/**/page.tsx` | `docs/flows/[feature].md` |
83
+ | `components/**/*.tsx` | `docs/components/[component].md` (if complex) |
84
+ | `lib/**/*.ts` | `docs/utils/[lib].md` (if exported) |
85
+
86
+ ---
87
+
88
+ ## Update Rules
89
+
90
+ ### CREATE Doc When:
91
+
92
+ - [ ] New file in `server/routers/` → Update domain
93
+ - [ ] New file in `server/models/` → Update domain
94
+ - [ ] New page in `app/` → Create flow doc if complex
95
+ - [ ] New complex component → Consider doc
96
+
97
+ ### UPDATE Doc When:
98
+
99
+ - [ ] tRPC procedure changed signature
100
+ - [ ] Model changed schema
101
+ - [ ] Page changed main flow
102
+ - [ ] Connections between domains changed
103
+
104
+ ### REMOVE Doc When:
105
+
106
+ - [ ] File was deleted
107
+ - [ ] Feature was completely removed
108
+ - [ ] Component was discontinued
109
+
110
+ ---
111
+
112
+ ## Changelog Template
113
+
114
+ ```markdown
115
+ ## [Unreleased] - YYYY-MM-DD
116
+
117
+ ### Added
118
+
119
+ - New feature X in `path/to/file.ts`
120
+ - New component Y
121
+
122
+ ### Changed
123
+
124
+ - Changed behavior of Z
125
+ - Refactored module W
126
+
127
+ ### Fixed
128
+
129
+ - Fixed bug in A
130
+ - Resolved issue #123
131
+
132
+ ### Removed
133
+
134
+ - Removed obsolete feature B
135
+
136
+ ### Docs Updated
137
+
138
+ - Updated `codebase-knowledge/domains/[domain].md`
139
+ - Created `docs/flows/[feature].md`
140
+ ```
141
+
142
+ ---
143
+
144
+ ## Pre-Commit Checklist
145
+
146
+ ### 1. Detect Changes
147
+
148
+ ```bash
149
+ git diff --name-status --cached
150
+ ```
151
+
152
+ ### 2. For Each Modified File
153
+
154
+ - [ ] Which domain does it belong to?
155
+ - [ ] Is domain updated in `codebase-knowledge/domains/`?
156
+ - [ ] Has flow doc in `docs/flows/`? Needs update?
157
+ - [ ] Commit hash will be added to domain?
158
+
159
+ ### 3. For Added Files
160
+
161
+ - [ ] Which domain? Add to file list
162
+ - [ ] Needs own doc or just update domain?
163
+ - [ ] Connections with other domains?
164
+
165
+ ### 4. For Deleted Files
166
+
167
+ - [ ] Remove from `codebase-knowledge/domains/`
168
+ - [ ] Remove flow doc if exists
169
+ - [ ] Update connections in related domains
170
+
171
+ ---
172
+
173
+ ## Integration with Codebase-Knowledge
174
+
175
+ ### Update Domain After Change
176
+
177
+ ```markdown
178
+ ## Domain Update: [name]
179
+
180
+ ### Changes Detected
181
+
182
+ | File | Status | Description |
183
+ | ------------ | -------- | -------------- |
184
+ | path/file.ts | Modified | [what changed] |
185
+
186
+ ### Required Updates in domains/[domain].md
187
+
188
+ - [ ] Update "Last Update" with date and commit
189
+ - [ ] Add/remove files from list
190
+ - [ ] Update "Recent Commits"
191
+ - [ ] Check "Connections" if integration changed
192
+ - [ ] Update "Attention Points" if applicable
193
+ ```
194
+
195
+ ---
196
+
197
+ ## Output Format
198
+
199
+ ```markdown
200
+ ## DOCS TRACKER - Report
201
+
202
+ ### Changes Detected
203
+
204
+ - **Added:** X files
205
+ - **Modified:** Y files
206
+ - **Deleted:** Z files
207
+
208
+ ### Docs That Need Update
209
+
210
+ | Doc | Type | Action | Priority |
211
+ | ---------------- | ------ | ------ | -------- |
212
+ | domains/auth.md | domain | update | HIGH |
213
+ | flows/feature.md | flow | create | MEDIUM |
214
+
215
+ ### Actions Executed
216
+
217
+ - [x] Updated `domains/auth.md` with commit abc123
218
+ - [x] Created `flows/new-feature.md`
219
+ - [x] Removed `flows/obsolete.md`
220
+
221
+ ### Changelog Generated
222
+
223
+ [changelog preview]
224
+ ```
225
+
226
+ ---
227
+
228
+ ## Critical Rules
229
+
230
+ 1. **ALWAYS run before commit** - Outdated docs are technical debt
231
+ 2. **NEVER ignore new files** - Every file deserves documentation
232
+ 3. **KEEP changelog updated** - Facilitates releases
233
+ 4. **SYNC with codebase-knowledge** - It's the source of truth
234
+
235
+ ---
236
+
237
+ ## Version
238
+
239
+ - **v2.0.0** - Generic template