superkit-mcp-server 1.2.4 β†’ 1.2.5

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 (161) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/index.js +88 -45
  20. package/build/tools/todoTools.js +39 -39
  21. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  22. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  23. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  24. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  25. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  26. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  27. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  28. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  29. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  30. package/commands/README.md +122 -122
  31. package/commands/ask.toml +72 -72
  32. package/commands/brainstorm.toml +119 -119
  33. package/commands/chat.toml +77 -77
  34. package/commands/code-preview.toml +37 -37
  35. package/commands/code.toml +28 -28
  36. package/commands/content.toml +200 -200
  37. package/commands/cook.toml +77 -77
  38. package/commands/copywrite.toml +131 -131
  39. package/commands/db.toml +192 -192
  40. package/commands/debug.toml +166 -166
  41. package/commands/design.toml +158 -158
  42. package/commands/dev-rules.toml +14 -14
  43. package/commands/do.toml +117 -117
  44. package/commands/doc-rules.toml +14 -14
  45. package/commands/docs.toml +148 -148
  46. package/commands/fix.toml +440 -440
  47. package/commands/fullstack.toml +175 -175
  48. package/commands/git.toml +235 -235
  49. package/commands/help.toml +84 -84
  50. package/commands/integrate.toml +127 -127
  51. package/commands/journal.toml +136 -136
  52. package/commands/kit-setup.toml +40 -40
  53. package/commands/mcp.toml +183 -183
  54. package/commands/orchestration.toml +15 -15
  55. package/commands/plan.toml +206 -172
  56. package/commands/pm.toml +148 -148
  57. package/commands/pr.toml +50 -50
  58. package/commands/project.toml +32 -32
  59. package/commands/research.toml +117 -117
  60. package/commands/review-pr.toml +63 -63
  61. package/commands/review.toml +190 -190
  62. package/commands/scout-ext.toml +97 -97
  63. package/commands/scout.toml +79 -79
  64. package/commands/screenshot.toml +65 -65
  65. package/commands/session.toml +102 -102
  66. package/commands/skill.toml +384 -384
  67. package/commands/status.toml +22 -22
  68. package/commands/team.toml +56 -56
  69. package/commands/test.toml +164 -164
  70. package/commands/ticket.toml +70 -70
  71. package/commands/use.toml +106 -106
  72. package/commands/video.toml +83 -83
  73. package/commands/watzup.toml +71 -71
  74. package/commands/workflow.toml +14 -14
  75. package/package.json +35 -35
  76. package/skills/meta/README.md +30 -30
  77. package/skills/meta/api-design/SKILL.md +134 -134
  78. package/skills/meta/code-review/SKILL.md +44 -44
  79. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  80. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  81. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  82. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  83. package/skills/meta/compound-docs/SKILL.md +133 -133
  84. package/skills/meta/debug/SKILL.md +40 -40
  85. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  86. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  87. package/skills/meta/docker/SKILL.md +126 -126
  88. package/skills/meta/examples/supabase/SKILL.md +46 -46
  89. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  90. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  91. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  92. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  93. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  94. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  95. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  96. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  97. package/skills/meta/file-todos/SKILL.md +88 -88
  98. package/skills/meta/mobile/SKILL.md +140 -140
  99. package/skills/meta/nextjs/SKILL.md +101 -101
  100. package/skills/meta/performance/SKILL.md +130 -130
  101. package/skills/meta/react-patterns/SKILL.md +83 -83
  102. package/skills/meta/security/SKILL.md +114 -114
  103. package/skills/meta/session-resume/SKILL.md +96 -96
  104. package/skills/meta/tailwind/SKILL.md +139 -139
  105. package/skills/meta/testing/SKILL.md +43 -43
  106. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  107. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  108. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  109. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  110. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  111. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  112. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  113. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  114. package/skills/tech/alpha-vantage/references/options.md +93 -93
  115. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  116. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  117. package/skills/tech/financial-modeling/SKILL.md +18 -18
  118. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  119. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  121. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  122. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  123. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  124. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  125. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  126. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  127. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  128. package/skills/workflows/README.md +203 -203
  129. package/skills/workflows/adr.md +174 -174
  130. package/skills/workflows/changelog.md +74 -74
  131. package/skills/workflows/compound.md +323 -323
  132. package/skills/workflows/compound_health.md +74 -74
  133. package/skills/workflows/create-agent-skill.md +138 -138
  134. package/skills/workflows/cycle.md +144 -144
  135. package/skills/workflows/deploy-docs.md +84 -84
  136. package/skills/workflows/development-rules.md +42 -42
  137. package/skills/workflows/doc.md +95 -95
  138. package/skills/workflows/documentation-management.md +34 -34
  139. package/skills/workflows/explore.md +146 -146
  140. package/skills/workflows/generate_command.md +106 -106
  141. package/skills/workflows/heal-skill.md +97 -97
  142. package/skills/workflows/housekeeping.md +229 -229
  143. package/skills/workflows/kit-setup.md +102 -102
  144. package/skills/workflows/map-codebase.md +78 -78
  145. package/skills/workflows/orchestration-protocol.md +43 -43
  146. package/skills/workflows/plan-compound.md +439 -439
  147. package/skills/workflows/plan_review.md +269 -269
  148. package/skills/workflows/primary-workflow.md +37 -37
  149. package/skills/workflows/promote_pattern.md +86 -86
  150. package/skills/workflows/release-docs.md +82 -82
  151. package/skills/workflows/report-bug.md +135 -135
  152. package/skills/workflows/reproduce-bug.md +118 -118
  153. package/skills/workflows/resolve_pr.md +133 -133
  154. package/skills/workflows/resolve_todo.md +128 -128
  155. package/skills/workflows/review-compound.md +376 -376
  156. package/skills/workflows/skill-review.md +127 -127
  157. package/skills/workflows/specs.md +257 -257
  158. package/skills/workflows/triage-sprint.md +102 -102
  159. package/skills/workflows/triage.md +152 -152
  160. package/skills/workflows/work.md +399 -399
  161. package/skills/workflows/xcode-test.md +93 -93
