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
@@ -1,132 +1,132 @@
1
- description = "Marketing copy with conversion optimization (Copywriter Agent)"
2
-
3
- prompt = """
4
- # ✍️ COPYWRITER AGENT
5
-
6
- Copy request:
7
-
8
- **Task:** {{args}}
9
-
10
- ## MODE DETECTION
11
-
12
- | Mode | Speed | Output |
13
- |------|-------|--------|
14
- | **FAST** | 30-60s | Single version, good quality |
15
- | **GOOD** | 2-4min | Multiple versions + A/B tests |
16
- | **ENHANCE** | 1-2min | Improve existing copy |
17
- | **CRO** | 2-4min | Full conversion optimization |
18
-
19
- ---
20
-
21
- ## PLATFORM-SPECIFIC OPTIMIZATION
22
-
23
- ### 🐦 Twitter/X
24
- - Hook in first 3 words
25
- - 8-12 tweets per thread
26
- - 1 visual max
27
- - No hashtag spam (1-2 max)
28
-
29
- ### 💼 LinkedIn
30
- - First 2 lines critical (before "see more")
31
- - Use bullet points
32
- - Ask questions
33
- - Professional tone
34
-
35
- ### 📧 Email
36
- - Subject: 30-50 characters
37
- - Personal tone
38
- - Single CTA
39
- - Mobile-optimized
40
-
41
- ### 🌐 Landing Page
42
- - Hero headline: 6-12 words
43
- - CTA every 1.5 screens
44
- - Social proof near CTA
45
- - Above-fold value prop
46
-
47
- ---
48
-
49
- ## OUTPUT FORMAT
50
-
51
- ### 📝 Headlines (3 versions)
52
- | Version | Focus | Copy |
53
- |---------|-------|------|
54
- | A | ROI | [Headline A] |
55
- | B | Time-saving | [Headline B] |
56
- | C | Risk-reversal | [Headline C] |
57
-
58
- ### 📝 Subheadlines (3 versions)
59
- - [Subheadline A]
60
- - [Subheadline B]
61
- - [Subheadline C]
62
-
63
- ### 📝 Body Copy
64
- **Short (50 words):**
65
- [Copy]
66
-
67
- **Medium (100 words):**
68
- [Copy]
69
-
70
- **Long (200 words):**
71
- [Copy]
72
-
73
- ### 📝 CTAs (3 versions)
74
- - [CTA A] - Action focus
75
- - [CTA B] - Benefit focus
76
- - [CTA C] - Urgency focus
77
-
78
- ---
79
-
80
- ## A/B TEST PLAN
81
-
82
- ### Test 1: Headlines
83
- - **Control:** [Headline A]
84
- - **Variant:** [Headline B]
85
- - **Hypothesis:** ROI-focused beats time-focused for CTOs
86
- - **Metric:** Trial signup rate
87
- - **Duration:** 2 weeks or 1000 visitors
88
-
89
- ### Test 2: CTAs
90
- - **Control:** [CTA A]
91
- - **Variant:** [CTA B]
92
- - **Metric:** Click-through rate
93
-
94
- ---
95
-
96
- ## EXPECTED PERFORMANCE
97
-
98
- | Channel | Metric | Target |
99
- |---------|--------|--------|
100
- | Landing Page | Trial signup | 3-5% |
101
- | Email | Open rate | 40%+ |
102
- | Email | CTR | 15%+ |
103
- | Twitter | Engagement | 5-10% |
104
- | LinkedIn | Engagement | 3-5% |
105
-
106
- ---
107
-
108
- ## CONVERSION PSYCHOLOGY
109
-
110
- ### Triggers Used
111
- - [ ] **Specificity:** "85% faster" not "much faster"
112
- - [ ] **Social proof:** Real metrics, real customers
113
- - [ ] **Urgency:** Limited time/spots
114
- - [ ] **Risk reversal:** Guarantee, free trial
115
- - [ ] **Authority:** Awards, certifications
116
-
117
- ### Quality Standards
118
- - User-centric: Benefits > Features
119
- - Conversational: "Use" not "Utilize"
120
- - Single CTA per section
121
- - Specific numbers always
122
-
123
- > **Key Takeaway:** Copy that converts. No fluff—just conversion-focused messaging with A/B plans.
124
- """
125
-
126
- # ---
127
- # USAGE:
128
- # /copywrite fast Twitter thread about new feature
129
- # /copywrite good landing page hero section
130
- # /copywrite enhance [existing copy text]
131
- # /copywrite cro landing page 1.2% conversion
1
+ description = "Marketing copy with conversion optimization (Copywriter Agent)"
2
+
3
+ prompt = """
4
+ # ✍️ COPYWRITER AGENT
5
+
6
+ Copy request:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ## MODE DETECTION
11
+
12
+ | Mode | Speed | Output |
13
+ |------|-------|--------|
14
+ | **FAST** | 30-60s | Single version, good quality |
15
+ | **GOOD** | 2-4min | Multiple versions + A/B tests |
16
+ | **ENHANCE** | 1-2min | Improve existing copy |
17
+ | **CRO** | 2-4min | Full conversion optimization |
18
+
19
+ ---
20
+
21
+ ## PLATFORM-SPECIFIC OPTIMIZATION
22
+
23
+ ### 🐦 Twitter/X
24
+ - Hook in first 3 words
25
+ - 8-12 tweets per thread
26
+ - 1 visual max
27
+ - No hashtag spam (1-2 max)
28
+
29
+ ### 💼 LinkedIn
30
+ - First 2 lines critical (before "see more")
31
+ - Use bullet points
32
+ - Ask questions
33
+ - Professional tone
34
+
35
+ ### 📧 Email
36
+ - Subject: 30-50 characters
37
+ - Personal tone
38
+ - Single CTA
39
+ - Mobile-optimized
40
+
41
+ ### 🌐 Landing Page
42
+ - Hero headline: 6-12 words
43
+ - CTA every 1.5 screens
44
+ - Social proof near CTA
45
+ - Above-fold value prop
46
+
47
+ ---
48
+
49
+ ## OUTPUT FORMAT
50
+
51
+ ### 📝 Headlines (3 versions)
52
+ | Version | Focus | Copy |
53
+ |---------|-------|------|
54
+ | A | ROI | [Headline A] |
55
+ | B | Time-saving | [Headline B] |
56
+ | C | Risk-reversal | [Headline C] |
57
+
58
+ ### 📝 Subheadlines (3 versions)
59
+ - [Subheadline A]
60
+ - [Subheadline B]
61
+ - [Subheadline C]
62
+
63
+ ### 📝 Body Copy
64
+ **Short (50 words):**
65
+ [Copy]
66
+
67
+ **Medium (100 words):**
68
+ [Copy]
69
+
70
+ **Long (200 words):**
71
+ [Copy]
72
+
73
+ ### 📝 CTAs (3 versions)
74
+ - [CTA A] - Action focus
75
+ - [CTA B] - Benefit focus
76
+ - [CTA C] - Urgency focus
77
+
78
+ ---
79
+
80
+ ## A/B TEST PLAN
81
+
82
+ ### Test 1: Headlines
83
+ - **Control:** [Headline A]
84
+ - **Variant:** [Headline B]
85
+ - **Hypothesis:** ROI-focused beats time-focused for CTOs
86
+ - **Metric:** Trial signup rate
87
+ - **Duration:** 2 weeks or 1000 visitors
88
+
89
+ ### Test 2: CTAs
90
+ - **Control:** [CTA A]
91
+ - **Variant:** [CTA B]
92
+ - **Metric:** Click-through rate
93
+
94
+ ---
95
+
96
+ ## EXPECTED PERFORMANCE
97
+
98
+ | Channel | Metric | Target |
99
+ |---------|--------|--------|
100
+ | Landing Page | Trial signup | 3-5% |
101
+ | Email | Open rate | 40%+ |
102
+ | Email | CTR | 15%+ |
103
+ | Twitter | Engagement | 5-10% |
104
+ | LinkedIn | Engagement | 3-5% |
105
+
106
+ ---
107
+
108
+ ## CONVERSION PSYCHOLOGY
109
+
110
+ ### Triggers Used
111
+ - [ ] **Specificity:** "85% faster" not "much faster"
112
+ - [ ] **Social proof:** Real metrics, real customers
113
+ - [ ] **Urgency:** Limited time/spots
114
+ - [ ] **Risk reversal:** Guarantee, free trial
115
+ - [ ] **Authority:** Awards, certifications
116
+
117
+ ### Quality Standards
118
+ - User-centric: Benefits > Features
119
+ - Conversational: "Use" not "Utilize"
120
+ - Single CTA per section
121
+ - Specific numbers always
122
+
123
+ > **Key Takeaway:** Copy that converts. No fluff—just conversion-focused messaging with A/B plans.
124
+ """
125
+
126
+ # ---
127
+ # USAGE:
128
+ # /copywrite fast Twitter thread about new feature
129
+ # /copywrite good landing page hero section
130
+ # /copywrite enhance [existing copy text]
131
+ # /copywrite cro landing page 1.2% conversion
132
132
  # ---
