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.
- package/ARCHITECTURE.md +102 -102
- package/README.md +71 -71
- package/SUPERKIT.md +168 -168
- package/agents/code-archaeologist.md +106 -106
- package/agents/coder.md +90 -90
- package/agents/data-engineer.md +28 -28
- package/agents/devops-engineer.md +242 -242
- package/agents/git-manager.md +203 -203
- package/agents/orchestrator.md +420 -420
- package/agents/penetration-tester.md +188 -188
- package/agents/performance-optimizer.md +187 -187
- package/agents/planner.md +270 -270
- package/agents/qa-automation-engineer.md +103 -103
- package/agents/quant-developer.md +32 -32
- package/agents/reviewer.md +100 -100
- package/agents/scout.md +222 -222
- package/agents/tester.md +274 -274
- package/agents/ui-designer.md +208 -208
- package/build/__tests__/test_apply_prompt_args.js +104 -0
- package/build/index.js +106 -45
- package/build/tools/todoTools.js +39 -39
- package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
- package/build/tools/validators/__tests__/convertRules.test.js +5 -5
- package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
- package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
- package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
- package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
- package/build/tools/validators/__tests__/securityScan.test.js +6 -6
- package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
- package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
- package/commands/README.md +122 -122
- package/commands/ask.toml +72 -72
- package/commands/brainstorm.toml +119 -119
- package/commands/chat.toml +77 -77
- package/commands/code-preview.toml +37 -37
- package/commands/code.toml +28 -28
- package/commands/content.toml +200 -200
- package/commands/cook.toml +77 -77
- package/commands/copywrite.toml +131 -131
- package/commands/db.toml +192 -192
- package/commands/debug.toml +166 -166
- package/commands/design.toml +158 -158
- package/commands/dev-rules.toml +14 -14
- package/commands/do.toml +117 -117
- package/commands/doc-rules.toml +14 -14
- package/commands/docs.toml +148 -148
- package/commands/fix.toml +440 -440
- package/commands/fullstack.toml +175 -175
- package/commands/git.toml +235 -235
- package/commands/help.toml +84 -84
- package/commands/integrate.toml +127 -127
- package/commands/journal.toml +136 -136
- package/commands/kit-setup.toml +40 -40
- package/commands/mcp.toml +183 -183
- package/commands/orchestration.toml +15 -15
- package/commands/plan.toml +206 -172
- package/commands/pm.toml +148 -148
- package/commands/pr.toml +50 -50
- package/commands/project.toml +32 -32
- package/commands/research.toml +117 -117
- package/commands/review-pr.toml +63 -63
- package/commands/review.toml +190 -190
- package/commands/scout-ext.toml +97 -97
- package/commands/scout.toml +79 -79
- package/commands/screenshot.toml +65 -65
- package/commands/session.toml +102 -102
- package/commands/skill.toml +384 -384
- package/commands/status.toml +22 -22
- package/commands/team.toml +56 -56
- package/commands/test.toml +164 -164
- package/commands/ticket.toml +70 -70
- package/commands/use.toml +106 -106
- package/commands/video.toml +83 -83
- package/commands/watzup.toml +71 -71
- package/commands/workflow.toml +14 -14
- package/package.json +35 -35
- package/skills/meta/README.md +30 -30
- package/skills/meta/api-design/SKILL.md +134 -134
- package/skills/meta/code-review/SKILL.md +44 -44
- package/skills/meta/code-review/checklists/pre-merge.md +25 -25
- package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
- package/skills/meta/code-review/workflows/performance-pass.md +27 -27
- package/skills/meta/code-review/workflows/security-pass.md +29 -29
- package/skills/meta/compound-docs/SKILL.md +133 -133
- package/skills/meta/debug/SKILL.md +40 -40
- package/skills/meta/debug/templates/bug-report.template.md +31 -31
- package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
- package/skills/meta/docker/SKILL.md +126 -126
- package/skills/meta/examples/supabase/SKILL.md +46 -46
- package/skills/meta/examples/supabase/references/best-practices.md +319 -319
- package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
- package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
- package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
- package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
- package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
- package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
- package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
- package/skills/meta/file-todos/SKILL.md +88 -88
- package/skills/meta/mobile/SKILL.md +140 -140
- package/skills/meta/nextjs/SKILL.md +101 -101
- package/skills/meta/performance/SKILL.md +130 -130
- package/skills/meta/react-patterns/SKILL.md +83 -83
- package/skills/meta/security/SKILL.md +114 -114
- package/skills/meta/session-resume/SKILL.md +96 -96
- package/skills/meta/tailwind/SKILL.md +139 -139
- package/skills/meta/testing/SKILL.md +43 -43
- package/skills/meta/testing/references/vitest-patterns.md +45 -45
- package/skills/meta/testing/templates/component-test.template.tsx +37 -37
- package/skills/tech/alpha-vantage/SKILL.md +142 -142
- package/skills/tech/alpha-vantage/references/commodities.md +153 -153
- package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
- package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
- package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
- package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
- package/skills/tech/alpha-vantage/references/options.md +93 -93
- package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
- package/skills/tech/alpha-vantage/references/time-series.md +157 -157
- package/skills/tech/financial-modeling/SKILL.md +18 -18
- package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
- package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
- package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
- package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
- package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
- package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
- package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
- package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
- package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
- package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
- package/skills/workflows/README.md +203 -203
- package/skills/workflows/adr.md +174 -174
- package/skills/workflows/changelog.md +74 -74
- package/skills/workflows/compound.md +323 -323
- package/skills/workflows/compound_health.md +74 -74
- package/skills/workflows/create-agent-skill.md +138 -138
- package/skills/workflows/cycle.md +144 -144
- package/skills/workflows/deploy-docs.md +84 -84
- package/skills/workflows/development-rules.md +42 -42
- package/skills/workflows/doc.md +95 -95
- package/skills/workflows/documentation-management.md +34 -34
- package/skills/workflows/explore.md +146 -146
- package/skills/workflows/generate_command.md +106 -106
- package/skills/workflows/heal-skill.md +97 -97
- package/skills/workflows/housekeeping.md +229 -229
- package/skills/workflows/kit-setup.md +102 -102
- package/skills/workflows/map-codebase.md +78 -78
- package/skills/workflows/orchestration-protocol.md +43 -43
- package/skills/workflows/plan-compound.md +439 -439
- package/skills/workflows/plan_review.md +269 -269
- package/skills/workflows/primary-workflow.md +37 -37
- package/skills/workflows/promote_pattern.md +86 -86
- package/skills/workflows/release-docs.md +82 -82
- package/skills/workflows/report-bug.md +135 -135
- package/skills/workflows/reproduce-bug.md +118 -118
- package/skills/workflows/resolve_pr.md +133 -133
- package/skills/workflows/resolve_todo.md +128 -128
- package/skills/workflows/review-compound.md +376 -376
- package/skills/workflows/skill-review.md +127 -127
- package/skills/workflows/specs.md +257 -257
- package/skills/workflows/triage-sprint.md +102 -102
- package/skills/workflows/triage.md +152 -152
- package/skills/workflows/work.md +399 -399
- 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
|
+
"""
|
package/commands/doc-rules.toml
CHANGED
|
@@ -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
|
+
"""
|
package/commands/docs.toml
CHANGED
|
@@ -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
|
+
# ---
|