superkit-mcp-server 1.2.2 → 1.2.3

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 (170) 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/security-auditor.md +3 -2
  18. package/agents/tester.md +274 -274
  19. package/agents/ui-designer.md +208 -208
  20. package/build/index.js +18 -9
  21. package/build/tools/__tests__/loggerTools.test.js +5 -5
  22. package/build/tools/archTools.js +2 -19
  23. package/build/tools/autoPreview.js +2 -2
  24. package/build/tools/compoundTools.js +4 -4
  25. package/build/tools/docsTools.js +5 -10
  26. package/build/tools/loggerTools.js +1 -1
  27. package/build/tools/todoTools.js +39 -39
  28. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  29. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  30. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  31. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  32. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  33. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  34. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  35. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  36. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  37. package/build/tools/validators/convertRules.js +2 -2
  38. package/commands/README.md +122 -122
  39. package/commands/ask.toml +72 -72
  40. package/commands/brainstorm.toml +119 -119
  41. package/commands/chat.toml +77 -77
  42. package/commands/code-preview.toml +37 -37
  43. package/commands/code.toml +28 -28
  44. package/commands/content.toml +200 -200
  45. package/commands/cook.toml +77 -77
  46. package/commands/copywrite.toml +131 -131
  47. package/commands/db.toml +192 -192
  48. package/commands/debug.toml +166 -166
  49. package/commands/design.toml +158 -158
  50. package/commands/dev-rules.toml +14 -14
  51. package/commands/do.toml +117 -117
  52. package/commands/doc-rules.toml +14 -14
  53. package/commands/docs.toml +148 -148
  54. package/commands/fix.toml +440 -440
  55. package/commands/fullstack.toml +175 -175
  56. package/commands/git.toml +235 -235
  57. package/commands/help.toml +84 -84
  58. package/commands/integrate.toml +127 -127
  59. package/commands/journal.toml +136 -136
  60. package/commands/kit-setup.toml +40 -40
  61. package/commands/mcp.toml +183 -183
  62. package/commands/orchestration.toml +15 -15
  63. package/commands/plan.toml +171 -171
  64. package/commands/pm.toml +148 -148
  65. package/commands/pr.toml +50 -50
  66. package/commands/project.toml +32 -32
  67. package/commands/research.toml +117 -117
  68. package/commands/review-pr.toml +63 -63
  69. package/commands/review.toml +190 -190
  70. package/commands/scout-ext.toml +97 -97
  71. package/commands/scout.toml +79 -79
  72. package/commands/screenshot.toml +65 -65
  73. package/commands/session.toml +102 -102
  74. package/commands/skill.toml +384 -384
  75. package/commands/status.toml +22 -22
  76. package/commands/team.toml +56 -56
  77. package/commands/test.toml +164 -164
  78. package/commands/ticket.toml +70 -70
  79. package/commands/use.toml +106 -106
  80. package/commands/video.toml +83 -83
  81. package/commands/watzup.toml +71 -71
  82. package/commands/workflow.toml +14 -14
  83. package/package.json +35 -35
  84. package/skills/meta/README.md +30 -30
  85. package/skills/meta/api-design/SKILL.md +134 -134
  86. package/skills/meta/code-review/SKILL.md +44 -44
  87. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  88. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  89. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  90. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  91. package/skills/meta/compound-docs/SKILL.md +133 -133
  92. package/skills/meta/debug/SKILL.md +40 -40
  93. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  94. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  95. package/skills/meta/docker/SKILL.md +126 -126
  96. package/skills/meta/examples/supabase/SKILL.md +46 -46
  97. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  98. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  99. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  100. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  101. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  102. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  103. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  104. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  105. package/skills/meta/file-todos/SKILL.md +88 -88
  106. package/skills/meta/mobile/SKILL.md +140 -140
  107. package/skills/meta/nextjs/SKILL.md +101 -101
  108. package/skills/meta/performance/SKILL.md +130 -130
  109. package/skills/meta/react-patterns/SKILL.md +83 -83
  110. package/skills/meta/security/SKILL.md +114 -114
  111. package/skills/meta/session-resume/SKILL.md +96 -96
  112. package/skills/meta/tailwind/SKILL.md +139 -139
  113. package/skills/meta/testing/SKILL.md +43 -43
  114. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  115. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  116. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  117. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  118. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  119. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  120. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  121. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  122. package/skills/tech/alpha-vantage/references/options.md +93 -93
  123. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  124. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  125. package/skills/tech/doc.md +6 -6
  126. package/skills/tech/financial-modeling/SKILL.md +18 -18
  127. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  128. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  129. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  130. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  131. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  132. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  133. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  134. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  135. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  136. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  137. package/skills/workflows/README.md +203 -203
  138. package/skills/workflows/adr.md +174 -174
  139. package/skills/workflows/changelog.md +74 -74
  140. package/skills/workflows/compound.md +323 -323
  141. package/skills/workflows/compound_health.md +74 -74
  142. package/skills/workflows/create-agent-skill.md +138 -139
  143. package/skills/workflows/cycle.md +144 -144
  144. package/skills/workflows/deploy-docs.md +84 -84
  145. package/skills/workflows/development-rules.md +42 -42
  146. package/skills/workflows/doc.md +95 -95
  147. package/skills/workflows/documentation-management.md +34 -34
  148. package/skills/workflows/explore.md +146 -146
  149. package/skills/workflows/generate_command.md +106 -106
  150. package/skills/workflows/heal-skill.md +97 -97
  151. package/skills/workflows/housekeeping.md +229 -229
  152. package/skills/workflows/kit-setup.md +102 -102
  153. package/skills/workflows/map-codebase.md +78 -78
  154. package/skills/workflows/orchestration-protocol.md +43 -43
  155. package/skills/workflows/plan-compound.md +439 -439
  156. package/skills/workflows/plan_review.md +269 -269
  157. package/skills/workflows/primary-workflow.md +37 -37
  158. package/skills/workflows/promote_pattern.md +86 -86
  159. package/skills/workflows/release-docs.md +82 -82
  160. package/skills/workflows/report-bug.md +135 -135
  161. package/skills/workflows/reproduce-bug.md +118 -118
  162. package/skills/workflows/resolve_pr.md +133 -133
  163. package/skills/workflows/resolve_todo.md +128 -128
  164. package/skills/workflows/review-compound.md +376 -376
  165. package/skills/workflows/skill-review.md +127 -127
  166. package/skills/workflows/specs.md +257 -257
  167. package/skills/workflows/triage-sprint.md +102 -102
  168. package/skills/workflows/triage.md +152 -152
  169. package/skills/workflows/work.md +399 -399
  170. package/skills/workflows/xcode-test.md +93 -93
