|
11 | 11 | "when_to_use": [ |
12 | 12 | "Capture vibe design decisions", |
13 | 13 | "Document skill organization patterns", |
14 | | - "Record MCP tool configurations and why they're assigned to specific vibes" |
| 14 | + "Record MCP tool configurations and why they're assigned to specific vibes", |
| 15 | + "Search for existing skill/vibe improvement opportunities" |
15 | 16 | ], |
16 | 17 | "key_operations": [ |
17 | 18 | "graphiti.add_entity (new vibe/skill/MCP server)", |
18 | 19 | "graphiti.add_episode (vibe refactoring decisions)", |
19 | 20 | "graphiti.search (find existing organizational patterns)" |
20 | 21 | ] |
21 | 22 | }, |
| 23 | + { |
| 24 | + "name": "context7", |
| 25 | + "purpose": "Fetch up-to-date library documentation for skill/vibe updates", |
| 26 | + "when_to_use": [ |
| 27 | + "Update skills after library version changes", |
| 28 | + "Verify current API patterns for documentation", |
| 29 | + "Refresh skill knowledge with latest best practices" |
| 30 | + ], |
| 31 | + "key_operations": [ |
| 32 | + "mcp_context7_resolve-library-id (libraryName: 'encore'|'@sveltejs/kit'|'svelte'|'playwright')", |
| 33 | + "mcp_context7_get-library-docs (context7CompatibleLibraryID, topic, tokens)" |
| 34 | + ] |
| 35 | + }, |
22 | 36 | { |
23 | 37 | "name": "github", |
24 | 38 | "purpose": "Manage repository structure and documentation files", |
|
237 | 251 | "Root documentation (CLAUDE.md, README.md, etc.)", |
238 | 252 | "Founder rules (.cursor/rules/)", |
239 | 253 | "Task command organization (.cursor/commands/)", |
240 | | - "Ensure vibes/skills/MCPs are correctly organized" |
| 254 | + "Ensure vibes/skills/MCPs are correctly organized", |
| 255 | + "Keep skills/vibes current via context7 MCP (fetch latest library docs)", |
| 256 | + "Document skill/vibe decisions in Graphiti", |
| 257 | + "Follow skill-creator patterns for updates" |
241 | 258 | ], |
242 | 259 | "does_not_touch": "Service implementation code (backend/frontend/)" |
243 | 260 | } |
|
250 | 267 | "Domain-specific tools assigned to the vibe that uses them most", |
251 | 268 | "Testing tools can be shared (playwright in both qa_vibe and frontend_vibe)", |
252 | 269 | "Infrastructure tools (github, vercel) assigned to infra_vibe", |
253 | | - "Meta tools (graphiti for org decisions) used by vibe_manager_vibe" |
| 270 | + "Meta tools (graphiti for org decisions, context7 for skill/vibe updates) used by vibe_manager_vibe" |
254 | 271 | ], |
255 | 272 | "registry": { |
256 | 273 | "base_vibe": ["graphiti", "context7", "sequential-thinking"], |
257 | 274 | "backend_vibe": ["encore-mcp", "github"], |
258 | 275 | "frontend_vibe": ["playwright", "svelte", "figma", "vercel"], |
259 | 276 | "qa_vibe": ["playwright", "encore-mcp", "github"], |
260 | 277 | "infra_vibe": ["github", "vercel"], |
261 | | - "vibe_manager_vibe": ["graphiti", "github"] |
| 278 | + "vibe_manager_vibe": ["graphiti", "context7", "github"] |
262 | 279 | } |
263 | 280 | }, |
264 | 281 | "skill_organization_strategy": { |
|
345 | 362 | "6. Keep all docs synchronized with actual capabilities", |
346 | 363 | "7. Surgical edits only (per founder rules)", |
347 | 364 | "8. Verify links and cross-references work" |
| 365 | + ], |
| 366 | + "update_skills_and_vibes": [ |
| 367 | + "1. Use .cursor/commands/update-skills.md as primary guide", |
| 368 | + "2. Phase 1: Search Graphiti for recent skill/vibe decisions and struggles", |
| 369 | + "3. Phase 2: Fetch updated docs via context7 MCP (resolve-library-id → get-library-docs)", |
| 370 | + "4. Phase 3: Update skills following skill-creator_skill/SKILL.md best practices", |
| 371 | + "5. Phase 4: Update vibes' mcp_tools, documentation, claude_skills, task_commands fields", |
| 372 | + "6. Phase 5: Synchronize root documentation (vibes/README.md, .claude-skills/README.md, CLAUDE.md)", |
| 373 | + "7. Phase 6: Test updated skills/vibes, validate with founder:rules:check", |
| 374 | + "8. Phase 7: Document update decisions in Graphiti (add_episode with library versions, pattern changes, insights)" |
348 | 375 | ] |
349 | 376 | }, |
350 | 377 | "common_pitfalls": [ |
|
359 | 386 | "❌ Forgetting to update vibes when adding new Task commands or skills", |
360 | 387 | "✅ Keep vibes synchronized with actual automation capabilities", |
361 | 388 | "❌ Creating root documentation that duplicates .cursor/rules/ content", |
362 | | - "✅ CLAUDE.md for quick reference, founder_rules.mdc for detailed standards" |
| 389 | + "✅ CLAUDE.md for quick reference, founder_rules.mdc for detailed standards", |
| 390 | + "❌ Letting skills get outdated after library upgrades", |
| 391 | + "✅ Use context7 MCP to fetch latest docs, update skills following skill-creator patterns", |
| 392 | + "❌ Guessing at skill improvements without checking Graphiti for existing patterns", |
| 393 | + "✅ Always search Graphiti first for skill/vibe decisions and documented struggles" |
363 | 394 | ], |
364 | 395 | "quality_checklist": { |
365 | 396 | "after_vibe_changes": [ |
|
385 | 416 | "✓ Tool purpose and key_operations documented in vibe", |
386 | 417 | "✓ vibes/README.md reflects MCP tool assignments", |
387 | 418 | "✓ Tool tested in vibe context" |
| 419 | + ], |
| 420 | + "after_skill_vibe_updates": [ |
| 421 | + "✓ Used Graphiti to search for existing patterns before updating", |
| 422 | + "✓ Fetched latest library docs via context7 MCP", |
| 423 | + "✓ Updated skills following skill-creator_skill/SKILL.md guidelines", |
| 424 | + "✓ SKILL.md uses imperative/infinitive form (not second person)", |
| 425 | + "✓ Detailed content moved to references/ (keep SKILL.md lean)", |
| 426 | + "✓ Vibes' mcp_tools reflect current capabilities", |
| 427 | + "✓ Vibes' task_commands match actual Taskfile commands", |
| 428 | + "✓ Root docs synchronized (vibes/README.md, .claude-skills/README.md)", |
| 429 | + "✓ Updated skills tested on real tasks", |
| 430 | + "✓ Update decisions documented in Graphiti (add_episode)" |
388 | 431 | ] |
389 | 432 | } |
390 | 433 | } |
|
0 commit comments