start-vibing 3.0.9 → 4.0.0

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.
@@ -1,96 +0,0 @@
1
- # Claude System
2
-
3
- ## Last Update
4
-
5
- - **Date:** 2026-02-28
6
- - **Commit:** pending
7
- - **Session:** Removed hooks (stop-validator, user-prompt-submit), removed 3 skills (hook-development, mongoose-patterns, playwright-automation), updated architecture to 6 agents + 20 skills + 5 plugins
8
-
9
- ## Files
10
-
11
- ### Agents (6 active)
12
-
13
- - `.claude/agents/research-web.md` - Researches best practices (2024-2026) before implementation
14
- - `.claude/agents/documenter.md` - Creates/updates domain documentation
15
- - `.claude/agents/domain-updater.md` - Records session learnings in domains
16
- - `.claude/agents/commit-manager.md` - Manages git commits and workflow
17
- - `.claude/agents/claude-md-compactor.md` - Compacts CLAUDE.md when > 40k chars
18
- - `.claude/agents/tester-unit.md` - Creates unit tests with Vitest
19
-
20
- ### Archived Agents
21
-
22
- - `.claude/agents/_archive/` - 82+ archived agents (unused, kept for reference)
23
-
24
- ### Skills (20 active)
25
-
26
- - `.claude/skills/bun-runtime/` - Bun runtime patterns
27
- - `.claude/skills/codebase-knowledge/` - Domain mapping system
28
- - `.claude/skills/debugging-patterns/` - Error resolution patterns
29
- - `.claude/skills/docker-patterns/` - Docker multi-stage and security
30
- - `.claude/skills/docs-tracker/` - Documentation tracking
31
- - `.claude/skills/final-check/` - Final validation rules
32
- - `.claude/skills/git-workflow/` - Git workflow rules
33
- - `.claude/skills/nextjs-app-router/` - Next.js App Router patterns
34
- - `.claude/skills/performance-patterns/` - Performance profiling
35
- - `.claude/skills/quality-gate/` - Quality gate definitions
36
- - `.claude/skills/react-patterns/` - React 19 patterns
37
- - `.claude/skills/research-cache/` - Best practices research cache
38
- - `.claude/skills/security-scan/` - Security audit rules (OWASP)
39
- - `.claude/skills/shadcn-ui/` - shadcn/ui theming and accessibility
40
- - `.claude/skills/tailwind-patterns/` - Tailwind CSS patterns
41
- - `.claude/skills/test-coverage/` - Test coverage tracking
42
- - `.claude/skills/trpc-api/` - tRPC type-safe API patterns
43
- - `.claude/skills/typescript-strict/` - TypeScript strict mode
44
- - `.claude/skills/ui-ux-audit/` - UI/UX audit rules
45
- - `.claude/skills/zod-validation/` - Zod validation schemas
46
-
47
- ### Plugins (5 via enabledPlugins)
48
-
49
- - `typescript-lsp` - Type diagnostics, go-to-def (LSP server, auto)
50
- - `code-review` - Code quality, PR analysis (/code-review cmd)
51
- - `security-guidance` - OWASP, vulnerability scan (PreToolUse hook, auto)
52
- - `commit-commands` - Git commit, push, PR flows (/commit cmd)
53
- - `frontend-design` - Production-grade UI design (/frontend-design cmd)
54
-
55
- ### Configuration
56
-
57
- - `.claude/settings.json` - Agent registration, flows, rules, plugins
58
- - `.claude/CLAUDE.md` - System documentation (agents, skills, architecture)
59
- - `.claude/config/project-config.json` - Stack, structure, commands
60
- - `.claude/config/domain-mapping.json` - File patterns to domains
61
- - `.claude/config/quality-gates.json` - Quality check commands
62
- - `.claude/config/testing-config.json` - Test framework config
63
- - `.claude/config/security-rules.json` - Security audit rules
64
-
65
- ### Scripts
66
-
67
- - `.claude/scripts/validate-skills.sh` - Skills activation check
68
- - `.claude/scripts/mcp-quick-install.ts` - MCP server installer
69
- - `.claude/scripts/setup-mcps.ts` - MCP setup automation
70
-
71
- ### Root Files
72
-
73
- - `CLAUDE.md` - Project rules and conventions
74
- - `.claude/CLAUDE.md` - Detailed system architecture
75
-
76
- ## Connections
77
-
78
- - **All domains:** domain-updater reads/updates domain files after sessions
79
- - **Skills:** Auto-injected into context when task matches description
80
-
81
- ## Recent Commits
82
-
83
- | Hash | Date | Description |
84
- | ------- | ---------- | --------------------------------------------------------------------- |
85
- | pending | 2026-02-28 | refactor: remove hooks, update architecture to 6 agents + 20 skills |
86
- | 6f3d9ff | 2026-02-24 | docs(skills): add skills activation research plan |
87
- | efa7c4f | 2026-02-24 | refactor(skills): rewrite all 23 descriptions to imperative pattern |
88
-
89
- ## Attention Points
90
-
91
- - [2026-02-28] **No hooks** - Hooks (stop-validator, user-prompt-submit) were removed. No automated enforcement.
92
- - [2026-02-28] **20 skills** - Down from 23. Removed: hook-development, mongoose-patterns, playwright-automation
93
- - [2026-02-24] **Imperative descriptions** - All skill descriptions use "ALWAYS invoke when... Do NOT..." pattern for 95%+ auto-invocation
94
- - [2026-02-19] **6 agents + 5 plugins** - Agents are subagents. Plugins auto-install via enabledPlugins in settings.json
95
- - [2024-12-19] **Config files for project specifics** - Agents read from `.claude/config/*.json` instead of hardcoding
96
- - [2024-12-19] **SKILL.md YAML frontmatter** - All skills MUST have `---` frontmatter with name, description
@@ -1,128 +0,0 @@
1
- # MCP Integration Domain
2
-
3
- > **Last Updated:** 2026-02-28
4
- > **Commit:** (pending)
5
-
6
- ---
7
-
8
- ## Overview
9
-
10
- Model Context Protocol (MCP) is an open standard created by Anthropic that enables AI models to securely interact with external tools, data sources, and systems through standardized server implementations.
11
-
12
- MCPs are configured in `.mcp.json` (project scope) or via `claude mcp add` (user scope).
13
-
14
- ---
15
-
16
- ## File Mappings
17
-
18
- | File | Purpose |
19
- | ------------------------------ | ---------------------------------------------- |
20
- | `.mcp.json` | Project-scoped MCP config (team shared) |
21
-
22
- ---
23
-
24
- ## Active MCP Servers
25
-
26
- | MCP | Publisher | Purpose |
27
- | ----------------------- | --------- | ------------------------------- |
28
- | **Context7** | Upstash | Real-time library documentation |
29
- | **Sequential Thinking** | Anthropic | Structured reasoning |
30
- | **Playwright** | Microsoft | Browser automation, E2E testing |
31
- | **Memory** | Anthropic | Persistent context |
32
- | **Next.js DevTools** | Vercel | Next.js 16+ development |
33
- | **MongoDB** | MongoDB | Database operations |
34
- | **Jira** | Atlassian | Issue tracking |
35
- | **Git** | MCP | Git operations |
36
- | **Fetch** | MCP | Web page reading |
37
-
38
- ### Optional (install via `claude mcp add`)
39
-
40
- | MCP | Publisher | Purpose |
41
- | ---------- | --------- | ------------------ |
42
- | **GitHub** | GitHub | Repository management |
43
- | **Sentry** | Sentry | Error tracking |
44
- | **Figma** | Figma | Design to code |
45
- | **Linear** | Linear | Issue tracker |
46
- | **Stripe** | Stripe | Payments |
47
- | **Vercel** | Vercel | Deployments |
48
-
49
- ---
50
-
51
- ## Security Guidelines
52
-
53
- ### Trusted Publishers
54
-
55
- Only install MCPs from verified publishers:
56
- - `modelcontextprotocol` (Anthropic)
57
- - `github`, `microsoft`, `vercel`, `mongodb-js`
58
- - `upstash`, `docker`, `figma`, `getsentry`
59
-
60
- ### Red Flags (DO NOT Install)
61
-
62
- - Publishers not in trusted list
63
- - Missing repository URL
64
- - MCPs requesting excessive permissions
65
- - MCPs with recent CVEs
66
-
67
- ---
68
-
69
- ## Installation
70
-
71
- ```bash
72
- # Add local stdio server
73
- claude mcp add -s user <name> -- npx -y <package>
74
-
75
- # Add remote HTTP server
76
- claude mcp add --transport http -s user <name> <url>
77
-
78
- # List installed servers
79
- claude mcp list
80
-
81
- # Remove server
82
- claude mcp remove <name>
83
-
84
- # Debug server issues
85
- claude --mcp-debug
86
- ```
87
-
88
- ---
89
-
90
- ## Configuration Scopes
91
-
92
- | Scope | Location | Shared |
93
- | --------- | ----------------------------- | ------ |
94
- | `user` | `~/.claude/settings.json` | No |
95
- | `project` | `.mcp.json` | Yes |
96
- | `local` | `.claude/settings.local.json` | No |
97
-
98
- ---
99
-
100
- ## Environment Variables
101
-
102
- | Variable | MCP | Required For |
103
- | ------------------------------ | ------------ | ------------------- |
104
- | `GITHUB_PERSONAL_ACCESS_TOKEN` | GitHub | Repo access |
105
- | `MONGODB_URI` | MongoDB | Database connection |
106
- | `ATLASSIAN_SITE_NAME` | Jira | Jira site |
107
- | `ATLASSIAN_USER_EMAIL` | Jira | Jira auth |
108
- | `ATLASSIAN_API_TOKEN` | Jira | Jira auth |
109
-
110
- ---
111
-
112
- ## Troubleshooting
113
-
114
- | Problem | Solution |
115
- | --------------------- | --------------------------------- |
116
- | Server shows "failed" | Check `claude --mcp-debug` output |
117
- | Timeout on startup | Increase `MCP_TIMEOUT` env var |
118
- | Tool not available | Restart Claude Code after adding |
119
- | Auth errors | Verify tokens/credentials are set |
120
-
121
- ---
122
-
123
- ## Attention Points
124
-
125
- - MCP ecosystem is rapidly evolving
126
- - Always check for CVEs before installing new MCPs
127
- - Some MCPs require paid accounts (Figma, Sentry)
128
- - Rate limits apply to many remote MCPs
@@ -1,239 +0,0 @@
1
- ---
2
- name: docs-tracker
3
- description: "ALWAYS invoke AFTER implementation completes. Detects modified files via git diff, creates/updates docs. Do NOT skip — documentation is mandatory for all changes."
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