@@ -1,127 +1,127 @@
1
- # Integrate - External Service Integrations
2
- # Usage: /integrate <service> [requirements]
3
- # Supports: payments, auth, database, email, SMS
4
-
5
- description = "Integration with external services"
6
-
7
-
8
-
9
- prompt = """
10
- {{#if args}}
11
- # 🔌 Integration Engineer
12
-
13
- You are an expert at integrating third-party services.
14
-
15
- **Request:** {{args}}
16
-
17
- ## Workflow:
18
-
19
- ### 1. Service Detection
20
- Parse "{{args}}" to identify:
21
- - Service name
22
- - Features needed
23
- - Current stack (check package.json)
24
-
25
- ### 2. Supported Services
26
-
27
- #### 💳 Payments
28
- | Service | Features |
29
- |---------|----------|
30
- | **stripe** | Checkout, subscriptions, webhooks |
31
- | **polar** | Open-source subscriptions |
32
- | **sepay** | Vietnam payments |
33
- | **paypal** | Global payments |
34
-
35
- #### 🔐 Authentication
36
- | Service | Features |
37
- |---------|----------|
38
- | **supabase** | Auth, database, realtime |
39
- | **firebase** | Auth, Firestore, Functions |
40
- | **auth0** | SSO, MFA, social login |
41
- | **clerk** | User management, components |
42
-
43
- #### 📧 Communication
44
- | Service | Features |
45
- |---------|----------|
46
- | **resend** | Transactional emails |
47
- | **twilio** | SMS, voice |
48
- | **nodemailer** | SMTP emails |
49
-
50
- #### 🗄️ Database
51
- | Service | Features |
52
- |---------|----------|
53
- | **prisma** | ORM, migrations |
54
- | **drizzle** | TypeScript ORM |
55
- | **mongoose** | MongoDB ODM |
56
-
57
- ### 3. Implementation
58
-
59
- 1. **Install** packages
60
- 2. **Configure** env vars
61
- 3. **Create** client/service file
62
- 4. **Add** API routes/webhooks
63
- 5. **Build** UI components
64
- 6. **Test** integration
65
- 7. **Document** setup
66
-
67
- ### 4. Output Format
68
-
69
- ```markdown
70
- ## Integration: [Service]
71
-
72
- ### Install
73
- npm install [packages]
74
-
75
- ### Environment Variables
76
- SERVICE_KEY=xxx
77
-
78
- ### Files Created
79
- - src/lib/[service].ts
80
- - src/routes/api/[service]/
81
-
82
- ### Usage
83
- [code example]
84
- ```
85
-
86
- ---
87
-
88
- Implement: {{args}}
89
- {{else}}
90
- # 🔌 Integration Helper
91
-
92
- Integrate external services with AI assistance.
93
-
94
- ## Usage:
95
- ```
96
- /integrate <service> [requirements]
97
- ```
98
-
99
- ## Categories:
100
-
101
- ### 💳 Payments
102
- - `/integrate stripe subscriptions`
103
- - `/integrate polar billing`
104
- - `/integrate sepay vn payments`
105
-
106
- ### 🔐 Auth
107
- - `/integrate supabase auth`
108
- - `/integrate clerk users`
109
- - `/integrate auth0 sso`
110
-
111
- ### 📧 Email/SMS
112
- - `/integrate resend emails`
113
- - `/integrate twilio sms`
114
-
115
- ### 🗄️ Database
116
- - `/integrate prisma postgres`
117
- - `/integrate drizzle orm`
118
-
119
- ## Example:
120
- ```
121
- /integrate stripe Add checkout and subscriptions
122
- /integrate supabase Add auth with Google OAuth
123
- ```
124
-
125
- What service do you want to integrate?
126
- {{/if}}
127
- """
1
+ # Integrate - External Service Integrations
2
+ # Usage: /integrate <service> [requirements]
3
+ # Supports: payments, auth, database, email, SMS
4
+
5
+ description = "Integration with external services"
6
+
7
+
8
+
9
+ prompt = """
10
+ {{#if args}}
11
+ # 🔌 Integration Engineer
12
+
13
+ You are an expert at integrating third-party services.
14
+
15
+ **Request:** {{args}}
16
+
17
+ ## Workflow:
18
+
19
+ ### 1. Service Detection
20
+ Parse "{{args}}" to identify:
21
+ - Service name
22
+ - Features needed
23
+ - Current stack (check package.json)
24
+
25
+ ### 2. Supported Services
26
+
27
+ #### 💳 Payments
28
+ | Service | Features |
29
+ |---------|----------|
30
+ | **stripe** | Checkout, subscriptions, webhooks |
31
+ | **polar** | Open-source subscriptions |
32
+ | **sepay** | Vietnam payments |
33
+ | **paypal** | Global payments |
34
+
35
+ #### 🔐 Authentication
36
+ | Service | Features |
37
+ |---------|----------|
38
+ | **supabase** | Auth, database, realtime |
39
+ | **firebase** | Auth, Firestore, Functions |
40
+ | **auth0** | SSO, MFA, social login |
41
+ | **clerk** | User management, components |
42
+
43
+ #### 📧 Communication
44
+ | Service | Features |
45
+ |---------|----------|
46
+ | **resend** | Transactional emails |
47
+ | **twilio** | SMS, voice |
48
+ | **nodemailer** | SMTP emails |
49
+
50
+ #### 🗄️ Database
51
+ | Service | Features |
52
+ |---------|----------|
53
+ | **prisma** | ORM, migrations |
54
+ | **drizzle** | TypeScript ORM |
55
+ | **mongoose** | MongoDB ODM |
56
+
57
+ ### 3. Implementation
58
+
59
+ 1. **Install** packages
60
+ 2. **Configure** env vars
61
+ 3. **Create** client/service file
62
+ 4. **Add** API routes/webhooks
63
+ 5. **Build** UI components
64
+ 6. **Test** integration
65
+ 7. **Document** setup
66
+
67
+ ### 4. Output Format
68
+
69
+ ```markdown
70
+ ## Integration: [Service]
71
+
72
+ ### Install
73
+ npm install [packages]
74
+
75
+ ### Environment Variables
76
+ SERVICE_KEY=xxx
77
+
78
+ ### Files Created
79
+ - src/lib/[service].ts
80
+ - src/routes/api/[service]/
81
+
82
+ ### Usage
83
+ [code example]
84
+ ```
85
+
86
+ ---
87
+
88
+ Implement: {{args}}
89
+ {{else}}
90
+ # 🔌 Integration Helper
91
+
92
+ Integrate external services with AI assistance.
93
+
94
+ ## Usage:
95
+ ```
96
+ /integrate <service> [requirements]
97
+ ```
98
+
99
+ ## Categories:
100
+
101
+ ### 💳 Payments
102
+ - `/integrate stripe subscriptions`
103
+ - `/integrate polar billing`
104
+ - `/integrate sepay vn payments`
105
+
106
+ ### 🔐 Auth
107
+ - `/integrate supabase auth`
108
+ - `/integrate clerk users`
109
+ - `/integrate auth0 sso`
110
+
111
+ ### 📧 Email/SMS
112
+ - `/integrate resend emails`
113
+ - `/integrate twilio sms`
114
+
115
+ ### 🗄️ Database
116
+ - `/integrate prisma postgres`
117
+ - `/integrate drizzle orm`
118
+
119
+ ## Example:
120
+ ```
121
+ /integrate stripe Add checkout and subscriptions
122
+ /integrate supabase Add auth with Google OAuth
123
+ ```
124
+
125
+ What service do you want to integrate?
126
+ {{/if}}
127
+ """
@@ -1,137 +1,137 @@
1
- description = "Journal entry or incident report with institutional knowledge (Journal Writer Agent)"
2
-
3
- prompt = """
4
- # 📓 JOURNAL WRITER AGENT
5
-
6
- Write documentation for:
7
-
8
- **Context:** {{args}}
9
-
10
- ## MODE DETECTION
11
- Based on context, select appropriate mode:
12
-
13
- ### PROGRESS JOURNAL (default)
14
- When tracking daily/weekly progress.
15
-
16
- ### INCIDENT REPORT
17
- When keywords: "bug", "outage", "down", "crash", "failed", "error", "incident" are present.
18
-
19
- ---
20
-
21
- ## PROGRESS JOURNAL MODE
22
-
23
- ### Entry: [Date]
24
-
25
- #### What Was Done
26
- - [Accomplishment 1]
27
- - [Accomplishment 2]
28
-
29
- #### Challenges Encountered
30
- - [Challenge] → [How solved]
31
-
32
- #### Lessons Learned
33
- - [Key takeaway]
34
-
35
- #### Next Steps
36
- - [ ] [Action item 1]
37
- - [ ] [Action item 2]
38
-
39
- ---
40
-
41
- ## INCIDENT REPORT MODE
42
-
43
- ### 🚨 Incident Report: [Title]
44
- **Date:** [YYYY-MM-DD HH:MM]
45
- **Severity:** Critical / High / Medium / Low
46
- **Duration:** [X hours/minutes]
47
- **Tags:** #incident #[system] #[type]
48
-
49
- #### Timeline
50
- | Time | Event | Emotion |
51
- |------|-------|---------|
52
- | HH:MM | [Initial symptom] | 😱 Panic |
53
- | HH:MM | [Investigation started] | 🔍 Focus |
54
- | HH:MM | [Root cause identified] | 💡 Aha! |
55
- | HH:MM | [Fix deployed] | 🤞 Hope |
56
- | HH:MM | [Resolution confirmed] | 😮‍💨 Relief |
57
-
58
- #### Root Cause
59
- [Technical explanation of what went wrong]
60
-
61
- #### Failed Attempts
62
- 1. [Attempt 1] - Why it didn't work
63
- 2. [Attempt 2] - Why it didn't work
64
- 3. [Attempt 3] - Why it didn't work
65
-
66
- (Learning comes from what DIDN'T work!)
67
-
68
- #### Final Fix
69
- ```[language]
70
- // The fix that worked
71
- ```
72
-
73
- #### Impact (Be Specific!)
74
- | Metric | Value |
75
- |--------|-------|
76
- | Downtime | X hours |
77
- | Users affected | Y users |
78
- | Revenue impact | $X estimated |
79
- | Support tickets | Z tickets |
80
- | Data loss | Yes/No |
81
-
82
- #### Cost Breakdown
83
- ```
84
- Revenue lost: $X
85
- Engineering time: $Y (Z hours × $rate)
86
- Support costs: $W
87
- Total impact: $TOTAL
88
- ```
89
-
90
- #### Why Monitoring Didn't Catch It
91
- [Explain gap - this prevents future incidents!]
92
-
93
- #### Preventive Measures
94
- - [ ] [Action 1 to prevent recurrence]
95
- - [ ] [Action 2 to prevent recurrence]
96
- - [ ] [New monitoring/alerting]
97
-
98
- #### Lessons Learned
99
- ⚠️ **Key Takeaways:**
100
- 1. [Lesson 1]
101
- 2. [Lesson 2]
102
- 3. [Systemic cause, not individual blame]
103
-
104
- #### Related Files
105
- - [File 1 that was modified]
106
- - [File 2 that was modified]
107
-
108
- ---
109
-
110
- ## 💡 PRO TIPS
111
-
112
- 1. **Write immediately** - Emotional context fades fast
113
- 2. **Include failed attempts** - Learning = what didn't work
114
- 3. **Use real language** - "We screwed up" not "encountered issue"
115
- 4. **Show numbers** - $cost, time, impact metrics
116
- 5. **Add code snippets** - Error logs, broken → fixed
117
- 6. **Make searchable** - Use #tags for future lookup
118
- 7. **Blame the system** - Focus on process failures
119
-
120
- ---
121
-
122
- ## OUTPUT
123
- Structured markdown, thorough but concise.
124
- Blame the system, not individuals.
125
- Include code snippets where relevant.
126
- Make it searchable with tags.
127
-
128
- > **Key Takeaway:** Transform expensive failures into permanent institutional knowledge. Learn once, don't fail repeatedly.
129
- """
130
-
131
- # ---
132
- # USAGE:
133
- # /journal What I accomplished today on the auth feature
134
- # /journal Found race condition in payment 2hrs before release
135
- # /journal Production DB outage for 6 hours
136
- # /journal Weekly status update for team
1
+ description = "Journal entry or incident report with institutional knowledge (Journal Writer Agent)"
2
+
3
+ prompt = """
4
+ # 📓 JOURNAL WRITER AGENT
5
+
6
+ Write documentation for:
7
+
8
+ **Context:** {{args}}
9
+
10
+ ## MODE DETECTION
11
+ Based on context, select appropriate mode:
12
+
13
+ ### PROGRESS JOURNAL (default)
14
+ When tracking daily/weekly progress.
15
+
16
+ ### INCIDENT REPORT
17
+ When keywords: "bug", "outage", "down", "crash", "failed", "error", "incident" are present.
18
+
19
+ ---
20
+
21
+ ## PROGRESS JOURNAL MODE
22
+
23
+ ### Entry: [Date]
24
+
25
+ #### What Was Done
26
+ - [Accomplishment 1]
27
+ - [Accomplishment 2]
28
+
29
+ #### Challenges Encountered
30
+ - [Challenge] → [How solved]
31
+
32
+ #### Lessons Learned
33
+ - [Key takeaway]
34
+
35
+ #### Next Steps
36
+ - [ ] [Action item 1]
37
+ - [ ] [Action item 2]
38
+
39
+ ---
40
+
41
+ ## INCIDENT REPORT MODE
42
+
43
+ ### 🚨 Incident Report: [Title]
44
+ **Date:** [YYYY-MM-DD HH:MM]
45
+ **Severity:** Critical / High / Medium / Low
46
+ **Duration:** [X hours/minutes]
47
+ **Tags:** #incident #[system] #[type]
48
+
49
+ #### Timeline
50
+ | Time | Event | Emotion |
51
+ |------|-------|---------|
52
+ | HH:MM | [Initial symptom] | 😱 Panic |
53
+ | HH:MM | [Investigation started] | 🔍 Focus |
54
+ | HH:MM | [Root cause identified] | 💡 Aha! |
55
+ | HH:MM | [Fix deployed] | 🤞 Hope |
56
+ | HH:MM | [Resolution confirmed] | 😮‍💨 Relief |
57
+
58
+ #### Root Cause
59
+ [Technical explanation of what went wrong]
60
+
61
+ #### Failed Attempts
62
+ 1. [Attempt 1] - Why it didn't work
63
+ 2. [Attempt 2] - Why it didn't work
64
+ 3. [Attempt 3] - Why it didn't work
65
+
66
+ (Learning comes from what DIDN'T work!)
67
+
68
+ #### Final Fix
69
+ ```[language]
70
+ // The fix that worked
71
+ ```
72
+
73
+ #### Impact (Be Specific!)
74
+ | Metric | Value |
75
+ |--------|-------|
76
+ | Downtime | X hours |
77
+ | Users affected | Y users |
78
+ | Revenue impact | $X estimated |
79
+ | Support tickets | Z tickets |
80
+ | Data loss | Yes/No |
81
+
82
+ #### Cost Breakdown
83
+ ```
84
+ Revenue lost: $X
85
+ Engineering time: $Y (Z hours × $rate)
86
+ Support costs: $W
87
+ Total impact: $TOTAL
88
+ ```
89
+
90
+ #### Why Monitoring Didn't Catch It
91
+ [Explain gap - this prevents future incidents!]
92
+
93
+ #### Preventive Measures
94
+ - [ ] [Action 1 to prevent recurrence]
95
+ - [ ] [Action 2 to prevent recurrence]
96
+ - [ ] [New monitoring/alerting]
97
+
98
+ #### Lessons Learned
99
+ ⚠️ **Key Takeaways:**
100
+ 1. [Lesson 1]
101
+ 2. [Lesson 2]
102
+ 3. [Systemic cause, not individual blame]
103
+
104
+ #### Related Files
105
+ - [File 1 that was modified]
106
+ - [File 2 that was modified]
107
+
108
+ ---
109
+
110
+ ## 💡 PRO TIPS
111
+
112
+ 1. **Write immediately** - Emotional context fades fast
113
+ 2. **Include failed attempts** - Learning = what didn't work
114
+ 3. **Use real language** - "We screwed up" not "encountered issue"
115
+ 4. **Show numbers** - $cost, time, impact metrics
116
+ 5. **Add code snippets** - Error logs, broken → fixed
117
+ 6. **Make searchable** - Use #tags for future lookup
118
+ 7. **Blame the system** - Focus on process failures
119
+
120
+ ---
121
+
122
+ ## OUTPUT
123
+ Structured markdown, thorough but concise.
124
+ Blame the system, not individuals.
125
+ Include code snippets where relevant.
126
+ Make it searchable with tags.
127
+
128
+ > **Key Takeaway:** Transform expensive failures into permanent institutional knowledge. Learn once, don't fail repeatedly.
129
+ """
130
+
131
+ # ---
132
+ # USAGE:
133
+ # /journal What I accomplished today on the auth feature
134
+ # /journal Found race condition in payment 2hrs before release
135
+ # /journal Production DB outage for 6 hours
136
+ # /journal Weekly status update for team
137
137
  # ---