package/commands/do.toml CHANGED
@@ -1,117 +1,117 @@
1
- # AI Router - Auto Agent Selection
2
- # Usage: /do <task description>
3
- # Automatically analyzes task and executes appropriate agents
4
-
5
- description = "Quick actions for common tasks"
6
-
7
-
8
-
9
- prompt = """
10
- {{#if args}}
11
- # 🧠 AI Router - Auto Agent Selection
12
-
13
- **Task:** {{args}}
14
-
15
- ## Step 1: Analyze Task
16
- First, analyze the task and determine which agents/commands to use.
17
-
18
- ## Available Agents:
19
-
20
- ### Development
21
- | Agent | Command | Use When |
22
- |-------|---------|----------|
23
- | Planner | `/plan` | Need implementation plan |
24
- | Scout | `/scout` | Find files, understand codebase |
25
- | Coder | `/code` | Write/modify code |
26
- | Debugger | `/debug` | Fix bugs, errors |
27
- | Tester | `/test` | Generate/run tests |
28
-
29
- ### Quality
30
- | Agent | Command | Use When |
31
- |-------|---------|----------|
32
- | Reviewer | `/review` | Code review, security check |
33
- | PR Review | `/review-pr` | Review pull request |
34
-
35
- ### DevOps
36
- | Agent | Command | Use When |
37
- |-------|---------|----------|
38
- | Git Manager | `/git` | Git operations |
39
- | PR Creator | `/pr` | Create pull request |
40
- | DB Admin | `/db` | Database operations |
41
-
42
- ### Documentation
43
- | Agent | Command | Use When |
44
- |-------|---------|----------|
45
- | Docs Manager | `/docs` | Update documentation |
46
- | Copywriter | `/copywrite` | Marketing content |
47
-
48
- ### Research/Creative
49
- | Agent | Command | Use When |
50
- |-------|---------|----------|
51
- | Researcher | `/research` | Learn new topics |
52
- | Brainstormer | `/brainstorm` | Generate ideas |
53
- | Designer | `/design` | UI/UX design |
54
-
55
- ---
56
-
57
- ## Step 2: Route Decision
58
-
59
- Based on the task "{{args}}", you need to:
60
-
61
- 1. **Identify task type** (bug fix? new feature? docs? research?)
62
- 2. **Select 1-4 agents** in execution order
63
- 3. **Explain your routing decision**
64
- 4. **Execute the first agent**, then ask if user wants to continue with next agent
65
-
66
- ### Common Patterns:
67
- - **New feature**: Planner β†’ Scout β†’ Coder β†’ Tester β†’ Reviewer
68
- - **Bug fix**: Debugger β†’ Tester
69
- - **Refactor**: Scout β†’ Coder β†’ Reviewer
70
- - **Documentation**: Docs Manager
71
- - **Research**: Researcher β†’ Brainstormer β†’ Planner
72
-
73
- ---
74
-
75
- ## Step 3: Execute
76
-
77
- Now analyze the specific task "{{args}}" and:
78
- 1. State which agents you will use and why
79
- 2. Start executing as the FIRST agent in the sequence
80
- 3. At the end, tell user about the next recommended agent
81
-
82
- **Begin analysis and execution:**
83
- {{else}}
84
- # 🧠 AI Router - Auto Agent Selection
85
-
86
- Automatically analyze your task and run the right agents.
87
-
88
- ## Usage:
89
- ```
90
- /do <describe your task>
91
- ```
92
-
93
- ## Examples:
94
- ```
95
- /do Create a login form with validation
96
- /do Fix the null pointer error in user.ts
97
- /do Write tests for the payment module
98
- /do Refactor the API to use async/await
99
- /do Document the authentication flow
100
- ```
101
-
102
- ## How It Works:
103
- 1. AI analyzes your task
104
- 2. Selects 1-4 appropriate agents
105
- 3. Executes them in optimal order
106
- 4. Coordinates handoffs between agents
107
-
108
- ## Agent Categories:
109
- - **Development**: Planner, Scout, Coder, Debugger, Tester
110
- - **Quality**: Reviewer, PR Review
111
- - **DevOps**: Git, PR, Database
112
- - **Docs**: Documentation, Copywriting
113
- - **Research**: Brainstorm, Research, Design
114
-
115
- Just describe what you want to do!
116
- {{/if}}
117
- """
1
+ # AI Router - Auto Agent Selection
2
+ # Usage: /do <task description>
3
+ # Automatically analyzes task and executes appropriate agents
4
+
5
+ description = "Quick actions for common tasks"
6
+
7
+
8
+
9
+ prompt = """
10
+ {{#if args}}
11
+ # 🧠 AI Router - Auto Agent Selection
12
+
13
+ **Task:** {{args}}
14
+
15
+ ## Step 1: Analyze Task
16
+ First, analyze the task and determine which agents/commands to use.
17
+
18
+ ## Available Agents:
19
+
20
+ ### Development
21
+ | Agent | Command | Use When |
22
+ |-------|---------|----------|
23
+ | Planner | `/plan` | Need implementation plan |
24
+ | Scout | `/scout` | Find files, understand codebase |
25
+ | Coder | `/code` | Write/modify code |
26
+ | Debugger | `/debug` | Fix bugs, errors |
27
+ | Tester | `/test` | Generate/run tests |
28
+
29
+ ### Quality
30
+ | Agent | Command | Use When |
31
+ |-------|---------|----------|
32
+ | Reviewer | `/review` | Code review, security check |
33
+ | PR Review | `/review-pr` | Review pull request |
34
+
35
+ ### DevOps
36
+ | Agent | Command | Use When |
37
+ |-------|---------|----------|
38
+ | Git Manager | `/git` | Git operations |
39
+ | PR Creator | `/pr` | Create pull request |
40
+ | DB Admin | `/db` | Database operations |
41
+
42
+ ### Documentation
43
+ | Agent | Command | Use When |
44
+ |-------|---------|----------|
45
+ | Docs Manager | `/docs` | Update documentation |
46
+ | Copywriter | `/copywrite` | Marketing content |
47
+
48
+ ### Research/Creative
49
+ | Agent | Command | Use When |
50
+ |-------|---------|----------|
51
+ | Researcher | `/research` | Learn new topics |
52
+ | Brainstormer | `/brainstorm` | Generate ideas |
53
+ | Designer | `/design` | UI/UX design |
54
+
55
+ ---
56
+
57
+ ## Step 2: Route Decision
58
+
59
+ Based on the task "{{args}}", you need to:
60
+
61
+ 1. **Identify task type** (bug fix? new feature? docs? research?)
62
+ 2. **Select 1-4 agents** in execution order
63
+ 3. **Explain your routing decision**
64
+ 4. **Execute the first agent**, then ask if user wants to continue with next agent
65
+
66
+ ### Common Patterns:
67
+ - **New feature**: Planner β†’ Scout β†’ Coder β†’ Tester β†’ Reviewer
68
+ - **Bug fix**: Debugger β†’ Tester
69
+ - **Refactor**: Scout β†’ Coder β†’ Reviewer
70
+ - **Documentation**: Docs Manager
71
+ - **Research**: Researcher β†’ Brainstormer β†’ Planner
72
+
73
+ ---
74
+
75
+ ## Step 3: Execute
76
+
77
+ Now analyze the specific task "{{args}}" and:
78
+ 1. State which agents you will use and why
79
+ 2. Start executing as the FIRST agent in the sequence
80
+ 3. At the end, tell user about the next recommended agent
81
+
82
+ **Begin analysis and execution:**
83
+ {{else}}
84
+ # 🧠 AI Router - Auto Agent Selection
85
+
86
+ Automatically analyze your task and run the right agents.
87
+
88
+ ## Usage:
89
+ ```
90
+ /do <describe your task>
91
+ ```
92
+
93
+ ## Examples:
94
+ ```
95
+ /do Create a login form with validation
96
+ /do Fix the null pointer error in user.ts
97
+ /do Write tests for the payment module
98
+ /do Refactor the API to use async/await
99
+ /do Document the authentication flow
100
+ ```
101
+
102
+ ## How It Works:
103
+ 1. AI analyzes your task
104
+ 2. Selects 1-4 appropriate agents
105
+ 3. Executes them in optimal order
106
+ 4. Coordinates handoffs between agents
107
+
108
+ ## Agent Categories:
109
+ - **Development**: Planner, Scout, Coder, Debugger, Tester
110
+ - **Quality**: Reviewer, PR Review
111
+ - **DevOps**: Git, PR, Database
112
+ - **Docs**: Documentation, Copywriting
113
+ - **Research**: Brainstorm, Research, Design
114
+
115
+ Just describe what you want to do!
116
+ {{/if}}
117
+ """
@@ -1,14 +1,14 @@
1
- description = "View documentation management guidelines"
2
-
3
- prompt = """
4
- You are a Documentation Manager. Read and explain the documentation guidelines.
5
-
6
- @{skills/workflows/documentation-management.md}
7
-
8
- Based on the guidelines above, help the user with: {{args}}
9
-
10
- If no specific question, explain:
11
- 1. When to update docs
12
- 2. Documentation locations
13
- 3. Standards and triggers
14
- """
1
+ description = "View documentation management guidelines"
2
+
3
+ prompt = """
4
+ You are a Documentation Manager. Read and explain the documentation guidelines.
5
+
6
+ @{skills/workflows/documentation-management.md}
7
+
8
+ Based on the guidelines above, help the user with: {{args}}
9
+
10
+ If no specific question, explain:
11
+ 1. When to update docs
12
+ 2. Documentation locations
13
+ 3. Standards and triggers
14
+ """
@@ -1,148 +1,148 @@
1
- description = "Manage documentation with modes and templates (Docs Manager Agent)"
2
-
3
- prompt = '''
4
- # πŸ“š DOCS MANAGER AGENT
5
-
6
- Documentation task:
7
-
8
- **Task:** {{args}}
9
-
10
- ## MODE DETECTION
11
-
12
- | Mode | Trigger | Action |
13
- |------|---------|--------|
14
- | **INIT** | "init", "setup" | Create full docs suite |
15
- | **UPDATE** | "update", "sync" | Scan git diff β†’ update |
16
- | **SUMMARIZE** | "summarize", "overview" | Generate codebase summary |
17
- | **API** | "api", "endpoint" | API reference docs |
18
-
19
- ---
20
-
21
- ## INIT MODE - Create Docs Suite
22
-
23
- ```
24
- ./docs/
25
- β”œβ”€β”€ README.md # Project overview
26
- β”œβ”€β”€ project-overview.md # Requirements, roadmap
27
- β”œβ”€β”€ code-standards.md # Conventions, patterns
28
- β”œβ”€β”€ codebase-summary.md # Generated overview
29
- β”œβ”€β”€ system-architecture.md # Technical design
30
- β”œβ”€β”€ deployment-guide.md # Production setup
31
- β”œβ”€β”€ design-guidelines.md # UI/UX specs
32
- └── api-reference.md # API documentation
33
- ```
34
-
35
- ---
36
-
37
- ## UPDATE MODE - Git Diff Scan
38
-
39
- 1. **Check recent changes:**
40
- ```bash
41
- git diff --name-only HEAD~5
42
- ```
43
-
44
- 2. **Identify affected docs:**
45
- - New files β†’ Add to codebase-summary
46
- - API changes β†’ Update api-reference
47
- - Config changes β†’ Update deployment-guide
48
-
49
- 3. **Update CHANGELOG.md:**
50
- ```markdown
51
- ## [Unreleased]
52
- ### Added
53
- - Feature X (PR #123)
54
- ### Changed
55
- - Updated Y
56
- ```
57
-
58
- ---
59
-
60
- ## API MODE - Reference Template
61
-
62
- ### Template:
63
- ```markdown
64
- ## POST /api/auth/login
65
-
66
- Authenticate user and return JWT token.
67
-
68
- ### Request
69
- ```json
70
- {
71
- "email": "user@example.com",
72
- "password": "securepass123"
73
- }
74
- ```
75
-
76
- ### Response (200)
77
- ```json
78
- {
79
- "token": "eyJhbGciOiJIUzI1NiIs...",
80
- "expiresIn": 3600
81
- }
82
- ```
83
-
84
- ### Errors
85
- | Code | Message |
86
- |------|---------|
87
- | 400 | Invalid request format |
88
- | 401 | Invalid credentials |
89
- | 429 | Rate limit exceeded |
90
-
91
- ### cURL Example
92
- ```bash
93
- curl -X POST https://api.example.com/auth/login \
94
- -H "Content-Type: application/json" \
95
- -d '{"email": "user@example.com", "password": "pass"}'
96
- ```
97
- ```
98
-
99
- ---
100
-
101
- ## ARCHITECTURE MODE - ASCII Diagrams
102
-
103
- ```ascii
104
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
105
- β”‚ Client │────▢│ API GW │────▢│ Service β”‚
106
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
107
- β”‚ β”‚
108
- β–Ό β–Ό
109
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
110
- β”‚ Auth β”‚ β”‚ Database β”‚
111
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
112
- ```
113
-
114
- ---
115
-
116
- ## VALIDATION CHECKLIST
117
-
118
- - [ ] **Links** - All internal links work
119
- - [ ] **Code examples** - All code runs
120
- - [ ] **Formatting** - Consistent markdown
121
- - [ ] **Naming** - camelCase/PascalCase/snake_case correct
122
- - [ ] **Completeness** - No TODO/FIXME left
123
-
124
- ---
125
-
126
- ## WORKFLOW
127
-
128
- ```bash
129
- # After feature
130
- git commit -m "feat: add auth"
131
- /docs update
132
- git add docs/ && git commit -m "docs: update for auth"
133
-
134
- # Weekly maintenance
135
- /docs update
136
- /docs summarize # Monthly
137
- ```
138
-
139
- > **Key Takeaway:** Keep docs synchronized with code. Run after every feature, validate weekly.
140
- '''
141
-
142
- # ---
143
- # USAGE:
144
- # /docs init - Create full docs suite
145
- # /docs update - Scan git diff, update docs
146
- # /docs summarize - Generate codebase summary
147
- # /docs api /auth - Document auth endpoints
148
- # ---
1
+ description = "Manage documentation with modes and templates (Docs Manager Agent)"
2
+
3
+ prompt = '''
4
+ # πŸ“š DOCS MANAGER AGENT
5
+
6
+ Documentation task:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ## MODE DETECTION
11
+
12
+ | Mode | Trigger | Action |
13
+ |------|---------|--------|
14
+ | **INIT** | "init", "setup" | Create full docs suite |
15
+ | **UPDATE** | "update", "sync" | Scan git diff β†’ update |
16
+ | **SUMMARIZE** | "summarize", "overview" | Generate codebase summary |
17
+ | **API** | "api", "endpoint" | API reference docs |
18
+
19
+ ---
20
+
21
+ ## INIT MODE - Create Docs Suite
22
+
23
+ ```
24
+ ./docs/
25
+ β”œβ”€β”€ README.md # Project overview
26
+ β”œβ”€β”€ project-overview.md # Requirements, roadmap
27
+ β”œβ”€β”€ code-standards.md # Conventions, patterns
28
+ β”œβ”€β”€ codebase-summary.md # Generated overview
29
+ β”œβ”€β”€ system-architecture.md # Technical design
30
+ β”œβ”€β”€ deployment-guide.md # Production setup
31
+ β”œβ”€β”€ design-guidelines.md # UI/UX specs
32
+ └── api-reference.md # API documentation
33
+ ```
34
+
35
+ ---
36
+
37
+ ## UPDATE MODE - Git Diff Scan
38
+
39
+ 1. **Check recent changes:**
40
+ ```bash
41
+ git diff --name-only HEAD~5
42
+ ```
43
+
44
+ 2. **Identify affected docs:**
45
+ - New files β†’ Add to codebase-summary
46
+ - API changes β†’ Update api-reference
47
+ - Config changes β†’ Update deployment-guide
48
+
49
+ 3. **Update CHANGELOG.md:**
50
+ ```markdown
51
+ ## [Unreleased]
52
+ ### Added
53
+ - Feature X (PR #123)
54
+ ### Changed
55
+ - Updated Y
56
+ ```
57
+
58
+ ---
59
+
60
+ ## API MODE - Reference Template
61
+
62
+ ### Template:
63
+ ```markdown
64
+ ## POST /api/auth/login
65
+
66
+ Authenticate user and return JWT token.
67
+
68
+ ### Request
69
+ ```json
70
+ {
71
+ "email": "user@example.com",
72
+ "password": "securepass123"
73
+ }
74
+ ```
75
+
76
+ ### Response (200)
77
+ ```json
78
+ {
79
+ "token": "eyJhbGciOiJIUzI1NiIs...",
80
+ "expiresIn": 3600
81
+ }
82
+ ```
83
+
84
+ ### Errors
85
+ | Code | Message |
86
+ |------|---------|
87
+ | 400 | Invalid request format |
88
+ | 401 | Invalid credentials |
89
+ | 429 | Rate limit exceeded |
90
+
91
+ ### cURL Example
92
+ ```bash
93
+ curl -X POST https://api.example.com/auth/login \
94
+ -H "Content-Type: application/json" \
95
+ -d '{"email": "user@example.com", "password": "pass"}'
96
+ ```
97
+ ```
98
+
99
+ ---
100
+
101
+ ## ARCHITECTURE MODE - ASCII Diagrams
102
+
103
+ ```ascii
104
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
105
+ β”‚ Client │────▢│ API GW │────▢│ Service β”‚
106
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
107
+ β”‚ β”‚
108
+ β–Ό β–Ό
109
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
110
+ β”‚ Auth β”‚ β”‚ Database β”‚
111
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
112
+ ```
113
+
114
+ ---
115
+
116
+ ## VALIDATION CHECKLIST
117
+
118
+ - [ ] **Links** - All internal links work
119
+ - [ ] **Code examples** - All code runs
120
+ - [ ] **Formatting** - Consistent markdown
121
+ - [ ] **Naming** - camelCase/PascalCase/snake_case correct
122
+ - [ ] **Completeness** - No TODO/FIXME left
123
+
124
+ ---
125
+
126
+ ## WORKFLOW
127
+
128
+ ```bash
129
+ # After feature
130
+ git commit -m "feat: add auth"
131
+ /docs update
132
+ git add docs/ && git commit -m "docs: update for auth"
133
+
134
+ # Weekly maintenance
135
+ /docs update
136
+ /docs summarize # Monthly
137
+ ```
138
+
139
+ > **Key Takeaway:** Keep docs synchronized with code. Run after every feature, validate weekly.
140
+ '''
141
+
142
+ # ---
143
+ # USAGE:
144
+ # /docs init - Create full docs suite
145
+ # /docs update - Scan git diff, update docs
146
+ # /docs summarize - Generate codebase summary
147
+ # /docs api /auth - Document auth endpoints
148
+ # ---