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,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
  """