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
@@ -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
  # ---