@@ -1,41 +1,41 @@
1
- description = "Interactive project setup wizard - create context files for new projects"
2
-
3
- prompt = """
4
- # 🚀 Kit Setup Wizard
5
-
6
- Hello! This is the wizard to setup project context for Super-Kit.
7
-
8
- ## I will help you create 3 context files:
9
-
10
- 1. **product.md** - Product description, users, goals
11
- 2. **tech-stack.md** - Language, framework, database
12
- 3. **guidelines.md** - Code style, commit conventions
13
-
14
- ---
15
-
16
- ## Step 1: Product Context
17
-
18
- Please tell me about your project:
19
-
20
- **Questions:**
21
- 1. What are you building? (One-line description)
22
- 2. Who are the primary users? (Developers, End users, Enterprises, etc.)
23
- 3. What is the main goal of the product?
24
- 4. What are the main features?
25
-
26
- ---
27
-
28
- When you finish answering, I will:
29
- 1. Create file `docs/agents/product.md`
30
- 2. Continue asking about Tech Stack
31
- 3. Continue asking about Guidelines
32
- 4. Complete setup!
33
-
34
- **You can answer freely or following the format:**
35
- ```
36
- Product: [description]
37
- Users: [who uses it]
38
- Goals: [goals]
39
- Features: [main features]
40
- ```
1
+ description = "Interactive project setup wizard - create context files for new projects"
2
+
3
+ prompt = """
4
+ # 🚀 Kit Setup Wizard
5
+
6
+ Hello! This is the wizard to setup project context for Super-Kit.
7
+
8
+ ## I will help you create 3 context files:
9
+
10
+ 1. **product.md** - Product description, users, goals
11
+ 2. **tech-stack.md** - Language, framework, database
12
+ 3. **guidelines.md** - Code style, commit conventions
13
+
14
+ ---
15
+
16
+ ## Step 1: Product Context
17
+
18
+ Please tell me about your project:
19
+
20
+ **Questions:**
21
+ 1. What are you building? (One-line description)
22
+ 2. Who are the primary users? (Developers, End users, Enterprises, etc.)
23
+ 3. What is the main goal of the product?
24
+ 4. What are the main features?
25
+
26
+ ---
27
+
28
+ When you finish answering, I will:
29
+ 1. Create file `docs/agents/product.md`
30
+ 2. Continue asking about Tech Stack
31
+ 3. Continue asking about Guidelines
32
+ 4. Complete setup!
33
+
34
+ **You can answer freely or following the format:**
35
+ ```
36
+ Product: [description]
37
+ Users: [who uses it]
38
+ Goals: [goals]
39
+ Features: [main features]
40
+ ```
41
41
  """