@su-record/vibe 2.8.52 → 2.9.1
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/.env.example +37 -37
- package/CLAUDE.md +169 -169
- package/LICENSE +21 -21
- package/README.ko.md +43 -128
- package/README.md +43 -128
- package/agents/architect-low.md +41 -41
- package/agents/architect-medium.md +59 -59
- package/agents/architect.md +80 -80
- package/agents/build-error-resolver.md +115 -115
- package/agents/compounder.md +261 -261
- package/agents/diagrammer.md +178 -178
- package/agents/docs/api-documenter.md +99 -99
- package/agents/docs/changelog-writer.md +93 -93
- package/agents/e2e-tester.md +294 -294
- package/agents/event/event-comms.md +78 -78
- package/agents/event/event-content.md +68 -68
- package/agents/event/event-image.md +95 -95
- package/agents/event/event-ops.md +84 -84
- package/agents/event/event-scheduler.md +69 -69
- package/agents/event/event-speaker.md +86 -86
- package/agents/explorer-low.md +42 -42
- package/agents/explorer-medium.md +59 -59
- package/agents/explorer.md +48 -48
- package/agents/implementer-low.md +43 -43
- package/agents/implementer-medium.md +52 -52
- package/agents/implementer.md +54 -54
- package/agents/junior-mentor.md +141 -141
- package/agents/planning/requirements-analyst.md +84 -84
- package/agents/planning/ux-advisor.md +83 -83
- package/agents/qa/acceptance-tester.md +86 -86
- package/agents/qa/edge-case-finder.md +93 -93
- package/agents/qa/qa-coordinator.md +131 -131
- package/agents/refactor-cleaner.md +143 -143
- package/agents/research/best-practices-agent.md +199 -199
- package/agents/research/codebase-patterns-agent.md +157 -157
- package/agents/research/framework-docs-agent.md +188 -188
- package/agents/research/security-advisory-agent.md +213 -213
- package/agents/review/architecture-reviewer.md +107 -107
- package/agents/review/complexity-reviewer.md +116 -116
- package/agents/review/data-integrity-reviewer.md +88 -88
- package/agents/review/git-history-reviewer.md +103 -103
- package/agents/review/performance-reviewer.md +86 -86
- package/agents/review/python-reviewer.md +150 -150
- package/agents/review/rails-reviewer.md +139 -139
- package/agents/review/react-reviewer.md +144 -144
- package/agents/review/security-reviewer.md +80 -80
- package/agents/review/simplicity-reviewer.md +140 -140
- package/agents/review/test-coverage-reviewer.md +116 -116
- package/agents/review/typescript-reviewer.md +127 -127
- package/agents/searcher.md +54 -54
- package/agents/simplifier.md +120 -120
- package/agents/tester.md +49 -49
- package/agents/ui/ui-a11y-auditor.md +93 -93
- package/agents/ui/ui-antipattern-detector.md +102 -102
- package/agents/ui/ui-dataviz-advisor.md +69 -69
- package/agents/ui/ui-design-system-gen.md +57 -57
- package/agents/ui/ui-industry-analyzer.md +49 -49
- package/agents/ui/ui-layout-architect.md +65 -65
- package/agents/ui/ui-stack-implementer.md +68 -68
- package/agents/ui/ux-compliance-reviewer.md +81 -81
- package/agents/ui-previewer.md +258 -258
- package/commands/vibe.analyze.md +379 -379
- package/commands/vibe.docs.md +32 -32
- package/commands/vibe.event.md +163 -163
- package/commands/vibe.figma.md +69 -69
- package/commands/vibe.review.md +686 -686
- package/commands/vibe.run.md +2276 -2276
- package/commands/vibe.spec.md +1195 -1195
- package/commands/vibe.spec.review.md +609 -609
- package/commands/vibe.trace.md +259 -259
- package/commands/vibe.utils.md +413 -413
- package/commands/vibe.verify.md +510 -510
- package/dist/cli/collaborator.js +52 -52
- package/dist/cli/commands/config.js +9 -9
- package/dist/cli/commands/evolution.js +12 -12
- package/dist/cli/commands/figma.js +20 -20
- package/dist/cli/commands/info.js +53 -53
- package/dist/cli/commands/init.js +5 -5
- package/dist/cli/commands/remove.js +14 -14
- package/dist/cli/commands/sentinel.js +27 -27
- package/dist/cli/commands/skills.js +5 -5
- package/dist/cli/commands/slack.js +10 -10
- package/dist/cli/commands/stats.js +6 -6
- package/dist/cli/commands/telegram.js +12 -12
- package/dist/cli/detect.js +32 -32
- package/dist/cli/index.js +51 -51
- package/dist/cli/llm/claude-commands.js +16 -16
- package/dist/cli/llm/config.js +18 -18
- package/dist/cli/llm/gemini-commands.js +16 -16
- package/dist/cli/llm/gpt-commands.js +19 -19
- package/dist/cli/llm/help.js +21 -21
- package/dist/cli/postinstall/cursor-agents.js +32 -32
- package/dist/cli/postinstall/cursor-rules.js +83 -83
- package/dist/cli/postinstall/cursor-skills.js +743 -743
- package/dist/cli/postinstall/main.d.ts.map +1 -1
- package/dist/cli/postinstall/main.js +40 -66
- package/dist/cli/postinstall/main.js.map +1 -1
- package/dist/cli/setup/Provisioner.js +42 -42
- package/dist/infra/lib/CostAccumulator.d.ts +58 -0
- package/dist/infra/lib/CostAccumulator.d.ts.map +1 -0
- package/dist/infra/lib/CostAccumulator.js +131 -0
- package/dist/infra/lib/CostAccumulator.js.map +1 -0
- package/dist/infra/lib/DeepInit.js +24 -24
- package/dist/infra/lib/IterationTracker.js +11 -11
- package/dist/infra/lib/PythonParser.js +108 -108
- package/dist/infra/lib/ReviewRace.js +96 -96
- package/dist/infra/lib/SkillFrontmatter.js +28 -28
- package/dist/infra/lib/SkillQualityGate.js +9 -9
- package/dist/infra/lib/SkillRepository.js +159 -159
- package/dist/infra/lib/TokenBudgetTracker.d.ts +13 -0
- package/dist/infra/lib/TokenBudgetTracker.d.ts.map +1 -1
- package/dist/infra/lib/TokenBudgetTracker.js +44 -3
- package/dist/infra/lib/TokenBudgetTracker.js.map +1 -1
- package/dist/infra/lib/UltraQA.js +99 -99
- package/dist/infra/lib/autonomy/AuditStore.js +41 -41
- package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
- package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
- package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
- package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
- package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
- package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
- package/dist/infra/lib/embedding/VectorStore.js +22 -22
- package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
- package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
- package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
- package/dist/infra/lib/evolution/InsightStore.js +90 -90
- package/dist/infra/lib/evolution/ParityTester.js +57 -57
- package/dist/infra/lib/evolution/RollbackManager.js +5 -5
- package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
- package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
- package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
- package/dist/infra/lib/evolution/UsageTracker.js +28 -28
- package/dist/infra/lib/gemini/orchestration.js +5 -5
- package/dist/infra/lib/gpt/orchestration.js +4 -4
- package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
- package/dist/infra/lib/memory/MemorySearch.js +57 -57
- package/dist/infra/lib/memory/MemoryStorage.js +181 -181
- package/dist/infra/lib/memory/ObservationStore.js +28 -28
- package/dist/infra/lib/memory/ReflectionStore.js +30 -30
- package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
- package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
- package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
- package/dist/infra/orchestrator/AgentManager.js +12 -12
- package/dist/infra/orchestrator/AgentRegistry.js +65 -65
- package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
- package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
- package/dist/infra/orchestrator/parallelResearch.js +24 -24
- package/dist/tools/convention/analyzeComplexity.test.js +115 -115
- package/dist/tools/convention/validateCodeQuality.test.js +104 -104
- package/dist/tools/memory/createMemoryTimeline.js +10 -10
- package/dist/tools/memory/getMemoryGraph.js +12 -12
- package/dist/tools/memory/getSessionContext.js +9 -9
- package/dist/tools/memory/linkMemories.js +14 -14
- package/dist/tools/memory/listMemories.js +4 -4
- package/dist/tools/memory/recallMemory.js +4 -4
- package/dist/tools/memory/saveMemory.js +4 -4
- package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
- package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
- package/dist/tools/semantic/astGrep.test.js +6 -6
- package/dist/tools/spec/prdParser.test.js +171 -171
- package/dist/tools/spec/specGenerator.js +169 -169
- package/dist/tools/spec/traceabilityMatrix.js +64 -64
- package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
- package/hooks/gemini-hooks.json +73 -73
- package/hooks/hooks.json +174 -174
- package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
- package/hooks/scripts/__tests__/pre-tool-guard.test.js +286 -286
- package/hooks/scripts/__tests__/sentinel-guard.test.js +210 -210
- package/hooks/scripts/auto-commit.js +97 -97
- package/hooks/scripts/auto-format.js +64 -64
- package/hooks/scripts/auto-test.js +81 -81
- package/hooks/scripts/code-check.js +268 -268
- package/hooks/scripts/codex-detect.js +46 -46
- package/hooks/scripts/codex-review-gate.js +80 -80
- package/hooks/scripts/command-log.js +32 -32
- package/hooks/scripts/context-save.js +353 -353
- package/hooks/scripts/evolution-engine.js +91 -91
- package/hooks/scripts/figma-extract.js +635 -477
- package/hooks/scripts/hud-status.js +321 -321
- package/hooks/scripts/keyword-detector.js +214 -214
- package/hooks/scripts/llm-orchestrate.js +572 -572
- package/hooks/scripts/post-edit.js +32 -32
- package/hooks/scripts/pr-test-gate.js +52 -52
- package/hooks/scripts/pre-tool-guard.js +214 -159
- package/hooks/scripts/prompt-dispatcher.js +185 -185
- package/hooks/scripts/sentinel-guard.js +131 -131
- package/hooks/scripts/session-start.js +177 -177
- package/hooks/scripts/skill-injector.js +83 -83
- package/hooks/scripts/stop-notify.js +209 -209
- package/hooks/scripts/utils.js +243 -243
- package/languages/csharp-unity.md +515 -515
- package/languages/gdscript-godot.md +470 -470
- package/languages/ruby-rails.md +489 -489
- package/languages/typescript-angular.md +433 -433
- package/languages/typescript-astro.md +416 -416
- package/languages/typescript-electron.md +406 -406
- package/languages/typescript-nestjs.md +524 -524
- package/languages/typescript-svelte.md +407 -407
- package/languages/typescript-tauri.md +365 -365
- package/package.json +101 -101
- package/skills/agents-md/SKILL.md +121 -121
- package/skills/agents-md/rubrics/what-to-keep.md +49 -49
- package/skills/agents-md/templates/agents-md.md +36 -36
- package/skills/arch-guard/SKILL.md +181 -181
- package/skills/arch-guard/agents/detector.md +48 -48
- package/skills/arch-guard/agents/reporter.md +48 -48
- package/skills/arch-guard/agents/rule-generator.md +49 -49
- package/skills/arch-guard/agents/violation-checker.md +51 -51
- package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
- package/skills/arch-guard/frameworks/solid.md +102 -102
- package/skills/arch-guard/scripts/check-boundaries.js +90 -90
- package/skills/arch-guard/templates/arch-rules.json +47 -47
- package/skills/arch-guard/templates/violation-report.md +53 -53
- package/skills/brand-assets/SKILL.md +147 -147
- package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
- package/skills/brand-assets/templates/brand-guide.md +161 -161
- package/skills/capability-loop/SKILL.md +168 -168
- package/skills/capability-loop/agents/capability-designer.md +61 -61
- package/skills/capability-loop/agents/failure-analyst.md +55 -55
- package/skills/capability-loop/agents/implementer.md +50 -50
- package/skills/capability-loop/agents/tester.md +53 -53
- package/skills/capability-loop/templates/capability-spec.md +118 -118
- package/skills/capability-loop/templates/failure-analysis.md +118 -118
- package/skills/characterization-test/SKILL.md +207 -207
- package/skills/characterization-test/agents/behavior-capturer.md +50 -50
- package/skills/characterization-test/agents/coverage-checker.md +54 -54
- package/skills/characterization-test/agents/reporter.md +50 -50
- package/skills/characterization-test/agents/test-writer.md +49 -49
- package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
- package/skills/characterization-test/templates/test-template.ts +101 -101
- package/skills/chub-usage/SKILL.md +139 -139
- package/skills/claude-md-guide/SKILL.md +351 -351
- package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
- package/skills/claude-md-guide/templates/claude-md.md +54 -54
- package/skills/commerce-patterns/SKILL.md +64 -64
- package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
- package/skills/commerce-patterns/templates/product-schema.md +85 -85
- package/skills/commit-push-pr/SKILL.md +77 -77
- package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
- package/skills/commit-push-pr/agents/message-writer.md +50 -50
- package/skills/commit-push-pr/agents/pr-writer.md +58 -58
- package/skills/commit-push-pr/agents/reviewer.md +52 -52
- package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
- package/skills/commit-push-pr/templates/pr-body.md +63 -63
- package/skills/context7-usage/SKILL.md +106 -106
- package/skills/context7-usage/rubrics/when-to-use.md +50 -50
- package/skills/create-prd/SKILL.md +90 -90
- package/skills/create-prd/agents/edge-case-finder.md +48 -48
- package/skills/create-prd/agents/prioritizer.md +60 -60
- package/skills/create-prd/agents/requirements-writer.md +48 -48
- package/skills/create-prd/agents/researcher.md +55 -55
- package/skills/create-prd/agents/reviewer.md +54 -54
- package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
- package/skills/create-prd/frameworks/rice-scoring.md +97 -97
- package/skills/create-prd/orchestrator.md +70 -70
- package/skills/create-prd/rubrics/completeness.md +58 -58
- package/skills/create-prd/templates/prd.md +139 -139
- package/skills/design-audit/SKILL.md +152 -152
- package/skills/design-audit/agents/a11y-auditor.md +43 -43
- package/skills/design-audit/agents/performance-auditor.md +46 -46
- package/skills/design-audit/agents/responsive-auditor.md +46 -46
- package/skills/design-audit/agents/scorer.md +47 -47
- package/skills/design-audit/agents/slop-detector.md +47 -47
- package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
- package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
- package/skills/design-audit/orchestrator.md +64 -64
- package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
- package/skills/design-audit/rubrics/scoring.md +63 -63
- package/skills/design-audit/templates/report.md +88 -88
- package/skills/design-critique/SKILL.md +139 -139
- package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
- package/skills/design-critique/templates/critique-report.md +86 -86
- package/skills/design-distill/SKILL.md +130 -130
- package/skills/design-distill/templates/design-system.md +132 -132
- package/skills/design-normalize/SKILL.md +133 -133
- package/skills/design-normalize/rubrics/token-naming.md +117 -117
- package/skills/design-normalize/templates/token-audit.md +89 -89
- package/skills/design-polish/SKILL.md +131 -131
- package/skills/design-polish/rubrics/polish-checklist.md +68 -68
- package/skills/design-polish/templates/polish-report.md +64 -64
- package/skills/design-teach/SKILL.md +182 -182
- package/skills/design-teach/rubrics/brand-personality.md +73 -73
- package/skills/design-teach/templates/design-context.json +36 -36
- package/skills/e2e-commerce/SKILL.md +62 -62
- package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
- package/skills/event-comms/SKILL.md +162 -162
- package/skills/event-comms/templates/email-invite.md +99 -99
- package/skills/event-comms/templates/sns-post.md +133 -133
- package/skills/event-ops/SKILL.md +198 -198
- package/skills/event-ops/rubrics/contingency.md +85 -85
- package/skills/event-ops/templates/d-day-checklist.md +65 -65
- package/skills/event-planning/SKILL.md +132 -132
- package/skills/event-planning/rubrics/timeline.md +70 -70
- package/skills/event-planning/templates/event-plan.md +91 -91
- package/skills/exec-plan/SKILL.md +149 -149
- package/skills/exec-plan/agents/decomposer.md +47 -47
- package/skills/exec-plan/agents/dependency-mapper.md +44 -44
- package/skills/exec-plan/agents/estimator.md +43 -43
- package/skills/exec-plan/agents/validator.md +55 -55
- package/skills/exec-plan/orchestrator.md +70 -70
- package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
- package/skills/exec-plan/templates/plan.md +147 -147
- package/skills/git-worktree/SKILL.md +73 -73
- package/skills/git-worktree/rubrics/when-to-use.md +55 -55
- package/skills/handoff/SKILL.md +110 -110
- package/skills/handoff/agents/context-summarizer.md +51 -51
- package/skills/handoff/agents/document-writer.md +63 -63
- package/skills/handoff/agents/state-collector.md +53 -53
- package/skills/handoff/agents/verifier.md +48 -48
- package/skills/handoff/rubrics/completeness.md +62 -62
- package/skills/handoff/templates/handoff.md +107 -107
- package/skills/parallel-research/SKILL.md +89 -89
- package/skills/parallel-research/agents/best-practices.md +43 -43
- package/skills/parallel-research/agents/codebase-patterns.md +46 -46
- package/skills/parallel-research/agents/framework-docs.md +45 -45
- package/skills/parallel-research/agents/security-advisory.md +46 -46
- package/skills/parallel-research/agents/synthesizer.md +52 -52
- package/skills/parallel-research/experts/best-practices.md +50 -50
- package/skills/parallel-research/experts/codebase-patterns.md +70 -70
- package/skills/parallel-research/experts/framework-docs.md +65 -65
- package/skills/parallel-research/experts/security-advisory.md +69 -69
- package/skills/parallel-research/orchestrator.md +65 -65
- package/skills/parallel-research/templates/synthesis.md +101 -101
- package/skills/prioritization-frameworks/SKILL.md +87 -87
- package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
- package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
- package/skills/priority-todos/SKILL.md +64 -64
- package/skills/priority-todos/rubrics/prioritization.md +70 -70
- package/skills/priority-todos/templates/todo-board.md +59 -59
- package/skills/seo-checklist/SKILL.md +58 -58
- package/skills/seo-checklist/frameworks/structured-data.md +153 -153
- package/skills/seo-checklist/rubrics/content-seo.md +42 -42
- package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
- package/skills/techdebt/SKILL.md +124 -124
- package/skills/techdebt/agents/analyzer.md +50 -50
- package/skills/techdebt/agents/fixer.md +41 -41
- package/skills/techdebt/agents/reviewer.md +47 -47
- package/skills/techdebt/agents/scanner.md +44 -44
- package/skills/techdebt/orchestrator.md +70 -70
- package/skills/techdebt/rubrics/severity.md +51 -51
- package/skills/techdebt/scripts/scan.js +90 -90
- package/skills/techdebt/templates/report.md +86 -86
- package/skills/tool-fallback/SKILL.md +104 -104
- package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
- package/skills/typescript-advanced-types/SKILL.md +67 -67
- package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
- package/skills/ui-ux-pro-max/SKILL.md +236 -236
- package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
- package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
- package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
- package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
- package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
- package/skills/ui-ux-pro-max/reference/typography.md +455 -455
- package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
- package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
- package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
- package/skills/user-personas/SKILL.md +75 -75
- package/skills/user-personas/rubrics/research-methods.md +56 -56
- package/skills/user-personas/templates/persona.md +89 -89
- package/skills/vercel-react-best-practices/SKILL.md +60 -60
- package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
- package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
- package/skills/vibe.docs/SKILL.md +171 -171
- package/skills/vibe.docs/templates/architecture.md +80 -80
- package/skills/vibe.docs/templates/readme.md +84 -84
- package/skills/vibe.docs/templates/release-notes.md +74 -74
- package/skills/vibe.figma/SKILL.md +215 -982
- package/skills/vibe.figma/rubrics/extraction-checklist.md +51 -51
- package/skills/vibe.figma/templates/component-index.md +126 -126
- package/skills/vibe.figma/templates/figma-handoff.md +100 -100
- package/skills/vibe.figma/templates/remapped-tree.md +277 -277
- package/skills/vibe.figma.convert/SKILL.md +188 -511
- package/skills/vibe.figma.convert/rubrics/conversion-rules.md +129 -113
- package/skills/vibe.figma.convert/templates/component.md +140 -140
- package/skills/vibe.figma.extract/SKILL.md +179 -300
- package/skills/vibe.figma.extract/rubrics/image-rules.md +145 -137
- package/skills/video-production/SKILL.md +52 -52
- package/skills/video-production/rubrics/quality-checklist.md +58 -58
- package/skills/video-production/templates/production-plan.md +104 -104
- package/vibe/config.json +29 -29
- package/vibe/constitution.md +227 -227
- package/vibe/rules/principles/communication-guide.md +98 -98
- package/vibe/rules/principles/development-philosophy.md +52 -52
- package/vibe/rules/principles/quick-start.md +102 -102
- package/vibe/rules/quality/bdd-contract-testing.md +393 -393
- package/vibe/rules/quality/checklist.md +276 -276
- package/vibe/rules/quality/performance.md +236 -236
- package/vibe/rules/quality/testing-strategy.md +440 -440
- package/vibe/rules/standards/anti-patterns.md +541 -541
- package/vibe/rules/standards/code-structure.md +291 -291
- package/vibe/rules/standards/complexity-metrics.md +313 -313
- package/vibe/rules/standards/git-workflow.md +237 -237
- package/vibe/rules/standards/naming-conventions.md +198 -198
- package/vibe/rules/standards/security.md +305 -305
- package/vibe/rules/writing/document-style.md +74 -74
- package/vibe/setup.sh +31 -31
- package/vibe/templates/constitution-template.md +252 -252
- package/vibe/templates/contract-backend-template.md +526 -526
- package/vibe/templates/contract-frontend-template.md +599 -599
- package/vibe/templates/feature-template.md +96 -96
- package/vibe/templates/spec-template.md +221 -221
- package/vibe/ui-ux-data/charts.csv +26 -26
- package/vibe/ui-ux-data/colors.csv +97 -97
- package/vibe/ui-ux-data/icons.csv +101 -101
- package/vibe/ui-ux-data/landing.csv +31 -31
- package/vibe/ui-ux-data/products.csv +96 -96
- package/vibe/ui-ux-data/react-performance.csv +45 -45
- package/vibe/ui-ux-data/stacks/astro.csv +54 -54
- package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
- package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
- package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
- package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
- package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
- package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
- package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
- package/vibe/ui-ux-data/stacks/react.csv +54 -54
- package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
- package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
- package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
- package/vibe/ui-ux-data/stacks/vue.csv +50 -50
- package/vibe/ui-ux-data/styles.csv +68 -68
- package/vibe/ui-ux-data/typography.csv +57 -57
- package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
- package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
- package/vibe/ui-ux-data/version.json +31 -31
- package/vibe/ui-ux-data/web-interface.csv +31 -31
|
@@ -1,52 +1,52 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: reviewer
|
|
3
|
-
role: Reviews commit message and PR body for quality before submission
|
|
4
|
-
tools: [Read, Bash]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Reviewer
|
|
8
|
-
|
|
9
|
-
## Role
|
|
10
|
-
Final quality gate before the commit is created and the PR is opened. Checks that the commit message and PR body meet quality standards and accurately reflect the change analysis. Blocks submission if critical issues are found.
|
|
11
|
-
|
|
12
|
-
## Responsibilities
|
|
13
|
-
- Verify commit subject line follows Conventional Commits format and is under 72 chars
|
|
14
|
-
- Check that commit body explains motivation, not just what changed
|
|
15
|
-
- Confirm PR title is under 70 characters and matches the commit type
|
|
16
|
-
- Verify PR body has all required sections: Summary, Motivation, Test Plan
|
|
17
|
-
- Flag missing BREAKING CHANGE footer if analysis identified API/behavior changes
|
|
18
|
-
|
|
19
|
-
## Input
|
|
20
|
-
- Commit message from message-writer
|
|
21
|
-
- PR title and body from pr-writer
|
|
22
|
-
- Change analysis report from change-analyzer (ground truth)
|
|
23
|
-
|
|
24
|
-
## Output
|
|
25
|
-
Quality review verdict:
|
|
26
|
-
|
|
27
|
-
```markdown
|
|
28
|
-
## Commit/PR Review
|
|
29
|
-
|
|
30
|
-
### Commit Message
|
|
31
|
-
- [x] Conventional format: fix(auth): ...
|
|
32
|
-
- [x] Subject under 72 chars (61 chars)
|
|
33
|
-
- [x] Body explains motivation
|
|
34
|
-
- [ ] MISSING: BREAKING CHANGE footer — validateToken now returns null, not throws
|
|
35
|
-
|
|
36
|
-
### PR Body
|
|
37
|
-
- [x] Title under 70 chars
|
|
38
|
-
- [x] Summary section present (3 bullets)
|
|
39
|
-
- [x] Motivation section present
|
|
40
|
-
- [x] Test Plan has manual verification step
|
|
41
|
-
- [ ] MISSING: Notes section should document null-vs-throw behavior change
|
|
42
|
-
|
|
43
|
-
### Verdict
|
|
44
|
-
BLOCKED — 2 items must be fixed before submission.
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## Communication
|
|
48
|
-
- Reports findings to: orchestrator (commit-push-pr skill) / user
|
|
49
|
-
- Receives instructions from: orchestrator
|
|
50
|
-
|
|
51
|
-
## Domain Knowledge
|
|
52
|
-
BLOCKED verdict requires fix before proceeding. APPROVED verdict allows immediate submission. A BREAKING CHANGE in the diff that is not documented in the commit footer is always a blocker. "What changed" in PR body is informational; "Why it changed" is required.
|
|
1
|
+
---
|
|
2
|
+
name: reviewer
|
|
3
|
+
role: Reviews commit message and PR body for quality before submission
|
|
4
|
+
tools: [Read, Bash]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Reviewer
|
|
8
|
+
|
|
9
|
+
## Role
|
|
10
|
+
Final quality gate before the commit is created and the PR is opened. Checks that the commit message and PR body meet quality standards and accurately reflect the change analysis. Blocks submission if critical issues are found.
|
|
11
|
+
|
|
12
|
+
## Responsibilities
|
|
13
|
+
- Verify commit subject line follows Conventional Commits format and is under 72 chars
|
|
14
|
+
- Check that commit body explains motivation, not just what changed
|
|
15
|
+
- Confirm PR title is under 70 characters and matches the commit type
|
|
16
|
+
- Verify PR body has all required sections: Summary, Motivation, Test Plan
|
|
17
|
+
- Flag missing BREAKING CHANGE footer if analysis identified API/behavior changes
|
|
18
|
+
|
|
19
|
+
## Input
|
|
20
|
+
- Commit message from message-writer
|
|
21
|
+
- PR title and body from pr-writer
|
|
22
|
+
- Change analysis report from change-analyzer (ground truth)
|
|
23
|
+
|
|
24
|
+
## Output
|
|
25
|
+
Quality review verdict:
|
|
26
|
+
|
|
27
|
+
```markdown
|
|
28
|
+
## Commit/PR Review
|
|
29
|
+
|
|
30
|
+
### Commit Message
|
|
31
|
+
- [x] Conventional format: fix(auth): ...
|
|
32
|
+
- [x] Subject under 72 chars (61 chars)
|
|
33
|
+
- [x] Body explains motivation
|
|
34
|
+
- [ ] MISSING: BREAKING CHANGE footer — validateToken now returns null, not throws
|
|
35
|
+
|
|
36
|
+
### PR Body
|
|
37
|
+
- [x] Title under 70 chars
|
|
38
|
+
- [x] Summary section present (3 bullets)
|
|
39
|
+
- [x] Motivation section present
|
|
40
|
+
- [x] Test Plan has manual verification step
|
|
41
|
+
- [ ] MISSING: Notes section should document null-vs-throw behavior change
|
|
42
|
+
|
|
43
|
+
### Verdict
|
|
44
|
+
BLOCKED — 2 items must be fixed before submission.
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Communication
|
|
48
|
+
- Reports findings to: orchestrator (commit-push-pr skill) / user
|
|
49
|
+
- Receives instructions from: orchestrator
|
|
50
|
+
|
|
51
|
+
## Domain Knowledge
|
|
52
|
+
BLOCKED verdict requires fix before proceeding. APPROVED verdict allows immediate submission. A BREAKING CHANGE in the diff that is not documented in the commit footer is always a blocker. "What changed" in PR body is informational; "Why it changed" is required.
|
|
@@ -1,73 +1,73 @@
|
|
|
1
|
-
# Commit Message Format Rubric
|
|
2
|
-
|
|
3
|
-
## Structure
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
<type>(<scope>): <subject> ← 50 chars max, imperative mood
|
|
7
|
-
← blank line
|
|
8
|
-
<body> ← 72 chars/line wrap, explain WHY
|
|
9
|
-
← blank line
|
|
10
|
-
<footer> ← Co-Authored-By, Closes #N
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Types
|
|
14
|
-
|
|
15
|
-
| Type | When to Use |
|
|
16
|
-
|------|-------------|
|
|
17
|
-
| `feat` | New feature or capability |
|
|
18
|
-
| `fix` | Bug fix |
|
|
19
|
-
| `refactor` | Code restructure, no behavior change |
|
|
20
|
-
| `perf` | Performance improvement |
|
|
21
|
-
| `test` | Adding or fixing tests |
|
|
22
|
-
| `docs` | Documentation only |
|
|
23
|
-
| `style` | Formatting, whitespace (no logic change) |
|
|
24
|
-
| `chore` | Build, deps, tooling, CI |
|
|
25
|
-
|
|
26
|
-
## Subject Line Rules
|
|
27
|
-
|
|
28
|
-
- Imperative mood: "add feature" not "added feature"
|
|
29
|
-
- No period at end
|
|
30
|
-
- Max 50 characters
|
|
31
|
-
- Scope is optional: `feat(auth): add OAuth login`
|
|
32
|
-
|
|
33
|
-
## Body Rules
|
|
34
|
-
|
|
35
|
-
- Explain **why**, not what (code shows what)
|
|
36
|
-
- Wrap at 72 characters
|
|
37
|
-
- Use bullet points for multiple changes
|
|
38
|
-
- Reference issues: `Closes #123`, `Fixes #456`
|
|
39
|
-
|
|
40
|
-
## Required Footer
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Examples
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
feat(auth): add GitHub OAuth login
|
|
50
|
-
|
|
51
|
-
Users can now sign in with GitHub instead of email/password.
|
|
52
|
-
Reduces friction for developer-focused onboarding flow.
|
|
53
|
-
|
|
54
|
-
Closes #42
|
|
55
|
-
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
```
|
|
59
|
-
fix(api): prevent null reference on empty search results
|
|
60
|
-
|
|
61
|
-
The search endpoint crashed when no results matched.
|
|
62
|
-
Added early return with empty array instead.
|
|
63
|
-
|
|
64
|
-
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## Rejection Criteria
|
|
68
|
-
|
|
69
|
-
- Subject over 50 chars
|
|
70
|
-
- Missing Co-Authored-By line
|
|
71
|
-
- Past tense in subject ("added", "fixed")
|
|
72
|
-
- Subject with period at end
|
|
73
|
-
- No body when change is non-trivial
|
|
1
|
+
# Commit Message Format Rubric
|
|
2
|
+
|
|
3
|
+
## Structure
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
<type>(<scope>): <subject> ← 50 chars max, imperative mood
|
|
7
|
+
← blank line
|
|
8
|
+
<body> ← 72 chars/line wrap, explain WHY
|
|
9
|
+
← blank line
|
|
10
|
+
<footer> ← Co-Authored-By, Closes #N
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Types
|
|
14
|
+
|
|
15
|
+
| Type | When to Use |
|
|
16
|
+
|------|-------------|
|
|
17
|
+
| `feat` | New feature or capability |
|
|
18
|
+
| `fix` | Bug fix |
|
|
19
|
+
| `refactor` | Code restructure, no behavior change |
|
|
20
|
+
| `perf` | Performance improvement |
|
|
21
|
+
| `test` | Adding or fixing tests |
|
|
22
|
+
| `docs` | Documentation only |
|
|
23
|
+
| `style` | Formatting, whitespace (no logic change) |
|
|
24
|
+
| `chore` | Build, deps, tooling, CI |
|
|
25
|
+
|
|
26
|
+
## Subject Line Rules
|
|
27
|
+
|
|
28
|
+
- Imperative mood: "add feature" not "added feature"
|
|
29
|
+
- No period at end
|
|
30
|
+
- Max 50 characters
|
|
31
|
+
- Scope is optional: `feat(auth): add OAuth login`
|
|
32
|
+
|
|
33
|
+
## Body Rules
|
|
34
|
+
|
|
35
|
+
- Explain **why**, not what (code shows what)
|
|
36
|
+
- Wrap at 72 characters
|
|
37
|
+
- Use bullet points for multiple changes
|
|
38
|
+
- Reference issues: `Closes #123`, `Fixes #456`
|
|
39
|
+
|
|
40
|
+
## Required Footer
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Examples
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
feat(auth): add GitHub OAuth login
|
|
50
|
+
|
|
51
|
+
Users can now sign in with GitHub instead of email/password.
|
|
52
|
+
Reduces friction for developer-focused onboarding flow.
|
|
53
|
+
|
|
54
|
+
Closes #42
|
|
55
|
+
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
fix(api): prevent null reference on empty search results
|
|
60
|
+
|
|
61
|
+
The search endpoint crashed when no results matched.
|
|
62
|
+
Added early return with empty array instead.
|
|
63
|
+
|
|
64
|
+
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Rejection Criteria
|
|
68
|
+
|
|
69
|
+
- Subject over 50 chars
|
|
70
|
+
- Missing Co-Authored-By line
|
|
71
|
+
- Past tense in subject ("added", "fixed")
|
|
72
|
+
- Subject with period at end
|
|
73
|
+
- No body when change is non-trivial
|
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# PR Body Template
|
|
2
|
-
|
|
3
|
-
Use this template with `gh pr create --body "$(cat <<'EOF' ... EOF)"`.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Summary
|
|
8
|
-
|
|
9
|
-
- {{CHANGE_1}}
|
|
10
|
-
- {{CHANGE_2}}
|
|
11
|
-
- {{CHANGE_3}}
|
|
12
|
-
|
|
13
|
-
## Motivation
|
|
14
|
-
|
|
15
|
-
{{WHY_THIS_CHANGE — business reason or problem being solved}}
|
|
16
|
-
|
|
17
|
-
## Related Issues
|
|
18
|
-
|
|
19
|
-
- Closes #{{ISSUE_NUMBER}}
|
|
20
|
-
|
|
21
|
-
## Test Plan
|
|
22
|
-
|
|
23
|
-
- [ ] {{TEST_STEP_1}}
|
|
24
|
-
- [ ] {{TEST_STEP_2}}
|
|
25
|
-
- [ ] {{TEST_STEP_3}}
|
|
26
|
-
|
|
27
|
-
## Screenshots / Demo
|
|
28
|
-
|
|
29
|
-
{{ATTACH_SCREENSHOT_OR_REMOVE_SECTION}}
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
33
|
-
{{SESSION_URL}}
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## Usage Notes
|
|
38
|
-
|
|
39
|
-
**Minimal PR (bug fix, chore):**
|
|
40
|
-
|
|
41
|
-
```
|
|
42
|
-
## Summary
|
|
43
|
-
- {{CHANGE}}
|
|
44
|
-
|
|
45
|
-
## Related Issues
|
|
46
|
-
- Fixes #{{ISSUE_NUMBER}}
|
|
47
|
-
|
|
48
|
-
{{SESSION_URL}}
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
**Feature PR:**
|
|
52
|
-
|
|
53
|
-
Use the full template above. Screenshots required for UI changes.
|
|
54
|
-
|
|
55
|
-
**Breaking Change:**
|
|
56
|
-
|
|
57
|
-
Add this section at the top:
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
## BREAKING CHANGE
|
|
61
|
-
|
|
62
|
-
{{WHAT_BREAKS}} — {{MIGRATION_STEPS}}
|
|
63
|
-
```
|
|
1
|
+
# PR Body Template
|
|
2
|
+
|
|
3
|
+
Use this template with `gh pr create --body "$(cat <<'EOF' ... EOF)"`.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Summary
|
|
8
|
+
|
|
9
|
+
- {{CHANGE_1}}
|
|
10
|
+
- {{CHANGE_2}}
|
|
11
|
+
- {{CHANGE_3}}
|
|
12
|
+
|
|
13
|
+
## Motivation
|
|
14
|
+
|
|
15
|
+
{{WHY_THIS_CHANGE — business reason or problem being solved}}
|
|
16
|
+
|
|
17
|
+
## Related Issues
|
|
18
|
+
|
|
19
|
+
- Closes #{{ISSUE_NUMBER}}
|
|
20
|
+
|
|
21
|
+
## Test Plan
|
|
22
|
+
|
|
23
|
+
- [ ] {{TEST_STEP_1}}
|
|
24
|
+
- [ ] {{TEST_STEP_2}}
|
|
25
|
+
- [ ] {{TEST_STEP_3}}
|
|
26
|
+
|
|
27
|
+
## Screenshots / Demo
|
|
28
|
+
|
|
29
|
+
{{ATTACH_SCREENSHOT_OR_REMOVE_SECTION}}
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
{{SESSION_URL}}
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Usage Notes
|
|
38
|
+
|
|
39
|
+
**Minimal PR (bug fix, chore):**
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
## Summary
|
|
43
|
+
- {{CHANGE}}
|
|
44
|
+
|
|
45
|
+
## Related Issues
|
|
46
|
+
- Fixes #{{ISSUE_NUMBER}}
|
|
47
|
+
|
|
48
|
+
{{SESSION_URL}}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
**Feature PR:**
|
|
52
|
+
|
|
53
|
+
Use the full template above. Screenshots required for UI changes.
|
|
54
|
+
|
|
55
|
+
**Breaking Change:**
|
|
56
|
+
|
|
57
|
+
Add this section at the top:
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
## BREAKING CHANGE
|
|
61
|
+
|
|
62
|
+
{{WHAT_BREAKS}} — {{MIGRATION_STEPS}}
|
|
63
|
+
```
|
|
@@ -1,106 +1,106 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: context7-usage
|
|
3
|
-
tier: optional
|
|
4
|
-
description: "Context7 plugin for latest library documentation. Auto-activates when docs, documentation, latest version, official docs, API reference, or library help is needed."
|
|
5
|
-
triggers: [docs, documentation, latest version, official docs, API reference, library help, context7]
|
|
6
|
-
priority: 60
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Context7 Usage
|
|
10
|
-
|
|
11
|
-
Guide for searching latest library/framework documentation using Context7 plugin with subagent isolation.
|
|
12
|
-
|
|
13
|
-
## Why Subagent Approach?
|
|
14
|
-
|
|
15
|
-
| Approach | Problem |
|
|
16
|
-
|----------|---------|
|
|
17
|
-
| Direct plugin call | Docs content fills main context, causing bloat |
|
|
18
|
-
| Subagent isolation | Docs queried in separate context, only results returned |
|
|
19
|
-
|
|
20
|
-
**Benefits:**
|
|
21
|
-
|
|
22
|
-
- Prevents context bloat during long coding sessions
|
|
23
|
-
- Solves knowledge cutoff problem with latest docs
|
|
24
|
-
- Main context stays focused on implementation
|
|
25
|
-
|
|
26
|
-
## When to Use
|
|
27
|
-
|
|
28
|
-
| Situation | Example |
|
|
29
|
-
|-----------|---------|
|
|
30
|
-
| Latest API check | "React 19 use() hook usage" |
|
|
31
|
-
| Version differences | "Next.js 15 changes" |
|
|
32
|
-
| Official docs needed | "Prisma schema syntax" |
|
|
33
|
-
| Migration guide | "Vue 2 → Vue 3 migration" |
|
|
34
|
-
|
|
35
|
-
## How It Works
|
|
36
|
-
|
|
37
|
-
```
|
|
38
|
-
User asks library question
|
|
39
|
-
↓
|
|
40
|
-
Skill detects docs need
|
|
41
|
-
↓
|
|
42
|
-
Spawn docs-researcher subagent (haiku)
|
|
43
|
-
↓
|
|
44
|
-
Subagent calls context7 in isolated context
|
|
45
|
-
↓
|
|
46
|
-
Returns only relevant info to main context
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## Usage
|
|
50
|
-
|
|
51
|
-
### Automatic (Recommended)
|
|
52
|
-
|
|
53
|
-
Just ask library/API questions naturally:
|
|
54
|
-
|
|
55
|
-
```
|
|
56
|
-
"How do I use React 19 use() hook?"
|
|
57
|
-
"What's new in Next.js 15?"
|
|
58
|
-
"Prisma many-to-many relation syntax"
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
The skill auto-detects and spawns a docs-researcher subagent.
|
|
62
|
-
|
|
63
|
-
### Manual Command
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
/context7:docs <library> [query]
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
Examples:
|
|
70
|
-
|
|
71
|
-
```
|
|
72
|
-
/context7:docs react hooks
|
|
73
|
-
/context7:docs next.js app router
|
|
74
|
-
/context7:docs prisma relations
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Implementation Pattern
|
|
78
|
-
|
|
79
|
-
When you detect a library/API documentation need, spawn a subagent:
|
|
80
|
-
|
|
81
|
-
```
|
|
82
|
-
Task tool call:
|
|
83
|
-
- subagent_type: Explore
|
|
84
|
-
- model: haiku
|
|
85
|
-
- prompt: "Use context7 to find [library] documentation about [topic]. Return only the relevant API usage examples and key points."
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
The subagent handles the context7 calls and returns a summary, keeping main context clean.
|
|
89
|
-
|
|
90
|
-
## Fallback Chain
|
|
91
|
-
|
|
92
|
-
```
|
|
93
|
-
context7 plugin not installed
|
|
94
|
-
↓
|
|
95
|
-
Prompt user: /plugin install context7
|
|
96
|
-
↓
|
|
97
|
-
If still unavailable: Web Search for official docs
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
## Installation
|
|
101
|
-
|
|
102
|
-
If context7 is not installed, guide user:
|
|
103
|
-
|
|
104
|
-
```bash
|
|
105
|
-
/plugin install context7
|
|
106
|
-
```
|
|
1
|
+
---
|
|
2
|
+
name: context7-usage
|
|
3
|
+
tier: optional
|
|
4
|
+
description: "Context7 plugin for latest library documentation. Auto-activates when docs, documentation, latest version, official docs, API reference, or library help is needed."
|
|
5
|
+
triggers: [docs, documentation, latest version, official docs, API reference, library help, context7]
|
|
6
|
+
priority: 60
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Context7 Usage
|
|
10
|
+
|
|
11
|
+
Guide for searching latest library/framework documentation using Context7 plugin with subagent isolation.
|
|
12
|
+
|
|
13
|
+
## Why Subagent Approach?
|
|
14
|
+
|
|
15
|
+
| Approach | Problem |
|
|
16
|
+
|----------|---------|
|
|
17
|
+
| Direct plugin call | Docs content fills main context, causing bloat |
|
|
18
|
+
| Subagent isolation | Docs queried in separate context, only results returned |
|
|
19
|
+
|
|
20
|
+
**Benefits:**
|
|
21
|
+
|
|
22
|
+
- Prevents context bloat during long coding sessions
|
|
23
|
+
- Solves knowledge cutoff problem with latest docs
|
|
24
|
+
- Main context stays focused on implementation
|
|
25
|
+
|
|
26
|
+
## When to Use
|
|
27
|
+
|
|
28
|
+
| Situation | Example |
|
|
29
|
+
|-----------|---------|
|
|
30
|
+
| Latest API check | "React 19 use() hook usage" |
|
|
31
|
+
| Version differences | "Next.js 15 changes" |
|
|
32
|
+
| Official docs needed | "Prisma schema syntax" |
|
|
33
|
+
| Migration guide | "Vue 2 → Vue 3 migration" |
|
|
34
|
+
|
|
35
|
+
## How It Works
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
User asks library question
|
|
39
|
+
↓
|
|
40
|
+
Skill detects docs need
|
|
41
|
+
↓
|
|
42
|
+
Spawn docs-researcher subagent (haiku)
|
|
43
|
+
↓
|
|
44
|
+
Subagent calls context7 in isolated context
|
|
45
|
+
↓
|
|
46
|
+
Returns only relevant info to main context
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Usage
|
|
50
|
+
|
|
51
|
+
### Automatic (Recommended)
|
|
52
|
+
|
|
53
|
+
Just ask library/API questions naturally:
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
"How do I use React 19 use() hook?"
|
|
57
|
+
"What's new in Next.js 15?"
|
|
58
|
+
"Prisma many-to-many relation syntax"
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
The skill auto-detects and spawns a docs-researcher subagent.
|
|
62
|
+
|
|
63
|
+
### Manual Command
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
/context7:docs <library> [query]
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Examples:
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
/context7:docs react hooks
|
|
73
|
+
/context7:docs next.js app router
|
|
74
|
+
/context7:docs prisma relations
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Implementation Pattern
|
|
78
|
+
|
|
79
|
+
When you detect a library/API documentation need, spawn a subagent:
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
Task tool call:
|
|
83
|
+
- subagent_type: Explore
|
|
84
|
+
- model: haiku
|
|
85
|
+
- prompt: "Use context7 to find [library] documentation about [topic]. Return only the relevant API usage examples and key points."
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
The subagent handles the context7 calls and returns a summary, keeping main context clean.
|
|
89
|
+
|
|
90
|
+
## Fallback Chain
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
context7 plugin not installed
|
|
94
|
+
↓
|
|
95
|
+
Prompt user: /plugin install context7
|
|
96
|
+
↓
|
|
97
|
+
If still unavailable: Web Search for official docs
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Installation
|
|
101
|
+
|
|
102
|
+
If context7 is not installed, guide user:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
/plugin install context7
|
|
106
|
+
```
|