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.
- package/package.json +1 -1
- package/template/.claude/CLAUDE.md +129 -168
- package/template/.claude/agents/analyzer.md +0 -14
- package/template/.claude/agents/commit-manager.md +0 -19
- package/template/.claude/agents/documenter.md +0 -10
- package/template/.claude/agents/domain-updater.md +194 -200
- package/template/.claude/agents/final-validator.md +0 -18
- package/template/.claude/agents/orchestrator.md +36 -34
- package/template/.claude/agents/quality-checker.md +0 -24
- package/template/.claude/agents/research.md +299 -262
- package/template/.claude/agents/security-auditor.md +1 -14
- package/template/.claude/agents/tester.md +0 -8
- package/template/.claude/agents/ui-ux-reviewer.md +80 -18
- package/template/.claude/commands/feature.md +48 -102
- package/template/.claude/config/README.md +30 -30
- package/template/.claude/config/project-config.json +53 -53
- package/template/.claude/config/quality-gates.json +46 -46
- package/template/.claude/config/security-rules.json +45 -45
- package/template/.claude/config/testing-config.json +168 -168
- package/template/.claude/hooks/SETUP.md +52 -181
- package/template/.claude/hooks/user-prompt-submit.py +184 -46
- package/template/.claude/settings.json +0 -39
- package/template/.claude/skills/codebase-knowledge/SKILL.md +145 -145
- package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +260 -321
- package/template/.claude/skills/docs-tracker/SKILL.md +239 -239
- package/template/.claude/skills/final-check/SKILL.md +284 -284
- package/template/.claude/skills/quality-gate/SKILL.md +278 -278
- package/template/.claude/skills/research-cache/SKILL.md +207 -207
- package/template/.claude/skills/security-scan/SKILL.md +206 -206
- package/template/.claude/skills/test-coverage/SKILL.md +441 -441
- package/template/.claude/skills/ui-ux-audit/SKILL.md +254 -254
- package/template/.claude/config/domain-mapping.json +0 -26
- package/template/.claude/hooks/post-tool-use.py +0 -155
- package/template/.claude/hooks/pre-tool-use.py +0 -159
- package/template/.claude/hooks/stop-validation.py +0 -155
- package/template/.claude/hooks/validate-commit.py +0 -200
- package/template/.claude/hooks/workflow-manager.py +0 -350
- 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
|