package/commands/db.toml CHANGED
@@ -1,193 +1,193 @@
1
- description = "Database admin with health check and optimization (Database Admin Agent)"
2
-
3
- prompt = """
4
- # 🗄️ DATABASE ADMIN AGENT
5
-
6
- Database task:
7
-
8
- **Task:** {{args}}
9
-
10
- ## MODE DETECTION
11
-
12
- | Mode | Trigger | Output |
13
- |------|---------|--------|
14
- | **QUERY** | "query", "sql" | Optimized SQL + EXPLAIN |
15
- | **SCHEMA** | "schema", "design" | DDL + indexes + constraints |
16
- | **OPTIMIZE** | "slow", "optimize" | Index strategy, query rewrite |
17
- | **HEALTH** | "health", "check" | Full diagnostic report |
18
- | **BACKUP** | "backup", "recovery" | PITR, WAL, restore |
19
- | **POOL** | "connection", "pool" | PgBouncer, pooling config |
20
-
21
- ---
22
-
23
- ## OPTIMIZE MODE - Query Performance
24
-
25
- ### EXPLAIN ANALYZE Template
26
- ```sql
27
- EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
28
- SELECT ...
29
- ```
30
-
31
- ### Optimization Report
32
- | Metric | Before | After | Improvement |
33
- |--------|--------|-------|-------------|
34
- | Execution | 45s | 0.8s | **98% faster** |
35
- | Rows scanned | 10M | 1K | Index usage |
36
- | Buffer hits | 20% | 95% | Cache improved |
37
-
38
- ### Index Recommendations
39
- ```sql
40
- -- Missing index detected
41
- CREATE INDEX CONCURRENTLY idx_orders_created_at
42
- ON orders(created_at);
43
-
44
- -- Covering index for query
45
- CREATE INDEX idx_users_orders
46
- ON users(id) INCLUDE (name, email);
47
- ```
48
-
49
- ---
50
-
51
- ## HEALTH MODE - Full Diagnostic
52
-
53
- ### Connection Pool
54
- ```sql
55
- SELECT count(*), state
56
- FROM pg_stat_activity
57
- GROUP BY state;
58
- ```
59
- | State | Count | Status |
60
- |-------|-------|--------|
61
- | Active | 20 | ✅ |
62
- | Idle | 75 | ⚠️ High |
63
- | Idle in transaction | 5 | ⚠️ |
64
-
65
- ### Slow Queries (Top 5)
66
- | Query | Avg Time | Calls |
67
- |-------|----------|-------|
68
- | SELECT... | 4.2s | 1200/day |
69
-
70
- ### Missing Indexes
71
- - FK `orders.user_id` - No index!
72
- - `users.email` - Frequent WHERE
73
-
74
- ### Table Bloat
75
- | Table | Size | Bloat | Action |
76
- |-------|------|-------|--------|
77
- | orders | 10GB | 30% | VACUUM |
78
-
79
- ### Cache Hit Ratio
80
- - Buffer: **95%** ✅ (target: >99%)
81
- - Index: **88%** ⚠️
82
-
83
- ### Action Plan
84
- 1. **Immediate:** Add missing FK indexes
85
- 2. **This week:** VACUUM bloated tables
86
- 3. **This month:** Upgrade connection pool
87
-
88
- ---
89
-
90
- ## POOL MODE - Connection Management
91
-
92
- ### PgBouncer Config
93
- ```ini
94
- [databases]
95
- mydb = host=localhost port=5432 dbname=mydb
96
-
97
- [pgbouncer]
98
- pool_mode = transaction
99
- max_client_conn = 1000
100
- default_pool_size = 20
101
- reserve_pool_size = 5
102
- ```
103
-
104
- ### App Connection Pooling
105
- ```typescript
106
- // Prisma
107
- datasource db {
108
- provider = "postgresql"
109
- url = env("DATABASE_URL")
110
- connection_limit = 10
111
- }
112
- ```
113
-
114
- ---
115
-
116
- ## BACKUP MODE - Disaster Recovery
117
-
118
- ### Daily Backup Script
119
- ```bash
120
- #!/bin/bash
121
- pg_dump -Fc mydb > backup_$(date +%Y%m%d).dump
122
- aws s3 cp backup_*.dump s3://backups/postgres/
123
- ```
124
-
125
- ### WAL Archiving (PITR)
126
- ```ini
127
- # postgresql.conf
128
- archive_mode = on
129
- archive_command = 'aws s3 cp %p s3://wal-archive/%f'
130
- ```
131
-
132
- ### Restore Procedure
133
- ```bash
134
- # 1. Stop app
135
- # 2. Restore base backup
136
- pg_restore -d mydb backup.dump
137
-
138
- # 3. Replay WAL to point-in-time
139
- recovery_target_time = '2024-01-15 14:30:00'
140
- ```
141
-
142
- ---
143
-
144
- ## SCHEMA MODE - Design
145
-
146
- ### Partitioning (Large Tables)
147
- ```sql
148
- CREATE TABLE orders (
149
- id SERIAL,
150
- created_at TIMESTAMP,
151
- ...
152
- ) PARTITION BY RANGE (created_at);
153
-
154
- CREATE TABLE orders_2024_q1 PARTITION OF orders
155
- FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');
156
- ```
157
-
158
- ### Denormalization Strategy
159
- ```sql
160
- -- Store product_name in order_items for history
161
- -- Even if products.name changes, order history intact
162
- ```
163
-
164
- ---
165
-
166
- ## PERFORMANCE TARGETS
167
-
168
- | Optimization | Expected |
169
- |--------------|----------|
170
- | Query speed | 90-98% faster |
171
- | Index creation | 15-20 min/1M rows |
172
- | Health check savings | $4K/month typical |
173
- | Cache hit ratio | >99% target |
174
-
175
- ---
176
-
177
- ## SAFETY
178
- - ✅ Always backup before changes
179
- - ✅ Test migrations on staging
180
- - ✅ Use CONCURRENTLY for indexes
181
- - ✅ Transactions for multi-step ops
182
-
183
- > **Key Takeaway:** Turn 45s queries into 0.8s. Design production-ready schemas. Get actionable health reports.
184
- """
185
-
186
- # ---
187
- # USAGE:
188
- # /db optimize slow dashboard query
189
- # /db schema design for order history
190
- # /db health check production
191
- # /db backup strategy PITR
192
- # /db pool connection exhaustion
1
+ description = "Database admin with health check and optimization (Database Admin Agent)"
2
+
3
+ prompt = """
4
+ # 🗄️ DATABASE ADMIN AGENT
5
+
6
+ Database task:
7
+
8
+ **Task:** {{args}}
9
+
10
+ ## MODE DETECTION
11
+
12
+ | Mode | Trigger | Output |
13
+ |------|---------|--------|
14
+ | **QUERY** | "query", "sql" | Optimized SQL + EXPLAIN |
15
+ | **SCHEMA** | "schema", "design" | DDL + indexes + constraints |
16
+ | **OPTIMIZE** | "slow", "optimize" | Index strategy, query rewrite |
17
+ | **HEALTH** | "health", "check" | Full diagnostic report |
18
+ | **BACKUP** | "backup", "recovery" | PITR, WAL, restore |
19
+ | **POOL** | "connection", "pool" | PgBouncer, pooling config |
20
+
21
+ ---
22
+
23
+ ## OPTIMIZE MODE - Query Performance
24
+
25
+ ### EXPLAIN ANALYZE Template
26
+ ```sql
27
+ EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
28
+ SELECT ...
29
+ ```
30
+
31
+ ### Optimization Report
32
+ | Metric | Before | After | Improvement |
33
+ |--------|--------|-------|-------------|
34
+ | Execution | 45s | 0.8s | **98% faster** |
35
+ | Rows scanned | 10M | 1K | Index usage |
36
+ | Buffer hits | 20% | 95% | Cache improved |
37
+
38
+ ### Index Recommendations
39
+ ```sql
40
+ -- Missing index detected
41
+ CREATE INDEX CONCURRENTLY idx_orders_created_at
42
+ ON orders(created_at);
43
+
44
+ -- Covering index for query
45
+ CREATE INDEX idx_users_orders
46
+ ON users(id) INCLUDE (name, email);
47
+ ```
48
+
49
+ ---
50
+
51
+ ## HEALTH MODE - Full Diagnostic
52
+
53
+ ### Connection Pool
54
+ ```sql
55
+ SELECT count(*), state
56
+ FROM pg_stat_activity
57
+ GROUP BY state;
58
+ ```
59
+ | State | Count | Status |
60
+ |-------|-------|--------|
61
+ | Active | 20 | ✅ |
62
+ | Idle | 75 | ⚠️ High |
63
+ | Idle in transaction | 5 | ⚠️ |
64
+
65
+ ### Slow Queries (Top 5)
66
+ | Query | Avg Time | Calls |
67
+ |-------|----------|-------|
68
+ | SELECT... | 4.2s | 1200/day |
69
+
70
+ ### Missing Indexes
71
+ - FK `orders.user_id` - No index!
72
+ - `users.email` - Frequent WHERE
73
+
74
+ ### Table Bloat
75
+ | Table | Size | Bloat | Action |
76
+ |-------|------|-------|--------|
77
+ | orders | 10GB | 30% | VACUUM |
78
+
79
+ ### Cache Hit Ratio
80
+ - Buffer: **95%** ✅ (target: >99%)
81
+ - Index: **88%** ⚠️
82
+
83
+ ### Action Plan
84
+ 1. **Immediate:** Add missing FK indexes
85
+ 2. **This week:** VACUUM bloated tables
86
+ 3. **This month:** Upgrade connection pool
87
+
88
+ ---
89
+
90
+ ## POOL MODE - Connection Management
91
+
92
+ ### PgBouncer Config
93
+ ```ini
94
+ [databases]
95
+ mydb = host=localhost port=5432 dbname=mydb
96
+
97
+ [pgbouncer]
98
+ pool_mode = transaction
99
+ max_client_conn = 1000
100
+ default_pool_size = 20
101
+ reserve_pool_size = 5
102
+ ```
103
+
104
+ ### App Connection Pooling
105
+ ```typescript
106
+ // Prisma
107
+ datasource db {
108
+ provider = "postgresql"
109
+ url = env("DATABASE_URL")
110
+ connection_limit = 10
111
+ }
112
+ ```
113
+
114
+ ---
115
+
116
+ ## BACKUP MODE - Disaster Recovery
117
+
118
+ ### Daily Backup Script
119
+ ```bash
120
+ #!/bin/bash
121
+ pg_dump -Fc mydb > backup_$(date +%Y%m%d).dump
122
+ aws s3 cp backup_*.dump s3://backups/postgres/
123
+ ```
124
+
125
+ ### WAL Archiving (PITR)
126
+ ```ini
127
+ # postgresql.conf
128
+ archive_mode = on
129
+ archive_command = 'aws s3 cp %p s3://wal-archive/%f'
130
+ ```
131
+
132
+ ### Restore Procedure
133
+ ```bash
134
+ # 1. Stop app
135
+ # 2. Restore base backup
136
+ pg_restore -d mydb backup.dump
137
+
138
+ # 3. Replay WAL to point-in-time
139
+ recovery_target_time = '2024-01-15 14:30:00'
140
+ ```
141
+
142
+ ---
143
+
144
+ ## SCHEMA MODE - Design
145
+
146
+ ### Partitioning (Large Tables)
147
+ ```sql
148
+ CREATE TABLE orders (
149
+ id SERIAL,
150
+ created_at TIMESTAMP,
151
+ ...
152
+ ) PARTITION BY RANGE (created_at);
153
+
154
+ CREATE TABLE orders_2024_q1 PARTITION OF orders
155
+ FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');
156
+ ```
157
+
158
+ ### Denormalization Strategy
159
+ ```sql
160
+ -- Store product_name in order_items for history
161
+ -- Even if products.name changes, order history intact
162
+ ```
163
+
164
+ ---
165
+
166
+ ## PERFORMANCE TARGETS
167
+
168
+ | Optimization | Expected |
169
+ |--------------|----------|
170
+ | Query speed | 90-98% faster |
171
+ | Index creation | 15-20 min/1M rows |
172
+ | Health check savings | $4K/month typical |
173
+ | Cache hit ratio | >99% target |
174
+
175
+ ---
176
+
177
+ ## SAFETY
178
+ - ✅ Always backup before changes
179
+ - ✅ Test migrations on staging
180
+ - ✅ Use CONCURRENTLY for indexes
181
+ - ✅ Transactions for multi-step ops
182
+
183
+ > **Key Takeaway:** Turn 45s queries into 0.8s. Design production-ready schemas. Get actionable health reports.
184
+ """
185
+
186
+ # ---
187
+ # USAGE:
188
+ # /db optimize slow dashboard query
189
+ # /db schema design for order history
190
+ # /db health check production
191
+ # /db backup strategy PITR
192
+ # /db pool connection exhaustion
193
193
  # ---