superkit-mcp-server 1.2.1 β†’ 1.2.3

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 (170) 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/security-auditor.md +3 -2
  18. package/agents/tester.md +274 -274
  19. package/agents/ui-designer.md +208 -208
  20. package/build/index.js +21 -2
  21. package/build/tools/__tests__/loggerTools.test.js +5 -5
  22. package/build/tools/archTools.js +2 -19
  23. package/build/tools/autoPreview.js +2 -2
  24. package/build/tools/compoundTools.js +4 -4
  25. package/build/tools/docsTools.js +5 -10
  26. package/build/tools/loggerTools.js +1 -1
  27. package/build/tools/todoTools.js +39 -39
  28. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  29. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  30. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  31. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  32. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  33. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  34. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  35. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  36. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  37. package/build/tools/validators/convertRules.js +2 -2
  38. package/commands/README.md +122 -122
  39. package/commands/ask.toml +72 -72
  40. package/commands/brainstorm.toml +119 -119
  41. package/commands/chat.toml +77 -77
  42. package/commands/code-preview.toml +37 -37
  43. package/commands/code.toml +28 -28
  44. package/commands/content.toml +200 -200
  45. package/commands/cook.toml +77 -77
  46. package/commands/copywrite.toml +131 -131
  47. package/commands/db.toml +192 -192
  48. package/commands/debug.toml +166 -166
  49. package/commands/design.toml +158 -158
  50. package/commands/dev-rules.toml +14 -14
  51. package/commands/do.toml +117 -117
  52. package/commands/doc-rules.toml +14 -14
  53. package/commands/docs.toml +148 -148
  54. package/commands/fix.toml +440 -440
  55. package/commands/fullstack.toml +175 -175
  56. package/commands/git.toml +235 -235
  57. package/commands/help.toml +84 -84
  58. package/commands/integrate.toml +127 -127
  59. package/commands/journal.toml +136 -136
  60. package/commands/kit-setup.toml +40 -40
  61. package/commands/mcp.toml +183 -183
  62. package/commands/orchestration.toml +15 -15
  63. package/commands/plan.toml +171 -171
  64. package/commands/pm.toml +148 -148
  65. package/commands/pr.toml +50 -50
  66. package/commands/project.toml +32 -32
  67. package/commands/research.toml +117 -117
  68. package/commands/review-pr.toml +63 -63
  69. package/commands/review.toml +190 -190
  70. package/commands/scout-ext.toml +97 -97
  71. package/commands/scout.toml +79 -79
  72. package/commands/screenshot.toml +65 -65
  73. package/commands/session.toml +102 -102
  74. package/commands/skill.toml +384 -384
  75. package/commands/status.toml +22 -22
  76. package/commands/team.toml +56 -56
  77. package/commands/test.toml +164 -164
  78. package/commands/ticket.toml +70 -70
  79. package/commands/use.toml +106 -106
  80. package/commands/video.toml +83 -83
  81. package/commands/watzup.toml +71 -71
  82. package/commands/workflow.toml +14 -14
  83. package/package.json +35 -35
  84. package/skills/meta/README.md +30 -30
  85. package/skills/meta/api-design/SKILL.md +134 -134
  86. package/skills/meta/code-review/SKILL.md +44 -44
  87. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  88. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  89. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  90. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  91. package/skills/meta/compound-docs/SKILL.md +133 -133
  92. package/skills/meta/debug/SKILL.md +40 -40
  93. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  94. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  95. package/skills/meta/docker/SKILL.md +126 -126
  96. package/skills/meta/examples/supabase/SKILL.md +46 -46
  97. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  98. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  99. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  100. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  101. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  102. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  103. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  104. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  105. package/skills/meta/file-todos/SKILL.md +88 -88
  106. package/skills/meta/mobile/SKILL.md +140 -140
  107. package/skills/meta/nextjs/SKILL.md +101 -101
  108. package/skills/meta/performance/SKILL.md +130 -130
  109. package/skills/meta/react-patterns/SKILL.md +83 -83
  110. package/skills/meta/security/SKILL.md +114 -114
  111. package/skills/meta/session-resume/SKILL.md +96 -96
  112. package/skills/meta/tailwind/SKILL.md +139 -139
  113. package/skills/meta/testing/SKILL.md +43 -43
  114. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  115. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  116. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  117. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  118. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  119. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  120. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  121. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  122. package/skills/tech/alpha-vantage/references/options.md +93 -93
  123. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  124. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  125. package/skills/tech/doc.md +6 -6
  126. package/skills/tech/financial-modeling/SKILL.md +18 -18
  127. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  128. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  129. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  130. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  131. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  132. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  133. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  134. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  135. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  136. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  137. package/skills/workflows/README.md +203 -203
  138. package/skills/workflows/adr.md +174 -174
  139. package/skills/workflows/changelog.md +74 -74
  140. package/skills/workflows/compound.md +323 -323
  141. package/skills/workflows/compound_health.md +74 -74
  142. package/skills/workflows/create-agent-skill.md +138 -139
  143. package/skills/workflows/cycle.md +144 -144
  144. package/skills/workflows/deploy-docs.md +84 -84
  145. package/skills/workflows/development-rules.md +42 -42
  146. package/skills/workflows/doc.md +95 -95
  147. package/skills/workflows/documentation-management.md +34 -34
  148. package/skills/workflows/explore.md +146 -146
  149. package/skills/workflows/generate_command.md +106 -106
  150. package/skills/workflows/heal-skill.md +97 -97
  151. package/skills/workflows/housekeeping.md +229 -229
  152. package/skills/workflows/kit-setup.md +102 -102
  153. package/skills/workflows/map-codebase.md +78 -78
  154. package/skills/workflows/orchestration-protocol.md +43 -43
  155. package/skills/workflows/plan-compound.md +439 -439
  156. package/skills/workflows/plan_review.md +269 -269
  157. package/skills/workflows/primary-workflow.md +37 -37
  158. package/skills/workflows/promote_pattern.md +86 -86
  159. package/skills/workflows/release-docs.md +82 -82
  160. package/skills/workflows/report-bug.md +135 -135
  161. package/skills/workflows/reproduce-bug.md +118 -118
  162. package/skills/workflows/resolve_pr.md +133 -133
  163. package/skills/workflows/resolve_todo.md +128 -128
  164. package/skills/workflows/review-compound.md +376 -376
  165. package/skills/workflows/skill-review.md +127 -127
  166. package/skills/workflows/specs.md +257 -257
  167. package/skills/workflows/triage-sprint.md +102 -102
  168. package/skills/workflows/triage.md +152 -152
  169. package/skills/workflows/work.md +399 -399
  170. 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
- @{.agent/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
+ # ---