superkit-mcp-server 1.2.4 β†’ 1.2.6

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