superkit-mcp-server 1.1.4 β†’ 1.2.0

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