@ekkos/cli 0.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.
- package/dist/cache/LocalSessionStore.d.ts +129 -0
- package/dist/cache/LocalSessionStore.js +688 -0
- package/dist/cache/capture.d.ts +26 -0
- package/dist/cache/capture.js +461 -0
- package/dist/cache/index.d.ts +7 -0
- package/dist/cache/index.js +23 -0
- package/dist/cache/types.d.ts +147 -0
- package/dist/cache/types.js +40 -0
- package/dist/commands/init.d.ts +9 -0
- package/dist/commands/init.js +478 -0
- package/dist/commands/run.d.ts +12 -0
- package/dist/commands/run.js +829 -0
- package/dist/commands/setup.d.ts +6 -0
- package/dist/commands/setup.js +658 -0
- package/dist/commands/status.d.ts +1 -0
- package/dist/commands/status.js +109 -0
- package/dist/commands/test.d.ts +1 -0
- package/dist/commands/test.js +157 -0
- package/dist/deploy/agents.d.ts +15 -0
- package/dist/deploy/agents.js +72 -0
- package/dist/deploy/hooks.d.ts +16 -0
- package/dist/deploy/hooks.js +121 -0
- package/dist/deploy/index.d.ts +7 -0
- package/dist/deploy/index.js +24 -0
- package/dist/deploy/instructions.d.ts +12 -0
- package/dist/deploy/instructions.js +36 -0
- package/dist/deploy/mcp.d.ts +19 -0
- package/dist/deploy/mcp.js +109 -0
- package/dist/deploy/plugins.d.ts +19 -0
- package/dist/deploy/plugins.js +62 -0
- package/dist/deploy/settings.d.ts +8 -0
- package/dist/deploy/settings.js +84 -0
- package/dist/deploy/skills.d.ts +19 -0
- package/dist/deploy/skills.js +60 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +71 -0
- package/dist/restore/RestoreOrchestrator.d.ts +48 -0
- package/dist/restore/RestoreOrchestrator.js +481 -0
- package/dist/restore/index.d.ts +4 -0
- package/dist/restore/index.js +20 -0
- package/dist/utils/platform.d.ts +29 -0
- package/dist/utils/platform.js +65 -0
- package/dist/utils/session-words.json +119 -0
- package/dist/utils/state.d.ts +57 -0
- package/dist/utils/state.js +186 -0
- package/dist/utils/templates.d.ts +24 -0
- package/dist/utils/templates.js +118 -0
- package/package.json +48 -0
- package/templates/CLAUDE.md +287 -0
- package/templates/README.md +378 -0
- package/templates/agents/README.md +182 -0
- package/templates/agents/code-reviewer.md +166 -0
- package/templates/agents/debug-detective.md +169 -0
- package/templates/agents/ekkOS_Vercel.md +99 -0
- package/templates/agents/extension-manager.md +229 -0
- package/templates/agents/git-companion.md +185 -0
- package/templates/agents/github-test-agent.md +321 -0
- package/templates/agents/railway-manager.md +179 -0
- package/templates/claude-plugins/PHASE2_COMPLETION.md +346 -0
- package/templates/claude-plugins/PLUGIN_PROPOSALS.md +1776 -0
- package/templates/claude-plugins/README.md +587 -0
- package/templates/claude-plugins/agents/code-reviewer.json +14 -0
- package/templates/claude-plugins/agents/debug-detective.json +15 -0
- package/templates/claude-plugins/agents/git-companion.json +14 -0
- package/templates/claude-plugins/blog-manager/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/blog-manager/commands/blog.md +691 -0
- package/templates/claude-plugins/golden-loop-monitor/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/golden-loop-monitor/commands/loop-status.md +434 -0
- package/templates/claude-plugins/learning-tracker/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/learning-tracker/commands/my-patterns.md +282 -0
- package/templates/claude-plugins/memory-lens/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/memory-lens/commands/memory-search.md +181 -0
- package/templates/claude-plugins/pattern-coach/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/pattern-coach/commands/forge.md +365 -0
- package/templates/claude-plugins/project-schema-validator/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins/project-schema-validator/commands/validate-schema.md +582 -0
- package/templates/claude-plugins-admin/AGENT_TEAM_PROPOSALS.md +819 -0
- package/templates/claude-plugins-admin/README.md +446 -0
- package/templates/claude-plugins-admin/autonomous-admin-agent/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/autonomous-admin-agent/commands/agent.md +595 -0
- package/templates/claude-plugins-admin/backend-agent/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/backend-agent/commands/backend.md +798 -0
- package/templates/claude-plugins-admin/deploy-guardian/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/deploy-guardian/commands/deploy.md +554 -0
- package/templates/claude-plugins-admin/frontend-agent/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/frontend-agent/commands/frontend.md +881 -0
- package/templates/claude-plugins-admin/mcp-server-manager/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/mcp-server-manager/commands/mcp.md +85 -0
- package/templates/claude-plugins-admin/memory-system-monitor/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/memory-system-monitor/commands/memory-health.md +569 -0
- package/templates/claude-plugins-admin/qa-agent/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/qa-agent/commands/qa.md +863 -0
- package/templates/claude-plugins-admin/tech-lead-agent/.claude-plugin/plugin.json +8 -0
- package/templates/claude-plugins-admin/tech-lead-agent/commands/lead.md +732 -0
- package/templates/commands/continue.md +47 -0
- package/templates/cursor-hooks/after-agent-response.sh +117 -0
- package/templates/cursor-hooks/before-submit-prompt.sh +419 -0
- package/templates/cursor-hooks/hooks.json +20 -0
- package/templates/cursor-hooks/lib/contract.sh +320 -0
- package/templates/cursor-hooks/stop.sh +75 -0
- package/templates/cursor-rules/ekkos-memory.md +187 -0
- package/templates/hooks/assistant-response.sh +96 -0
- package/templates/hooks/hooks.json +28 -0
- package/templates/hooks/lib/contract.sh +320 -0
- package/templates/hooks/lib/state.sh +158 -0
- package/templates/hooks/session-start.ps1 +41 -0
- package/templates/hooks/session-start.sh +318 -0
- package/templates/hooks/stop.ps1 +16 -0
- package/templates/hooks/stop.sh +989 -0
- package/templates/hooks/user-prompt-submit.ps1 +174 -0
- package/templates/hooks/user-prompt-submit.sh +587 -0
- package/templates/hooks-node/lib/state.js +187 -0
- package/templates/hooks-node/stop.js +416 -0
- package/templates/hooks-node/user-prompt-submit.js +337 -0
- package/templates/plan-template.md +306 -0
- package/templates/rules/00-hooks-contract.mdc +89 -0
- package/templates/rules/30-ekkos-core.mdc +188 -0
- package/templates/rules/31-ekkos-messages.mdc +78 -0
- package/templates/skills/continue/SKILL.md +169 -0
- package/templates/skills/ekkOS_Deep_Recall/Skill.md +282 -0
- package/templates/skills/ekkOS_Learn/Skill.md +265 -0
- package/templates/skills/ekkOS_Memory_First/Skill.md +206 -0
- package/templates/skills/ekkOS_Plan_Assist/Skill.md +302 -0
- package/templates/skills/ekkOS_Preferences/Skill.md +247 -0
- package/templates/skills/ekkOS_Reflect/Skill.md +257 -0
- package/templates/skills/ekkOS_Safety/Skill.md +265 -0
- package/templates/skills/ekkOS_Schema/Skill.md +251 -0
- package/templates/skills/ekkOS_Summary/Skill.md +257 -0
- package/templates/skills/ekkOS_Vault/Skill.md +287 -0
- package/templates/skills/permissions/Skill.md +322 -0
- package/templates/spec-template.md +159 -0
- package/templates/windsurf-hooks/before-submit-prompt.sh +238 -0
- package/templates/windsurf-hooks/hooks.json +10 -0
- package/templates/windsurf-hooks/lib/contract.sh +320 -0
- package/templates/windsurf-rules/ekkos-memory.md +129 -0
|
@@ -0,0 +1,1776 @@
|
|
|
1
|
+
# Additional Plugin Proposals for ekkOS Users
|
|
2
|
+
|
|
3
|
+
**Based on 31 MCP Tools + Multi-Tool Combinations**
|
|
4
|
+
|
|
5
|
+
This document proposes 10 additional user-focused plugins beyond the 5 core plugins (Memory Lens, Pattern Coach, Learning Tracker, Golden Loop Monitor, Project Schema Validator).
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Current Plugin Coverage (5 Plugins)
|
|
10
|
+
|
|
11
|
+
| Plugin | Commands | MCP Tools Used | Golden Loop Phase |
|
|
12
|
+
|--------|----------|----------------|-------------------|
|
|
13
|
+
| Memory Lens | `/memory-search` | ekkOS_Search, ekkOS_Stats | RETRIEVE |
|
|
14
|
+
| Pattern Coach | `/forge` | ekkOS_Forge, ekkOS_Directive, ekkOS_Search | LEARN |
|
|
15
|
+
| Learning Tracker | `/my-patterns` | ekkOS_Stats, ekkOS_Search | Monitor (Growth) |
|
|
16
|
+
| Golden Loop Monitor | `/loop-status` | ekkOS_Summary, ekkOS_Stats, ekkOS_Search | Monitor (Health) |
|
|
17
|
+
| Project Schema Validator | `/validate-schema` | ekkOS_IndexSchema, ekkOS_GetSchema, ekkOS_Codebase | APPLY |
|
|
18
|
+
|
|
19
|
+
**MCP Tools Covered:** 8/31 (26%)
|
|
20
|
+
|
|
21
|
+
**Tools NOT yet used in plugins (but ALL are user-facing):**
|
|
22
|
+
- ekkOS_Context
|
|
23
|
+
- ekkOS_Capture (manual event capture)
|
|
24
|
+
- ekkOS_Outcome (manual outcome tracking)
|
|
25
|
+
- ekkOS_Detect (show detected patterns)
|
|
26
|
+
- ekkOS_Conflict
|
|
27
|
+
- ekkOS_Recall
|
|
28
|
+
- ekkOS_Track (manual pattern tracking)
|
|
29
|
+
- ekkOS_Reflect
|
|
30
|
+
- ekkOS_Export/Import
|
|
31
|
+
- ekkOS_Plan family (8 tools - ALL user-facing, not admin)
|
|
32
|
+
- ekkOS_Secret family (5 tools)
|
|
33
|
+
|
|
34
|
+
**IMPORTANT:** All 31 MCP tools are user-facing tools attached to user IDs, not admin tools. Plan management, tracking, and capture tools are meant for users to manage their own work.
|
|
35
|
+
|
|
36
|
+
**SECURITY:** While all tools are user-facing, plugins MUST ensure data isolation:
|
|
37
|
+
- Only show data for the authenticated user (user_id scoped)
|
|
38
|
+
- Never expose other users' patterns, plans, secrets, or memory
|
|
39
|
+
- Never expose ekkOS internal/admin data
|
|
40
|
+
- Use `user_only` filters in ekkOS_Search
|
|
41
|
+
- Verify user_id matches on all operations
|
|
42
|
+
- Secrets remain encrypted and user-scoped
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Proposed Additional Plugins (11)
|
|
47
|
+
|
|
48
|
+
### 1. 🕰️ Time Travel Debugger
|
|
49
|
+
|
|
50
|
+
**Command:** `/time-travel`
|
|
51
|
+
|
|
52
|
+
**Purpose:** "What was I working on when this bug appeared? What changed since then?"
|
|
53
|
+
|
|
54
|
+
**User Need:** Developers need to reconstruct context from past work to understand when/why bugs were introduced.
|
|
55
|
+
|
|
56
|
+
**Multi-Tool Combination:**
|
|
57
|
+
- `ekkOS_Recall` - Get conversations from specific timeframe
|
|
58
|
+
- `ekkOS_Search` - Find patterns related to the bug
|
|
59
|
+
- `ekkOS_Codebase` - Search code changes
|
|
60
|
+
- `ekkOS_Summary` - Recent activity summary
|
|
61
|
+
|
|
62
|
+
**Example Usage:**
|
|
63
|
+
```bash
|
|
64
|
+
# Recall what happened 2 days ago
|
|
65
|
+
/time-travel --days-ago 2
|
|
66
|
+
|
|
67
|
+
# Find when you last worked on auth
|
|
68
|
+
/time-travel "authentication" --last-week
|
|
69
|
+
|
|
70
|
+
# Debug: "When did I change the login flow?"
|
|
71
|
+
/time-travel "login flow changes"
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**Example Output:**
|
|
75
|
+
```
|
|
76
|
+
🕰️ Time Travel: 2 days ago (Jan 5, 2026)
|
|
77
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
78
|
+
|
|
79
|
+
📅 Conversations on Jan 5:
|
|
80
|
+
|
|
81
|
+
10:30 AM - "Fix JWT expiration bug"
|
|
82
|
+
• You discovered JWT tokens expiring too early
|
|
83
|
+
• Changed expiration from 1h to 24h
|
|
84
|
+
• Forged pattern: "Set JWT expiration to 24h for web apps"
|
|
85
|
+
|
|
86
|
+
2:15 PM - "Add user profile API endpoint"
|
|
87
|
+
• Created /api/users/[id]/profile
|
|
88
|
+
• Added profile image upload
|
|
89
|
+
• Modified User model: added profileImageUrl
|
|
90
|
+
|
|
91
|
+
4:45 PM - "Database migration for profiles"
|
|
92
|
+
• Added profileImageUrl to users table
|
|
93
|
+
• IMPORTANT: Changed avatarUrl → profileImageUrl
|
|
94
|
+
|
|
95
|
+
───────────────────────────────────────────────────────────────────
|
|
96
|
+
🔍 Related Patterns Forged That Day:
|
|
97
|
+
|
|
98
|
+
1. "JWT tokens should be 24h for web, 7d for mobile"
|
|
99
|
+
2. "Always update TypeScript types after Prisma schema changes"
|
|
100
|
+
3. "Use signed URLs for S3 uploads, not public buckets"
|
|
101
|
+
|
|
102
|
+
───────────────────────────────────────────────────────────────────
|
|
103
|
+
💡 Why This Matters Now:
|
|
104
|
+
|
|
105
|
+
Current bug: "Cannot access user.avatarUrl"
|
|
106
|
+
|
|
107
|
+
Cause: On Jan 5 at 4:45 PM, you renamed the field!
|
|
108
|
+
Old: avatarUrl
|
|
109
|
+
New: profileImageUrl
|
|
110
|
+
|
|
111
|
+
Fix: Update your code to use profileImageUrl instead.
|
|
112
|
+
|
|
113
|
+
───────────────────────────────────────────────────────────────────
|
|
114
|
+
🔗 Related Commands:
|
|
115
|
+
|
|
116
|
+
• See that day's patterns: /my-patterns --date 2026-01-05
|
|
117
|
+
• Check schema: /validate-schema users
|
|
118
|
+
• Fix field names: Update all avatarUrl → profileImageUrl
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
**Value:** Helps debug "when did this break?" questions by showing historical context.
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
### 2. 🔐 Secret Vault
|
|
126
|
+
|
|
127
|
+
**Command:** `/secrets`
|
|
128
|
+
|
|
129
|
+
**Purpose:** Manage all credentials, API keys, and sensitive config in one secure place.
|
|
130
|
+
|
|
131
|
+
**User Need:** Developers need a secure, convenient way to store and use API keys, tokens, passwords without hardcoding them.
|
|
132
|
+
|
|
133
|
+
**Multi-Tool Combination:**
|
|
134
|
+
- `ekkOS_StoreSecret` - Encrypt and save secrets
|
|
135
|
+
- `ekkOS_GetSecret` - Retrieve decrypted secrets
|
|
136
|
+
- `ekkOS_ListSecrets` - Show what's stored (metadata only)
|
|
137
|
+
- `ekkOS_RotateSecret` - Update secrets (key rotation)
|
|
138
|
+
- `ekkOS_DeleteSecret` - Remove secrets
|
|
139
|
+
|
|
140
|
+
**Example Usage:**
|
|
141
|
+
```bash
|
|
142
|
+
# Store a secret
|
|
143
|
+
/secrets store github ghp_abc123xyz789
|
|
144
|
+
|
|
145
|
+
# List all secrets
|
|
146
|
+
/secrets list
|
|
147
|
+
|
|
148
|
+
# Get a secret
|
|
149
|
+
/secrets get github
|
|
150
|
+
|
|
151
|
+
# Rotate a secret (update)
|
|
152
|
+
/secrets rotate github ghp_NEW_KEY
|
|
153
|
+
|
|
154
|
+
# Delete a secret
|
|
155
|
+
/secrets delete github
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**Example Output:**
|
|
159
|
+
```
|
|
160
|
+
🔐 Secret Vault
|
|
161
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
162
|
+
|
|
163
|
+
📋 Your Stored Secrets:
|
|
164
|
+
|
|
165
|
+
1. ✅ github
|
|
166
|
+
Type: API Key
|
|
167
|
+
Stored: 2 weeks ago
|
|
168
|
+
Last accessed: 3 hours ago
|
|
169
|
+
Expiry: Never
|
|
170
|
+
|
|
171
|
+
2. ✅ openai
|
|
172
|
+
Type: API Key
|
|
173
|
+
Stored: 1 month ago
|
|
174
|
+
Last accessed: Today
|
|
175
|
+
Expiry: Never
|
|
176
|
+
|
|
177
|
+
3. ✅ stripe
|
|
178
|
+
Type: API Key
|
|
179
|
+
Stored: 3 days ago
|
|
180
|
+
Last accessed: 2 days ago
|
|
181
|
+
Expiry: Never
|
|
182
|
+
|
|
183
|
+
4. ⚠️ aws-access-key
|
|
184
|
+
Type: Credential
|
|
185
|
+
Stored: 6 months ago
|
|
186
|
+
Last accessed: Never
|
|
187
|
+
Expiry: STALE (recommend rotation)
|
|
188
|
+
|
|
189
|
+
5. ✅ database-url
|
|
190
|
+
Type: Connection String
|
|
191
|
+
Stored: 1 week ago
|
|
192
|
+
Last accessed: Today
|
|
193
|
+
Expiry: Never
|
|
194
|
+
|
|
195
|
+
───────────────────────────────────────────────────────────────────
|
|
196
|
+
🔒 Security Status: GOOD
|
|
197
|
+
|
|
198
|
+
All secrets encrypted with AES-256-GCM.
|
|
199
|
+
No secrets exposed in code or logs.
|
|
200
|
+
|
|
201
|
+
⚠️ 1 stale secret detected (aws-access-key)
|
|
202
|
+
→ Run: /secrets rotate aws-access-key
|
|
203
|
+
|
|
204
|
+
───────────────────────────────────────────────────────────────────
|
|
205
|
+
📖 Quick Actions:
|
|
206
|
+
|
|
207
|
+
• Add new secret: /secrets store <name> <value>
|
|
208
|
+
• Get secret: /secrets get <name>
|
|
209
|
+
• View secret (masked): /secrets get <name> --masked
|
|
210
|
+
• Rotate key: /secrets rotate <name> <new-value>
|
|
211
|
+
• Delete: /secrets delete <name>
|
|
212
|
+
|
|
213
|
+
───────────────────────────────────────────────────────────────────
|
|
214
|
+
💡 Best Practices:
|
|
215
|
+
|
|
216
|
+
✅ Store all API keys here (never hardcode)
|
|
217
|
+
✅ Use masked mode to check without revealing
|
|
218
|
+
✅ Rotate keys every 90 days
|
|
219
|
+
✅ Delete unused secrets
|
|
220
|
+
❌ Don't share secrets via chat/email
|
|
221
|
+
❌ Don't commit .env files with real keys
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
**Value:** Secure, convenient credential management with audit trail.
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
### 3. ⚠️ Pre-Flight Checker
|
|
229
|
+
|
|
230
|
+
**Command:** `/check`
|
|
231
|
+
|
|
232
|
+
**Purpose:** "Is it safe to run this command? Will I break something?"
|
|
233
|
+
|
|
234
|
+
**User Need:** Developers need confidence before running destructive operations (delete, deploy, drop database, etc.).
|
|
235
|
+
|
|
236
|
+
**Multi-Tool Combination:**
|
|
237
|
+
- `ekkOS_Conflict` - Check against user directives
|
|
238
|
+
- `ekkOS_Search` - Find past incidents with this action
|
|
239
|
+
- `ekkOS_Directive` - Show relevant NEVER/MUST rules
|
|
240
|
+
- `ekkOS_Recall` - "Last time I did this..."
|
|
241
|
+
|
|
242
|
+
**Example Usage:**
|
|
243
|
+
```bash
|
|
244
|
+
# Check before deleting
|
|
245
|
+
/check "delete all files in /tmp"
|
|
246
|
+
|
|
247
|
+
# Check before deploy
|
|
248
|
+
/check "deploy to production"
|
|
249
|
+
|
|
250
|
+
# Check before migration
|
|
251
|
+
/check "drop users table"
|
|
252
|
+
|
|
253
|
+
# Check command safety
|
|
254
|
+
/check "rm -rf node_modules"
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
**Example Output - Safe:**
|
|
258
|
+
```
|
|
259
|
+
⚠️ Pre-Flight Check
|
|
260
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
261
|
+
|
|
262
|
+
Proposed Action: "rm -rf node_modules"
|
|
263
|
+
|
|
264
|
+
───────────────────────────────────────────────────────────────────
|
|
265
|
+
✅ SAFE TO PROCEED
|
|
266
|
+
|
|
267
|
+
No conflicts or warnings detected.
|
|
268
|
+
|
|
269
|
+
───────────────────────────────────────────────────────────────────
|
|
270
|
+
📊 Analysis:
|
|
271
|
+
|
|
272
|
+
✅ No user directives prohibit this action
|
|
273
|
+
✅ No past incidents with this command
|
|
274
|
+
✅ Standard node.js operation
|
|
275
|
+
✅ Can be recovered (npm install)
|
|
276
|
+
|
|
277
|
+
───────────────────────────────────────────────────────────────────
|
|
278
|
+
💡 Recommendation:
|
|
279
|
+
|
|
280
|
+
This is safe. Deleting node_modules is a common troubleshooting step.
|
|
281
|
+
|
|
282
|
+
After deletion, run: npm install
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
**Example Output - Dangerous:**
|
|
286
|
+
```
|
|
287
|
+
⚠️ Pre-Flight Check
|
|
288
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
289
|
+
|
|
290
|
+
Proposed Action: "deploy to production"
|
|
291
|
+
|
|
292
|
+
───────────────────────────────────────────────────────────────────
|
|
293
|
+
🚨 STOP! Issues Detected
|
|
294
|
+
|
|
295
|
+
❌ 3 conflicts found
|
|
296
|
+
|
|
297
|
+
───────────────────────────────────────────────────────────────────
|
|
298
|
+
❌ Conflict #1: User Directive (NEVER)
|
|
299
|
+
|
|
300
|
+
Rule: "Never deploy to production on Friday"
|
|
301
|
+
Created: 3 months ago (after production incident)
|
|
302
|
+
Reason: "Fridays = no one around for weekend issues"
|
|
303
|
+
|
|
304
|
+
Current day: Friday, Jan 7, 2026
|
|
305
|
+
|
|
306
|
+
⛔ This action violates your rule!
|
|
307
|
+
|
|
308
|
+
───────────────────────────────────────────────────────────────────
|
|
309
|
+
❌ Conflict #2: Past Incident
|
|
310
|
+
|
|
311
|
+
Date: Dec 15, 2025 (3 weeks ago)
|
|
312
|
+
Incident: "Production deploy broke authentication"
|
|
313
|
+
Pattern forged: "Always run tests before deploying"
|
|
314
|
+
|
|
315
|
+
Have you run tests? If not, DON'T deploy yet.
|
|
316
|
+
|
|
317
|
+
───────────────────────────────────────────────────────────────────
|
|
318
|
+
❌ Conflict #3: User Directive (MUST)
|
|
319
|
+
|
|
320
|
+
Rule: "Must have code review before production deploy"
|
|
321
|
+
Created: 2 months ago
|
|
322
|
+
|
|
323
|
+
Current PR status: No reviews yet
|
|
324
|
+
|
|
325
|
+
⛔ Get review first!
|
|
326
|
+
|
|
327
|
+
───────────────────────────────────────────────────────────────────
|
|
328
|
+
🔧 Required Steps Before Proceeding:
|
|
329
|
+
|
|
330
|
+
[ ] 1. Wait until Monday (or override if emergency)
|
|
331
|
+
[ ] 2. Run full test suite: npm test
|
|
332
|
+
[ ] 3. Get code review approval on PR
|
|
333
|
+
[ ] 4. Verify staging environment works
|
|
334
|
+
[ ] 5. Have rollback plan ready
|
|
335
|
+
|
|
336
|
+
───────────────────────────────────────────────────────────────────
|
|
337
|
+
🚨 High Risk Action
|
|
338
|
+
|
|
339
|
+
If you proceed anyway, you're ignoring:
|
|
340
|
+
• Your own rules (set for a reason!)
|
|
341
|
+
• Past incidents (already broke prod once)
|
|
342
|
+
• Best practices (untested code to production)
|
|
343
|
+
|
|
344
|
+
Recommendation: DON'T DEPLOY until requirements met.
|
|
345
|
+
|
|
346
|
+
───────────────────────────────────────────────────────────────────
|
|
347
|
+
❓ Emergency Override?
|
|
348
|
+
|
|
349
|
+
If this is truly urgent:
|
|
350
|
+
1. /check --override "Reason for emergency deploy"
|
|
351
|
+
2. Document why you're overriding safety checks
|
|
352
|
+
3. Be prepared to rollback if needed
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
**Value:** Prevents repeating past mistakes, enforces safety rules, builds institutional knowledge.
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
### 4. 📈 Pattern Quality Coach
|
|
360
|
+
|
|
361
|
+
**Command:** `/improve-patterns`
|
|
362
|
+
|
|
363
|
+
**Purpose:** "Which of my patterns are low-quality? How can I make them better?"
|
|
364
|
+
|
|
365
|
+
**User Need:** Users want to improve their pattern library quality over time.
|
|
366
|
+
|
|
367
|
+
**Multi-Tool Combination:**
|
|
368
|
+
- `ekkOS_Search` - Get all user patterns
|
|
369
|
+
- `ekkOS_Stats` - Get success rates
|
|
370
|
+
- `ekkOS_Outcome` - Outcome tracking data
|
|
371
|
+
- `ekkOS_Reflect` - Analyze pattern quality
|
|
372
|
+
- `ekkOS_Forge` - Update patterns
|
|
373
|
+
|
|
374
|
+
**Example Usage:**
|
|
375
|
+
```bash
|
|
376
|
+
# Analyze all patterns
|
|
377
|
+
/improve-patterns
|
|
378
|
+
|
|
379
|
+
# Show only low-quality patterns
|
|
380
|
+
/improve-patterns --low-quality
|
|
381
|
+
|
|
382
|
+
# Analyze specific pattern
|
|
383
|
+
/improve-patterns pat_abc123
|
|
384
|
+
|
|
385
|
+
# Get improvement suggestions
|
|
386
|
+
/improve-patterns --suggest
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
**Example Output:**
|
|
390
|
+
```
|
|
391
|
+
📈 Pattern Quality Report
|
|
392
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
393
|
+
|
|
394
|
+
Analyzing your 42 patterns...
|
|
395
|
+
|
|
396
|
+
───────────────────────────────────────────────────────────────────
|
|
397
|
+
✅ High Quality (30 patterns)
|
|
398
|
+
|
|
399
|
+
Average success rate: 91%
|
|
400
|
+
These patterns are working great! Keep using them.
|
|
401
|
+
|
|
402
|
+
───────────────────────────────────────────────────────────────────
|
|
403
|
+
⚠️ Needs Improvement (7 patterns)
|
|
404
|
+
|
|
405
|
+
1. "Fix webpack build errors" - 45% success ⭐⭐☆☆☆
|
|
406
|
+
Problem: Too vague, applies to many different errors
|
|
407
|
+
|
|
408
|
+
Suggestion:
|
|
409
|
+
• Split into specific patterns:
|
|
410
|
+
- "Fix webpack module not found"
|
|
411
|
+
- "Fix webpack CSS loader issues"
|
|
412
|
+
- "Fix webpack memory errors"
|
|
413
|
+
• Add "works_when" conditions
|
|
414
|
+
• Include example error messages
|
|
415
|
+
|
|
416
|
+
Action: /forge --update pat_abc123
|
|
417
|
+
|
|
418
|
+
2. "API timeout handling" - 58% success ⭐⭐⭐☆☆
|
|
419
|
+
Problem: Missing implementation details
|
|
420
|
+
|
|
421
|
+
Current pattern:
|
|
422
|
+
"Handle API timeouts gracefully"
|
|
423
|
+
|
|
424
|
+
Improved pattern should include:
|
|
425
|
+
• Specific timeout value (5s? 30s?)
|
|
426
|
+
• Retry logic (exponential backoff?)
|
|
427
|
+
• Error message to show user
|
|
428
|
+
• Which APIs this applies to
|
|
429
|
+
|
|
430
|
+
Action: /forge --update pat_def456
|
|
431
|
+
|
|
432
|
+
3. "Database connection issue" - 52% success ⭐⭐⭐☆☆
|
|
433
|
+
Problem: No anti-patterns listed
|
|
434
|
+
|
|
435
|
+
What NOT to do:
|
|
436
|
+
❌ Don't increase pool size infinitely
|
|
437
|
+
❌ Don't retry without delay
|
|
438
|
+
❌ Don't ignore connection errors
|
|
439
|
+
|
|
440
|
+
Add anti-patterns to make this more valuable.
|
|
441
|
+
|
|
442
|
+
Action: /forge --update pat_ghi789
|
|
443
|
+
|
|
444
|
+
[... 4 more patterns ...]
|
|
445
|
+
|
|
446
|
+
───────────────────────────────────────────────────────────────────
|
|
447
|
+
❌ Low Quality (5 patterns)
|
|
448
|
+
|
|
449
|
+
These patterns have < 50% success. Consider archiving or rewriting.
|
|
450
|
+
|
|
451
|
+
1. "Fix the bug" - 12% success ⭐☆☆☆☆
|
|
452
|
+
Problem: WAY too vague. What bug? How to fix?
|
|
453
|
+
|
|
454
|
+
Recommendation: Archive this and create specific patterns instead.
|
|
455
|
+
|
|
456
|
+
Action: /my-patterns --archive pat_jkl012
|
|
457
|
+
|
|
458
|
+
2. "Update config" - 23% success ⭐☆☆☆☆
|
|
459
|
+
Problem: No details about which config or what to update
|
|
460
|
+
|
|
461
|
+
Recommendation: Replace with specific config patterns:
|
|
462
|
+
• "Update CORS config to allow subdomain"
|
|
463
|
+
• "Update rate limit to 100 req/min"
|
|
464
|
+
|
|
465
|
+
Action: /forge --update pat_mno345
|
|
466
|
+
|
|
467
|
+
[... 3 more patterns ...]
|
|
468
|
+
|
|
469
|
+
───────────────────────────────────────────────────────────────────
|
|
470
|
+
📊 Quality Metrics
|
|
471
|
+
|
|
472
|
+
Average pattern success rate: 84%
|
|
473
|
+
├─ High quality (>80%): 30 patterns
|
|
474
|
+
├─ Medium quality (50-80%): 7 patterns
|
|
475
|
+
└─ Low quality (<50%): 5 patterns
|
|
476
|
+
|
|
477
|
+
───────────────────────────────────────────────────────────────────
|
|
478
|
+
🎯 Improvement Goals
|
|
479
|
+
|
|
480
|
+
Target: 90% average success rate
|
|
481
|
+
|
|
482
|
+
If you:
|
|
483
|
+
• Update 7 medium-quality patterns → 88% avg
|
|
484
|
+
• Archive 5 low-quality patterns → 91% avg ✅
|
|
485
|
+
|
|
486
|
+
───────────────────────────────────────────────────────────────────
|
|
487
|
+
💡 Pattern Quality Checklist
|
|
488
|
+
|
|
489
|
+
High-quality patterns have:
|
|
490
|
+
✅ Specific problem statement
|
|
491
|
+
✅ Clear solution with steps
|
|
492
|
+
✅ "Works when" conditions
|
|
493
|
+
✅ Anti-patterns (what NOT to do)
|
|
494
|
+
✅ Example code or commands
|
|
495
|
+
✅ Tags for categorization
|
|
496
|
+
|
|
497
|
+
Low-quality patterns are:
|
|
498
|
+
❌ Vague ("fix the bug")
|
|
499
|
+
❌ Missing context
|
|
500
|
+
❌ No success conditions
|
|
501
|
+
❌ Too broad or too narrow
|
|
502
|
+
❌ Never used (0 applications)
|
|
503
|
+
|
|
504
|
+
───────────────────────────────────────────────────────────────────
|
|
505
|
+
🔗 Quick Actions
|
|
506
|
+
|
|
507
|
+
• Update pattern: /forge --update <pattern_id>
|
|
508
|
+
• Archive pattern: /my-patterns --archive <pattern_id>
|
|
509
|
+
• View pattern details: /memory-search <pattern_title>
|
|
510
|
+
• Check pattern usage: /my-patterns --pattern <pattern_id>
|
|
511
|
+
```
|
|
512
|
+
|
|
513
|
+
**Value:** Helps users continuously improve their pattern library quality.
|
|
514
|
+
|
|
515
|
+
---
|
|
516
|
+
|
|
517
|
+
### 5. 🚀 Project Onboarding
|
|
518
|
+
|
|
519
|
+
**Command:** `/onboard`
|
|
520
|
+
|
|
521
|
+
**Purpose:** "I'm starting a fresh project. Help me set up best practices from the start."
|
|
522
|
+
|
|
523
|
+
**User Need:** New projects need structure, and users want to apply proven patterns from day 1.
|
|
524
|
+
|
|
525
|
+
**Multi-Tool Combination:**
|
|
526
|
+
- `ekkOS_Plan` - Create project setup plan
|
|
527
|
+
- `ekkOS_Generate` - AI-generate plan from project type
|
|
528
|
+
- `ekkOS_Templates` - Use proven project templates
|
|
529
|
+
- `ekkOS_Search` - Find relevant patterns for project type
|
|
530
|
+
- `ekkOS_Forge` - Create project-specific patterns
|
|
531
|
+
|
|
532
|
+
**Example Usage:**
|
|
533
|
+
```bash
|
|
534
|
+
# Start new project
|
|
535
|
+
/onboard
|
|
536
|
+
|
|
537
|
+
# Specific project type
|
|
538
|
+
/onboard --type nextjs
|
|
539
|
+
|
|
540
|
+
# With tech stack
|
|
541
|
+
/onboard --stack "nextjs,prisma,tailwind"
|
|
542
|
+
|
|
543
|
+
# Resume onboarding
|
|
544
|
+
/onboard --resume
|
|
545
|
+
```
|
|
546
|
+
|
|
547
|
+
**Example Output:**
|
|
548
|
+
```
|
|
549
|
+
🚀 Project Onboarding Wizard
|
|
550
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
551
|
+
|
|
552
|
+
Let's set up your new project with best practices from the start!
|
|
553
|
+
|
|
554
|
+
───────────────────────────────────────────────────────────────────
|
|
555
|
+
📋 Project Details
|
|
556
|
+
|
|
557
|
+
Project type: Next.js + TypeScript + Prisma
|
|
558
|
+
Framework: Next.js 14 (App Router)
|
|
559
|
+
Database: PostgreSQL (via Supabase)
|
|
560
|
+
Styling: Tailwind CSS
|
|
561
|
+
Auth: Next-Auth
|
|
562
|
+
|
|
563
|
+
───────────────────────────────────────────────────────────────────
|
|
564
|
+
🎯 Onboarding Plan (8 steps)
|
|
565
|
+
|
|
566
|
+
Based on proven patterns from 23 successful projects.
|
|
567
|
+
|
|
568
|
+
✅ 1. Initialize Next.js project
|
|
569
|
+
Status: Complete
|
|
570
|
+
Time: 2 minutes
|
|
571
|
+
|
|
572
|
+
✅ 2. Setup TypeScript with strict mode
|
|
573
|
+
Status: Complete
|
|
574
|
+
Applied pattern: "Always use TypeScript strict mode"
|
|
575
|
+
|
|
576
|
+
⏳ 3. Configure Prisma + PostgreSQL
|
|
577
|
+
Status: In Progress
|
|
578
|
+
|
|
579
|
+
Steps:
|
|
580
|
+
[✅] npm install prisma @prisma/client
|
|
581
|
+
[✅] npx prisma init
|
|
582
|
+
[⏳] Configure DATABASE_URL in .env
|
|
583
|
+
[ ] Define initial schema
|
|
584
|
+
[ ] Run first migration
|
|
585
|
+
|
|
586
|
+
💡 Pattern applied: "Use Supabase for managed PostgreSQL"
|
|
587
|
+
|
|
588
|
+
Next: Add DATABASE_URL to .env
|
|
589
|
+
|
|
590
|
+
[ ] 4. Setup authentication (Next-Auth)
|
|
591
|
+
Pattern: "Use Next-Auth with JWT for Next.js apps"
|
|
592
|
+
Estimated: 15 minutes
|
|
593
|
+
|
|
594
|
+
[ ] 5. Configure Tailwind CSS
|
|
595
|
+
Pattern: "Use Tailwind with custom design system"
|
|
596
|
+
Estimated: 5 minutes
|
|
597
|
+
|
|
598
|
+
[ ] 6. Setup ESLint + Prettier
|
|
599
|
+
Pattern: "Enforce code style with ESLint + Prettier"
|
|
600
|
+
Estimated: 5 minutes
|
|
601
|
+
|
|
602
|
+
[ ] 7. Add environment variable validation
|
|
603
|
+
Pattern: "Validate env vars at build time with Zod"
|
|
604
|
+
Estimated: 10 minutes
|
|
605
|
+
|
|
606
|
+
[ ] 8. Configure deployment (Vercel)
|
|
607
|
+
Pattern: "Deploy Next.js to Vercel with preview URLs"
|
|
608
|
+
Estimated: 10 minutes
|
|
609
|
+
|
|
610
|
+
───────────────────────────────────────────────────────────────────
|
|
611
|
+
📚 Patterns Applied (3 so far)
|
|
612
|
+
|
|
613
|
+
1. ⭐⭐⭐⭐⭐ "TypeScript strict mode for all projects"
|
|
614
|
+
Success: 98% (from 41 projects)
|
|
615
|
+
Why: Catches type errors at build time
|
|
616
|
+
|
|
617
|
+
2. ⭐⭐⭐⭐⭐ "Use Supabase for managed PostgreSQL"
|
|
618
|
+
Success: 95% (from 28 projects)
|
|
619
|
+
Why: No database management overhead
|
|
620
|
+
|
|
621
|
+
3. ⭐⭐⭐⭐☆ "Next-Auth with JWT for authentication"
|
|
622
|
+
Success: 92% (from 34 projects)
|
|
623
|
+
Why: Industry standard, well-documented
|
|
624
|
+
|
|
625
|
+
───────────────────────────────────────────────────────────────────
|
|
626
|
+
⚠️ Common Pitfalls Avoided
|
|
627
|
+
|
|
628
|
+
✅ Avoided: "Using 'any' type in TypeScript"
|
|
629
|
+
Why: Type safety is the whole point of TypeScript
|
|
630
|
+
|
|
631
|
+
✅ Avoided: "Self-hosting PostgreSQL for first project"
|
|
632
|
+
Why: Adds unnecessary complexity early on
|
|
633
|
+
|
|
634
|
+
✅ Avoided: "Rolling your own auth"
|
|
635
|
+
Why: Security is hard, use battle-tested library
|
|
636
|
+
|
|
637
|
+
───────────────────────────────────────────────────────────────────
|
|
638
|
+
💡 Next Steps
|
|
639
|
+
|
|
640
|
+
Current step: Configure DATABASE_URL
|
|
641
|
+
|
|
642
|
+
1. Go to Supabase dashboard
|
|
643
|
+
2. Create new project (or use existing)
|
|
644
|
+
3. Copy connection string from Settings > Database
|
|
645
|
+
4. Add to .env:
|
|
646
|
+
```
|
|
647
|
+
DATABASE_URL="postgresql://..."
|
|
648
|
+
```
|
|
649
|
+
5. Run: npx prisma migrate dev --name init
|
|
650
|
+
|
|
651
|
+
After completing, run: /onboard --continue
|
|
652
|
+
|
|
653
|
+
───────────────────────────────────────────────────────────────────
|
|
654
|
+
📊 Progress: 25% Complete (2/8 steps)
|
|
655
|
+
|
|
656
|
+
Estimated time remaining: 45 minutes
|
|
657
|
+
|
|
658
|
+
You're building on proven patterns from 23 successful projects!
|
|
659
|
+
Keep going! 🚀
|
|
660
|
+
```
|
|
661
|
+
|
|
662
|
+
**Value:** Saves hours of setup time, applies best practices from day 1, avoids common mistakes.
|
|
663
|
+
|
|
664
|
+
---
|
|
665
|
+
|
|
666
|
+
### 6. 🧠 Memory Health Dashboard
|
|
667
|
+
|
|
668
|
+
**Command:** `/health`
|
|
669
|
+
|
|
670
|
+
**Purpose:** "Is my ekkOS memory working well? Any issues?"
|
|
671
|
+
|
|
672
|
+
**User Need:** Users want visibility into their memory system health.
|
|
673
|
+
|
|
674
|
+
**Multi-Tool Combination:**
|
|
675
|
+
- `ekkOS_Stats` - Get all statistics
|
|
676
|
+
- `ekkOS_Summary` - Recent activity
|
|
677
|
+
- `ekkOS_Search` - Test search functionality
|
|
678
|
+
- `ekkOS_Reflect` - Analyze memory quality
|
|
679
|
+
|
|
680
|
+
**Example Usage:**
|
|
681
|
+
```bash
|
|
682
|
+
# Full health check
|
|
683
|
+
/health
|
|
684
|
+
|
|
685
|
+
# Quick status
|
|
686
|
+
/health --quick
|
|
687
|
+
|
|
688
|
+
# Detailed diagnostics
|
|
689
|
+
/health --detailed
|
|
690
|
+
```
|
|
691
|
+
|
|
692
|
+
**Example Output:**
|
|
693
|
+
```
|
|
694
|
+
🧠 ekkOS Memory Health Dashboard
|
|
695
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
696
|
+
|
|
697
|
+
Overall Health: 87/100 (Excellent) ✅
|
|
698
|
+
|
|
699
|
+
───────────────────────────────────────────────────────────────────
|
|
700
|
+
📊 11-Layer Memory Status
|
|
701
|
+
|
|
702
|
+
Layer 1 (Working): ✅ Active (current session)
|
|
703
|
+
Layer 2 (Episodic): ✅ 234 conversations stored
|
|
704
|
+
Layer 3 (Semantic): ✅ 1,456 semantic links
|
|
705
|
+
Layer 4 (Patterns): ✅ 42 patterns (84% avg success)
|
|
706
|
+
Layer 5 (Procedural): ⚠️ 3 workflows (consider adding more)
|
|
707
|
+
Layer 6 (Collective): ✅ 8 patterns promoted
|
|
708
|
+
Layer 7 (Meta): ✅ Tracking effectiveness
|
|
709
|
+
Layer 8 (Codebase): ✅ 5 projects indexed
|
|
710
|
+
Layer 9 (Directives): ✅ 12 rules (MUST/NEVER/PREFER)
|
|
711
|
+
Layer 10 (Conflict): ✅ Auto-resolving contradictions
|
|
712
|
+
Layer 11 (Secrets): ✅ 5 secrets stored securely
|
|
713
|
+
|
|
714
|
+
───────────────────────────────────────────────────────────────────
|
|
715
|
+
🔄 Golden Loop Performance
|
|
716
|
+
|
|
717
|
+
RETRIEVE: 95% (Excellent) ✅
|
|
718
|
+
• Patterns retrieved when relevant
|
|
719
|
+
• Fast response time (110ms avg)
|
|
720
|
+
• High relevance score
|
|
721
|
+
|
|
722
|
+
APPLY: 84% (Good) ✅
|
|
723
|
+
• Patterns actually used 84% of the time
|
|
724
|
+
• User engagement is strong
|
|
725
|
+
|
|
726
|
+
MEASURE: 72% (Good) ⚠️
|
|
727
|
+
• Outcomes tracked for 72% of applications
|
|
728
|
+
• Could be better (aim for 80%+)
|
|
729
|
+
|
|
730
|
+
LEARN: 48% (Moderate) ⚠️
|
|
731
|
+
• 48% of solutions forged as patterns
|
|
732
|
+
• Aim for 60%+ capture rate
|
|
733
|
+
|
|
734
|
+
Overall Loop Efficiency: 75% (Good, room for improvement)
|
|
735
|
+
|
|
736
|
+
───────────────────────────────────────────────────────────────────
|
|
737
|
+
📈 Growth Trends (Last 30 Days)
|
|
738
|
+
|
|
739
|
+
Patterns: 34 → 42 (+8) 📈
|
|
740
|
+
Episodes: 187 → 234 (+47) 📈
|
|
741
|
+
Pattern applications: 823 → 1,041 (+218) 📈
|
|
742
|
+
Success rate: 82% → 84% (+2%) 📈
|
|
743
|
+
|
|
744
|
+
You're learning and growing! 🌱
|
|
745
|
+
|
|
746
|
+
───────────────────────────────────────────────────────────────────
|
|
747
|
+
⚠️ Areas for Improvement
|
|
748
|
+
|
|
749
|
+
1. LEARN Phase (48%)
|
|
750
|
+
Issue: Not forging enough patterns
|
|
751
|
+
Impact: Repeated problem-solving
|
|
752
|
+
Fix: Use /forge after solving problems
|
|
753
|
+
Target: 60% capture rate
|
|
754
|
+
|
|
755
|
+
2. MEASURE Phase (72%)
|
|
756
|
+
Issue: Some outcomes not tracked
|
|
757
|
+
Impact: Pattern success rates incomplete
|
|
758
|
+
Fix: Hooks configured correctly? Check /loop-status
|
|
759
|
+
|
|
760
|
+
3. Procedural Patterns (3 total)
|
|
761
|
+
Issue: Few multi-step workflows captured
|
|
762
|
+
Impact: Missing reusable processes
|
|
763
|
+
Fix: Use /forge for complex workflows
|
|
764
|
+
Target: 10+ procedural patterns
|
|
765
|
+
|
|
766
|
+
───────────────────────────────────────────────────────────────────
|
|
767
|
+
✅ What's Working Well
|
|
768
|
+
|
|
769
|
+
• Pattern quality is high (84% success avg)
|
|
770
|
+
• Search is fast and accurate
|
|
771
|
+
• Good engagement (you use retrieved patterns)
|
|
772
|
+
• Steady growth in all metrics
|
|
773
|
+
• No conflicts or errors detected
|
|
774
|
+
|
|
775
|
+
───────────────────────────────────────────────────────────────────
|
|
776
|
+
🎯 Recommendations
|
|
777
|
+
|
|
778
|
+
1. 🎉 Great job maintaining high pattern quality!
|
|
779
|
+
2. ⚒️ Try forging more often (especially procedural workflows)
|
|
780
|
+
3. 📊 Check outcome tracking: /loop-status --test-measure
|
|
781
|
+
4. 🌟 Consider promoting patterns to collective (help others!)
|
|
782
|
+
|
|
783
|
+
───────────────────────────────────────────────────────────────────
|
|
784
|
+
📊 Comparison to Average User
|
|
785
|
+
|
|
786
|
+
Your memory health: 87/100
|
|
787
|
+
Average user: 71/100
|
|
788
|
+
|
|
789
|
+
You're in the top 15% of ekkOS users! 🏆
|
|
790
|
+
|
|
791
|
+
Keep it up and you'll be in top 10% soon.
|
|
792
|
+
```
|
|
793
|
+
|
|
794
|
+
**Value:** Visibility into memory health, actionable improvement suggestions, motivation to keep learning.
|
|
795
|
+
|
|
796
|
+
---
|
|
797
|
+
|
|
798
|
+
### 7. 📦 Knowledge Backup Manager
|
|
799
|
+
|
|
800
|
+
**Command:** `/backup`
|
|
801
|
+
|
|
802
|
+
**Purpose:** "Backup my patterns, share with team, sync across devices."
|
|
803
|
+
|
|
804
|
+
**User Need:** Users want to backup their memory and share knowledge.
|
|
805
|
+
|
|
806
|
+
**Multi-Tool Combination:**
|
|
807
|
+
- `ekkOS_Export` - Export all memory data
|
|
808
|
+
- `ekkOS_Import` - Import from backup
|
|
809
|
+
- `ekkOS_Stats` - Show what's being backed up
|
|
810
|
+
- `ekkOS_Summary` - Summary of exported data
|
|
811
|
+
|
|
812
|
+
**Example Usage:**
|
|
813
|
+
```bash
|
|
814
|
+
# Export everything
|
|
815
|
+
/backup export
|
|
816
|
+
|
|
817
|
+
# Export only patterns
|
|
818
|
+
/backup export --patterns-only
|
|
819
|
+
|
|
820
|
+
# Import from backup
|
|
821
|
+
/backup import ~/ekkos-backup.json
|
|
822
|
+
|
|
823
|
+
# Sync to team
|
|
824
|
+
/backup share --team
|
|
825
|
+
```
|
|
826
|
+
|
|
827
|
+
**Example Output:**
|
|
828
|
+
```
|
|
829
|
+
📦 Knowledge Backup Manager
|
|
830
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
831
|
+
|
|
832
|
+
Creating backup of your ekkOS memory...
|
|
833
|
+
|
|
834
|
+
───────────────────────────────────────────────────────────────────
|
|
835
|
+
📊 Backup Contents
|
|
836
|
+
|
|
837
|
+
✅ Patterns (Layer 4): 42 patterns
|
|
838
|
+
✅ Procedural (Layer 5): 3 workflows
|
|
839
|
+
✅ Directives (Layer 9): 12 rules
|
|
840
|
+
✅ Plans: 5 active plans
|
|
841
|
+
✅ Secrets (encrypted): 5 credentials
|
|
842
|
+
✅ Codebase schemas: 5 projects
|
|
843
|
+
|
|
844
|
+
Total: 67 memory items
|
|
845
|
+
|
|
846
|
+
───────────────────────────────────────────────────────────────────
|
|
847
|
+
💾 Exporting...
|
|
848
|
+
|
|
849
|
+
[████████████████████████████████] 100%
|
|
850
|
+
|
|
851
|
+
✅ Export Complete!
|
|
852
|
+
|
|
853
|
+
File: ~/Downloads/ekkos-backup-2026-01-07.json
|
|
854
|
+
Size: 2.3 MB
|
|
855
|
+
Format: JSON (portable)
|
|
856
|
+
|
|
857
|
+
───────────────────────────────────────────────────────────────────
|
|
858
|
+
🔒 Security
|
|
859
|
+
|
|
860
|
+
Secrets are encrypted with AES-256-GCM.
|
|
861
|
+
Safe to store in cloud storage or share with team.
|
|
862
|
+
|
|
863
|
+
───────────────────────────────────────────────────────────────────
|
|
864
|
+
📤 Sharing Options
|
|
865
|
+
|
|
866
|
+
1. Team Share (Share with your team)
|
|
867
|
+
→ Exports patterns + directives (no secrets)
|
|
868
|
+
→ Team members can import to learn from your knowledge
|
|
869
|
+
→ Use: /backup share --team
|
|
870
|
+
|
|
871
|
+
2. Device Sync (Sync to another device)
|
|
872
|
+
→ Full export including secrets
|
|
873
|
+
→ Import on new machine: /backup import <file>
|
|
874
|
+
→ All memory preserved
|
|
875
|
+
|
|
876
|
+
3. Cloud Backup (Auto-backup to cloud)
|
|
877
|
+
→ Automatic daily backups
|
|
878
|
+
→ Restore from any date
|
|
879
|
+
→ Requires Pro tier
|
|
880
|
+
|
|
881
|
+
───────────────────────────────────────────────────────────────────
|
|
882
|
+
💡 Next Steps
|
|
883
|
+
|
|
884
|
+
Your backup is ready!
|
|
885
|
+
|
|
886
|
+
• Store safely: Move to cloud storage or backup drive
|
|
887
|
+
• Sync devices: Transfer file and run /backup import on new device
|
|
888
|
+
• Share with team: /backup share --team
|
|
889
|
+
• Schedule backups: /backup auto --daily (Pro tier)
|
|
890
|
+
```
|
|
891
|
+
|
|
892
|
+
**Value:** Peace of mind, knowledge sharing, easy migration across devices.
|
|
893
|
+
|
|
894
|
+
---
|
|
895
|
+
|
|
896
|
+
### 8. 🔮 Smart Context Builder
|
|
897
|
+
|
|
898
|
+
**Command:** `/context`
|
|
899
|
+
|
|
900
|
+
**Purpose:** "Give me everything I need to know about this task."
|
|
901
|
+
|
|
902
|
+
**User Need:** Developers want deep context assembled automatically.
|
|
903
|
+
|
|
904
|
+
**Multi-Tool Combination:**
|
|
905
|
+
- `ekkOS_Context` - Get task-specific context
|
|
906
|
+
- `ekkOS_Codebase` - Search project code
|
|
907
|
+
- `ekkOS_Search` - Find relevant patterns
|
|
908
|
+
- `ekkOS_Recall` - Past related discussions
|
|
909
|
+
- `ekkOS_GetSchema` - Schema information
|
|
910
|
+
|
|
911
|
+
**Example Usage:**
|
|
912
|
+
```bash
|
|
913
|
+
# Build context for task
|
|
914
|
+
/context "implement user profile page"
|
|
915
|
+
|
|
916
|
+
# Context for debugging
|
|
917
|
+
/context "fix authentication bug"
|
|
918
|
+
|
|
919
|
+
# Context for refactoring
|
|
920
|
+
/context "refactor API layer"
|
|
921
|
+
```
|
|
922
|
+
|
|
923
|
+
**Example Output:**
|
|
924
|
+
```
|
|
925
|
+
🔮 Smart Context Builder
|
|
926
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
927
|
+
|
|
928
|
+
Task: "Implement user profile page"
|
|
929
|
+
|
|
930
|
+
Building comprehensive context...
|
|
931
|
+
|
|
932
|
+
───────────────────────────────────────────────────────────────────
|
|
933
|
+
📚 Relevant Patterns (5 found)
|
|
934
|
+
|
|
935
|
+
1. ⭐⭐⭐⭐⭐ "User profile page layout (Next.js)"
|
|
936
|
+
Success: 95%
|
|
937
|
+
When to use: Building profile pages in Next.js apps
|
|
938
|
+
|
|
939
|
+
2. ⭐⭐⭐⭐☆ "Fetch user data with React Query"
|
|
940
|
+
Success: 92%
|
|
941
|
+
When to use: Client-side data fetching in React
|
|
942
|
+
|
|
943
|
+
3. ⭐⭐⭐⭐☆ "Handle profile image uploads"
|
|
944
|
+
Success: 88%
|
|
945
|
+
When to use: File upload functionality
|
|
946
|
+
|
|
947
|
+
[... 2 more patterns ...]
|
|
948
|
+
|
|
949
|
+
───────────────────────────────────────────────────────────────────
|
|
950
|
+
🗂️ Relevant Code (from your project)
|
|
951
|
+
|
|
952
|
+
Found in codebase:
|
|
953
|
+
|
|
954
|
+
1. src/api/users/[id]/route.ts
|
|
955
|
+
Existing user API endpoint
|
|
956
|
+
→ Can reuse for profile data
|
|
957
|
+
|
|
958
|
+
2. src/components/Avatar.tsx
|
|
959
|
+
Avatar component already exists
|
|
960
|
+
→ Use for profile picture
|
|
961
|
+
|
|
962
|
+
3. prisma/schema.prisma
|
|
963
|
+
User model definition
|
|
964
|
+
→ Shows available fields
|
|
965
|
+
|
|
966
|
+
───────────────────────────────────────────────────────────────────
|
|
967
|
+
🗄️ Database Schema: users
|
|
968
|
+
|
|
969
|
+
Available fields:
|
|
970
|
+
• id (String, required)
|
|
971
|
+
• email (String, required, unique)
|
|
972
|
+
• userName (String, required)
|
|
973
|
+
• firstName (String, nullable)
|
|
974
|
+
• lastName (String, nullable)
|
|
975
|
+
• bio (String, nullable)
|
|
976
|
+
• profileImageUrl (String, nullable)
|
|
977
|
+
• createdAt (DateTime)
|
|
978
|
+
• updatedAt (DateTime)
|
|
979
|
+
|
|
980
|
+
───────────────────────────────────────────────────────────────────
|
|
981
|
+
💬 Past Discussions
|
|
982
|
+
|
|
983
|
+
3 related conversations found:
|
|
984
|
+
|
|
985
|
+
1. Jan 3, 2026 - "Added user profile API endpoint"
|
|
986
|
+
→ You already built the backend API!
|
|
987
|
+
→ Located at: /api/users/[id]/profile
|
|
988
|
+
|
|
989
|
+
2. Dec 28, 2025 - "Profile image upload flow"
|
|
990
|
+
→ Discussed using S3 signed URLs
|
|
991
|
+
→ Implementation pattern exists
|
|
992
|
+
|
|
993
|
+
3. Dec 15, 2025 - "User data fetching strategy"
|
|
994
|
+
→ Decided on React Query for client-side
|
|
995
|
+
→ Pattern forged: "Use React Query for user data"
|
|
996
|
+
|
|
997
|
+
───────────────────────────────────────────────────────────────────
|
|
998
|
+
📜 User Directives (2 apply)
|
|
999
|
+
|
|
1000
|
+
1. MUST: "Always add loading states to data fetching"
|
|
1001
|
+
→ Remember to show skeleton while loading
|
|
1002
|
+
|
|
1003
|
+
2. PREFER: "Use Tailwind for styling, not CSS-in-JS"
|
|
1004
|
+
→ Style with Tailwind classes
|
|
1005
|
+
|
|
1006
|
+
───────────────────────────────────────────────────────────────────
|
|
1007
|
+
🎯 Implementation Plan
|
|
1008
|
+
|
|
1009
|
+
Based on patterns + existing code:
|
|
1010
|
+
|
|
1011
|
+
1. Create profile page component
|
|
1012
|
+
File: src/app/profile/[id]/page.tsx
|
|
1013
|
+
Pattern: "User profile page layout (Next.js)"
|
|
1014
|
+
|
|
1015
|
+
2. Fetch user data with React Query
|
|
1016
|
+
Pattern: "Fetch user data with React Query"
|
|
1017
|
+
Reuse: Existing API at /api/users/[id]/profile
|
|
1018
|
+
|
|
1019
|
+
3. Display profile information
|
|
1020
|
+
Components: <Avatar>, <UserInfo>, <UserBio>
|
|
1021
|
+
Reuse: src/components/Avatar.tsx
|
|
1022
|
+
|
|
1023
|
+
4. Add edit functionality (if needed)
|
|
1024
|
+
Pattern: "Inline editing for profile fields"
|
|
1025
|
+
|
|
1026
|
+
5. Handle image upload
|
|
1027
|
+
Pattern: "Handle profile image uploads"
|
|
1028
|
+
Use: S3 signed URLs (as discussed Dec 28)
|
|
1029
|
+
|
|
1030
|
+
───────────────────────────────────────────────────────────────────
|
|
1031
|
+
⚠️ Potential Issues
|
|
1032
|
+
|
|
1033
|
+
Anti-patterns to avoid:
|
|
1034
|
+
|
|
1035
|
+
❌ "Don't fetch user data on every render"
|
|
1036
|
+
→ Use React Query caching
|
|
1037
|
+
|
|
1038
|
+
❌ "Don't allow profile access without auth check"
|
|
1039
|
+
→ Verify user is authenticated first
|
|
1040
|
+
|
|
1041
|
+
───────────────────────────────────────────────────────────────────
|
|
1042
|
+
✅ Ready to Implement!
|
|
1043
|
+
|
|
1044
|
+
You have everything you need:
|
|
1045
|
+
• 5 relevant patterns with high success rates
|
|
1046
|
+
• Existing API endpoint to reuse
|
|
1047
|
+
• Database schema defined
|
|
1048
|
+
• Past decisions documented
|
|
1049
|
+
• User preferences captured
|
|
1050
|
+
|
|
1051
|
+
Estimated time: 2-3 hours (based on pattern data)
|
|
1052
|
+
|
|
1053
|
+
───────────────────────────────────────────────────────────────────
|
|
1054
|
+
🚀 Next Steps
|
|
1055
|
+
|
|
1056
|
+
1. Create page: src/app/profile/[id]/page.tsx
|
|
1057
|
+
2. Apply pattern: "User profile page layout"
|
|
1058
|
+
3. Test with existing API
|
|
1059
|
+
4. Use /forge if you discover improvements!
|
|
1060
|
+
|
|
1061
|
+
Good luck! 🎉
|
|
1062
|
+
```
|
|
1063
|
+
|
|
1064
|
+
**Value:** Saves hours of context gathering, applies relevant patterns automatically.
|
|
1065
|
+
|
|
1066
|
+
---
|
|
1067
|
+
|
|
1068
|
+
### 9. ❌ Anti-Pattern Tracker
|
|
1069
|
+
|
|
1070
|
+
**Command:** `/anti-patterns`
|
|
1071
|
+
|
|
1072
|
+
**Purpose:** "What should I NOT do? What mistakes have I made before?"
|
|
1073
|
+
|
|
1074
|
+
**User Need:** Learning from failures is as important as successes.
|
|
1075
|
+
|
|
1076
|
+
**Multi-Tool Combination:**
|
|
1077
|
+
- `ekkOS_Search` - Find anti-patterns
|
|
1078
|
+
- `ekkOS_Forge` - Create anti-patterns from failures
|
|
1079
|
+
- `ekkOS_Outcome` - Track pattern failures
|
|
1080
|
+
- `ekkOS_Directive` - Create NEVER rules
|
|
1081
|
+
|
|
1082
|
+
**Example Usage:**
|
|
1083
|
+
```bash
|
|
1084
|
+
# Show all anti-patterns
|
|
1085
|
+
/anti-patterns
|
|
1086
|
+
|
|
1087
|
+
# For specific category
|
|
1088
|
+
/anti-patterns --category typescript
|
|
1089
|
+
|
|
1090
|
+
# Create anti-pattern from failure
|
|
1091
|
+
/anti-patterns create "Using var in TypeScript breaks type narrowing"
|
|
1092
|
+
```
|
|
1093
|
+
|
|
1094
|
+
**Example Output:**
|
|
1095
|
+
```
|
|
1096
|
+
❌ Anti-Pattern Tracker
|
|
1097
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
1098
|
+
|
|
1099
|
+
Your Failure Knowledge: 7 anti-patterns
|
|
1100
|
+
|
|
1101
|
+
These are things you've learned NOT to do.
|
|
1102
|
+
|
|
1103
|
+
───────────────────────────────────────────────────────────────────
|
|
1104
|
+
🔴 TypeScript Anti-Patterns (3)
|
|
1105
|
+
|
|
1106
|
+
1. ❌ "Using 'var' keyword in TypeScript"
|
|
1107
|
+
Why it fails: Breaks type narrowing, unexpected hoisting
|
|
1108
|
+
Last encountered: 2 weeks ago
|
|
1109
|
+
Times prevented: 5
|
|
1110
|
+
|
|
1111
|
+
Correct approach:
|
|
1112
|
+
✅ Use const for immutable values
|
|
1113
|
+
✅ Use let for mutable values
|
|
1114
|
+
❌ Never use var
|
|
1115
|
+
|
|
1116
|
+
2. ❌ "Using 'any' type to bypass errors"
|
|
1117
|
+
Why it fails: Defeats purpose of TypeScript, runtime errors
|
|
1118
|
+
Last encountered: 1 week ago
|
|
1119
|
+
Times prevented: 12
|
|
1120
|
+
|
|
1121
|
+
Correct approach:
|
|
1122
|
+
✅ Use unknown and type guards
|
|
1123
|
+
✅ Use proper type definitions
|
|
1124
|
+
✅ Use generics for flexible typing
|
|
1125
|
+
❌ Don't use any
|
|
1126
|
+
|
|
1127
|
+
3. ❌ "Not checking for null/undefined"
|
|
1128
|
+
Why it fails: "Cannot read property 'X' of undefined"
|
|
1129
|
+
Last encountered: 3 days ago
|
|
1130
|
+
Times prevented: 23 (most common!)
|
|
1131
|
+
|
|
1132
|
+
Correct approach:
|
|
1133
|
+
✅ Use optional chaining: obj?.prop
|
|
1134
|
+
✅ Use nullish coalescing: value ?? default
|
|
1135
|
+
✅ Check before accessing: if (obj) { obj.prop }
|
|
1136
|
+
|
|
1137
|
+
───────────────────────────────────────────────────────────────────
|
|
1138
|
+
🔴 API & Backend Anti-Patterns (2)
|
|
1139
|
+
|
|
1140
|
+
1. ❌ "No timeout on API requests"
|
|
1141
|
+
Why it fails: Requests hang forever, bad UX
|
|
1142
|
+
Last encountered: 1 month ago
|
|
1143
|
+
Times prevented: 7
|
|
1144
|
+
|
|
1145
|
+
Correct approach:
|
|
1146
|
+
✅ Always set timeout (5-30 seconds)
|
|
1147
|
+
✅ Show loading state with timeout warning
|
|
1148
|
+
✅ Retry with exponential backoff
|
|
1149
|
+
|
|
1150
|
+
2. ❌ "Hardcoding API keys in code"
|
|
1151
|
+
Why it fails: Security risk, keys leaked to git
|
|
1152
|
+
Last encountered: 2 months ago (close call!)
|
|
1153
|
+
Times prevented: 3
|
|
1154
|
+
|
|
1155
|
+
Correct approach:
|
|
1156
|
+
✅ Use environment variables
|
|
1157
|
+
✅ Use ekkOS Secret Vault: /secrets store
|
|
1158
|
+
✅ Add .env to .gitignore
|
|
1159
|
+
❌ NEVER commit keys
|
|
1160
|
+
|
|
1161
|
+
───────────────────────────────────────────────────────────────────
|
|
1162
|
+
🔴 Database Anti-Patterns (2)
|
|
1163
|
+
|
|
1164
|
+
1. ❌ "Running migrations on production without backup"
|
|
1165
|
+
Why it fails: Data loss if migration fails
|
|
1166
|
+
Last encountered: 3 months ago (disaster!)
|
|
1167
|
+
Times prevented: 8 (phew!)
|
|
1168
|
+
|
|
1169
|
+
Correct approach:
|
|
1170
|
+
✅ Always backup before migration
|
|
1171
|
+
✅ Test migration on staging first
|
|
1172
|
+
✅ Have rollback plan ready
|
|
1173
|
+
❌ Don't YOLO production migrations
|
|
1174
|
+
|
|
1175
|
+
2. ❌ "N+1 query in loop"
|
|
1176
|
+
Why it fails: 1000 rows = 1000 queries = slow
|
|
1177
|
+
Last encountered: 2 weeks ago
|
|
1178
|
+
Times prevented: 4
|
|
1179
|
+
|
|
1180
|
+
Correct approach:
|
|
1181
|
+
✅ Use include/join to fetch relations
|
|
1182
|
+
✅ Batch queries with Promise.all
|
|
1183
|
+
✅ Use DataLoader for GraphQL
|
|
1184
|
+
❌ Don't query inside loop
|
|
1185
|
+
|
|
1186
|
+
───────────────────────────────────────────────────────────────────
|
|
1187
|
+
📊 Prevention Stats
|
|
1188
|
+
|
|
1189
|
+
Anti-patterns have prevented mistakes 62 times!
|
|
1190
|
+
|
|
1191
|
+
Most prevented: "Not checking null/undefined" (23 times)
|
|
1192
|
+
Most dangerous: "No backup before migration" (1 disaster averted)
|
|
1193
|
+
|
|
1194
|
+
Time saved by not repeating mistakes: ~18 hours
|
|
1195
|
+
|
|
1196
|
+
───────────────────────────────────────────────────────────────────
|
|
1197
|
+
💡 Keep Learning from Failures
|
|
1198
|
+
|
|
1199
|
+
When something DOESN'T work:
|
|
1200
|
+
|
|
1201
|
+
1. Run: /anti-patterns create "<what failed>"
|
|
1202
|
+
2. Explain WHY it failed
|
|
1203
|
+
3. Document correct approach
|
|
1204
|
+
4. Next time → ekkOS warns you!
|
|
1205
|
+
|
|
1206
|
+
Failures are valuable. Capture them! 📝
|
|
1207
|
+
```
|
|
1208
|
+
|
|
1209
|
+
**Value:** Prevents repeating mistakes, builds "what NOT to do" knowledge base.
|
|
1210
|
+
|
|
1211
|
+
---
|
|
1212
|
+
|
|
1213
|
+
### 10. 🚨 Deployment Safety Net
|
|
1214
|
+
|
|
1215
|
+
**Command:** `/deploy-check`
|
|
1216
|
+
|
|
1217
|
+
**Purpose:** "Is it safe to deploy? Did I forget anything?"
|
|
1218
|
+
|
|
1219
|
+
**User Need:** Pre-deployment checklist based on past incidents.
|
|
1220
|
+
|
|
1221
|
+
**Multi-Tool Combination:**
|
|
1222
|
+
- `ekkOS_Conflict` - Check for conflicts
|
|
1223
|
+
- `ekkOS_Search` - Past deployment incidents
|
|
1224
|
+
- `ekkOS_Recall` - Recent changes
|
|
1225
|
+
- `ekkOS_Directive` - Deployment rules
|
|
1226
|
+
- `ekkOS_Plan` - Deployment checklist
|
|
1227
|
+
|
|
1228
|
+
**Example Usage:**
|
|
1229
|
+
```bash
|
|
1230
|
+
# Check before deploy
|
|
1231
|
+
/deploy-check
|
|
1232
|
+
|
|
1233
|
+
# Check specific environment
|
|
1234
|
+
/deploy-check --env production
|
|
1235
|
+
|
|
1236
|
+
# Override if emergency
|
|
1237
|
+
/deploy-check --override "Critical security fix"
|
|
1238
|
+
```
|
|
1239
|
+
|
|
1240
|
+
**Example Output:**
|
|
1241
|
+
```
|
|
1242
|
+
🚨 Deployment Safety Check
|
|
1243
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
1244
|
+
|
|
1245
|
+
Environment: Production
|
|
1246
|
+
Time: Friday, Jan 7, 2026, 4:45 PM
|
|
1247
|
+
|
|
1248
|
+
Running comprehensive pre-flight checks...
|
|
1249
|
+
|
|
1250
|
+
───────────────────────────────────────────────────────────────────
|
|
1251
|
+
⚠️ STOP! Issues Detected
|
|
1252
|
+
|
|
1253
|
+
🚨 4 blockers found
|
|
1254
|
+
|
|
1255
|
+
───────────────────────────────────────────────────────────────────
|
|
1256
|
+
🚫 Blocker #1: Dangerous Deploy Time
|
|
1257
|
+
|
|
1258
|
+
Rule: "Never deploy to production on Friday after 3 PM"
|
|
1259
|
+
Created: 3 months ago
|
|
1260
|
+
Reason: Weekend incidents with no one available
|
|
1261
|
+
|
|
1262
|
+
Current: Friday, 4:45 PM ← VIOLATION!
|
|
1263
|
+
|
|
1264
|
+
Past incident: Dec 15, 2025
|
|
1265
|
+
• Deployed at 4:30 PM Friday
|
|
1266
|
+
• Auth broke over weekend
|
|
1267
|
+
• 2 days of downtime
|
|
1268
|
+
• 1,000+ users affected
|
|
1269
|
+
|
|
1270
|
+
Recommendation: Wait until Monday
|
|
1271
|
+
|
|
1272
|
+
───────────────────────────────────────────────────────────────────
|
|
1273
|
+
🚫 Blocker #2: Tests Not Passing
|
|
1274
|
+
|
|
1275
|
+
Directive: MUST run tests before production deploy
|
|
1276
|
+
|
|
1277
|
+
Test status: ❌ 3 failing tests
|
|
1278
|
+
|
|
1279
|
+
Failing:
|
|
1280
|
+
• test/api/users.test.ts - "GET /api/users returns 200"
|
|
1281
|
+
• test/auth/login.test.ts - "Login with valid credentials"
|
|
1282
|
+
• test/db/connection.test.ts - "Database connection pool"
|
|
1283
|
+
|
|
1284
|
+
These are CRITICAL tests. Don't deploy with failing tests!
|
|
1285
|
+
|
|
1286
|
+
Fix: Run npm test and fix failures
|
|
1287
|
+
|
|
1288
|
+
───────────────────────────────────────────────────────────────────
|
|
1289
|
+
🚫 Blocker #3: No Code Review
|
|
1290
|
+
|
|
1291
|
+
Directive: MUST have code review before production
|
|
1292
|
+
|
|
1293
|
+
PR Status: No reviews yet
|
|
1294
|
+
|
|
1295
|
+
Changes since last deploy:
|
|
1296
|
+
• 47 files changed
|
|
1297
|
+
• +2,345 lines added
|
|
1298
|
+
• -892 lines removed
|
|
1299
|
+
• Includes auth system changes (high risk!)
|
|
1300
|
+
|
|
1301
|
+
This is a large change set. Get review first!
|
|
1302
|
+
|
|
1303
|
+
───────────────────────────────────────────────────────────────────
|
|
1304
|
+
🚫 Blocker #4: Environment Variables Changed
|
|
1305
|
+
|
|
1306
|
+
Detection: .env.production.local modified
|
|
1307
|
+
|
|
1308
|
+
Changed variables:
|
|
1309
|
+
• DATABASE_URL (modified 2 hours ago)
|
|
1310
|
+
• JWT_SECRET (modified 2 hours ago)
|
|
1311
|
+
• API_KEY (modified 2 hours ago)
|
|
1312
|
+
|
|
1313
|
+
⚠️ High risk! Database and auth config changed.
|
|
1314
|
+
|
|
1315
|
+
Recommendation:
|
|
1316
|
+
1. Double-check these values are correct
|
|
1317
|
+
2. Test on staging first
|
|
1318
|
+
3. Have rollback plan ready
|
|
1319
|
+
|
|
1320
|
+
───────────────────────────────────────────────────────────────────
|
|
1321
|
+
📋 Pre-Deployment Checklist
|
|
1322
|
+
|
|
1323
|
+
Required before proceeding:
|
|
1324
|
+
|
|
1325
|
+
[ ] ❌ Wait until Monday (or justify override)
|
|
1326
|
+
[ ] ❌ Fix 3 failing tests
|
|
1327
|
+
[ ] ❌ Get code review approval
|
|
1328
|
+
[ ] ❌ Verify environment variables are correct
|
|
1329
|
+
[ ] ❌ Test on staging environment
|
|
1330
|
+
[ ] ❌ Prepare rollback plan
|
|
1331
|
+
[ ] ❌ Notify team of upcoming deploy
|
|
1332
|
+
[ ] ❌ Database backup created
|
|
1333
|
+
|
|
1334
|
+
0/8 checks passed ← NOT READY!
|
|
1335
|
+
|
|
1336
|
+
───────────────────────────────────────────────────────────────────
|
|
1337
|
+
🔍 Past Incidents (3 found)
|
|
1338
|
+
|
|
1339
|
+
This safety check exists because of these past incidents:
|
|
1340
|
+
|
|
1341
|
+
1. Dec 15, 2025 - "Friday deploy broke auth"
|
|
1342
|
+
→ Created rule: No Friday evening deploys
|
|
1343
|
+
|
|
1344
|
+
2. Nov 3, 2025 - "Deployed with failing tests, broke payment processing"
|
|
1345
|
+
→ Created rule: Tests must pass
|
|
1346
|
+
|
|
1347
|
+
3. Oct 12, 2025 - "No code review, missed critical bug"
|
|
1348
|
+
→ Created rule: Code review required
|
|
1349
|
+
|
|
1350
|
+
Don't repeat history! 📚
|
|
1351
|
+
|
|
1352
|
+
───────────────────────────────────────────────────────────────────
|
|
1353
|
+
🚨 RECOMMENDATION: DO NOT DEPLOY
|
|
1354
|
+
|
|
1355
|
+
Risk Level: HIGH
|
|
1356
|
+
|
|
1357
|
+
This deploy has:
|
|
1358
|
+
• Bad timing (Friday evening)
|
|
1359
|
+
• Failing tests (3 critical)
|
|
1360
|
+
• No code review
|
|
1361
|
+
• Env var changes (risky)
|
|
1362
|
+
|
|
1363
|
+
If you deploy anyway:
|
|
1364
|
+
• High chance of incident
|
|
1365
|
+
• No one available for weekend fixes
|
|
1366
|
+
• Could affect 1,000+ users
|
|
1367
|
+
• Will violate your own safety rules
|
|
1368
|
+
|
|
1369
|
+
───────────────────────────────────────────────────────────────────
|
|
1370
|
+
✅ Safe Alternative
|
|
1371
|
+
|
|
1372
|
+
Wait until Monday, then:
|
|
1373
|
+
|
|
1374
|
+
1. Monday morning: Fix failing tests
|
|
1375
|
+
2. Monday afternoon: Get code review
|
|
1376
|
+
3. Monday 2 PM: Verify env vars on staging
|
|
1377
|
+
4. Monday 3 PM: Deploy to production
|
|
1378
|
+
5. Monitor for 2 hours
|
|
1379
|
+
6. Team available if issues occur
|
|
1380
|
+
|
|
1381
|
+
This is the SAFE approach. ✅
|
|
1382
|
+
|
|
1383
|
+
───────────────────────────────────────────────────────────────────
|
|
1384
|
+
🆘 Emergency Override?
|
|
1385
|
+
|
|
1386
|
+
If this is truly a critical emergency (security patch, site down, etc.):
|
|
1387
|
+
|
|
1388
|
+
/deploy-check --override "Reason: Critical security fix CVE-2026-1234"
|
|
1389
|
+
|
|
1390
|
+
This will:
|
|
1391
|
+
• Document why you're overriding safety checks
|
|
1392
|
+
• Alert team of emergency deploy
|
|
1393
|
+
• Require manual confirmation
|
|
1394
|
+
• Create incident report for later review
|
|
1395
|
+
|
|
1396
|
+
Only use for REAL emergencies!
|
|
1397
|
+
|
|
1398
|
+
───────────────────────────────────────────────────────────────────
|
|
1399
|
+
📞 Need Help?
|
|
1400
|
+
|
|
1401
|
+
Talk to team before proceeding:
|
|
1402
|
+
• #deployments channel
|
|
1403
|
+
• @oncall-engineer
|
|
1404
|
+
• support@yourcompany.com
|
|
1405
|
+
|
|
1406
|
+
Don't deploy alone if unsure! 🤝
|
|
1407
|
+
```
|
|
1408
|
+
|
|
1409
|
+
**Value:** Prevents production incidents, enforces safety rules, learns from past mistakes.
|
|
1410
|
+
|
|
1411
|
+
---
|
|
1412
|
+
|
|
1413
|
+
### 11. 📋 Plan Manager
|
|
1414
|
+
|
|
1415
|
+
**Command:** `/plans`
|
|
1416
|
+
|
|
1417
|
+
**Purpose:** "What am I working on? How do I track multi-step tasks?"
|
|
1418
|
+
|
|
1419
|
+
**User Need:** Users need to create, manage, and track complex multi-step plans attached to their user ID.
|
|
1420
|
+
|
|
1421
|
+
**Multi-Tool Combination:**
|
|
1422
|
+
- `ekkOS_Plan` - Create new structured plans
|
|
1423
|
+
- `ekkOS_Plans` - List user's plans
|
|
1424
|
+
- `ekkOS_PlanStatus` - Update plan status (draft/in_progress/completed/archived)
|
|
1425
|
+
- `ekkOS_PlanStep` - Mark individual steps complete
|
|
1426
|
+
- `ekkOS_Generate` - AI-generate plan from description
|
|
1427
|
+
- `ekkOS_SaveTemplate` - Save successful plans as reusable templates
|
|
1428
|
+
- `ekkOS_Templates` - Browse available plan templates
|
|
1429
|
+
- `ekkOS_FromTemplate` - Create new plan from template
|
|
1430
|
+
|
|
1431
|
+
**Example Usage:**
|
|
1432
|
+
```bash
|
|
1433
|
+
# List all your plans
|
|
1434
|
+
/plans
|
|
1435
|
+
|
|
1436
|
+
# Create new plan
|
|
1437
|
+
/plans create "Implement user authentication"
|
|
1438
|
+
|
|
1439
|
+
# AI-generate plan from description
|
|
1440
|
+
/plans generate "Build REST API for blog"
|
|
1441
|
+
|
|
1442
|
+
# Show specific plan
|
|
1443
|
+
/plans show plan_abc123
|
|
1444
|
+
|
|
1445
|
+
# Mark step complete
|
|
1446
|
+
/plans complete plan_abc123 --step 3
|
|
1447
|
+
|
|
1448
|
+
# Save as template
|
|
1449
|
+
/plans template plan_abc123 --category "authentication"
|
|
1450
|
+
|
|
1451
|
+
# Create from template
|
|
1452
|
+
/plans from-template "authentication-setup"
|
|
1453
|
+
```
|
|
1454
|
+
|
|
1455
|
+
**Example Output:**
|
|
1456
|
+
```
|
|
1457
|
+
📋 Your Plans
|
|
1458
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
1459
|
+
|
|
1460
|
+
Active Plans (2):
|
|
1461
|
+
|
|
1462
|
+
1. 🔄 Implement User Authentication
|
|
1463
|
+
Status: In Progress (60% complete)
|
|
1464
|
+
Created: 2 days ago
|
|
1465
|
+
Steps: 3/5 completed
|
|
1466
|
+
|
|
1467
|
+
[✅] 1. Setup Next-Auth
|
|
1468
|
+
[✅] 2. Configure providers
|
|
1469
|
+
[✅] 3. Add login page
|
|
1470
|
+
[ ] 4. Add protected routes
|
|
1471
|
+
[ ] 5. Add session management
|
|
1472
|
+
|
|
1473
|
+
Next: Complete step 4 - Add protected routes
|
|
1474
|
+
|
|
1475
|
+
2. 🔄 Build REST API
|
|
1476
|
+
Status: In Progress (25% complete)
|
|
1477
|
+
Created: 1 week ago
|
|
1478
|
+
Steps: 2/8 completed
|
|
1479
|
+
|
|
1480
|
+
[✅] 1. Setup Express server
|
|
1481
|
+
[✅] 2. Configure database connection
|
|
1482
|
+
[ ] 3. Define API routes
|
|
1483
|
+
[ ] 4. Add validation middleware
|
|
1484
|
+
[...5 more steps...]
|
|
1485
|
+
|
|
1486
|
+
Next: Define API routes
|
|
1487
|
+
|
|
1488
|
+
───────────────────────────────────────────────────────────────────
|
|
1489
|
+
Completed Plans (3):
|
|
1490
|
+
|
|
1491
|
+
✅ Setup Development Environment (3 days ago)
|
|
1492
|
+
✅ Implement Dark Mode (1 week ago)
|
|
1493
|
+
✅ Add Email Verification (2 weeks ago)
|
|
1494
|
+
|
|
1495
|
+
───────────────────────────────────────────────────────────────────
|
|
1496
|
+
Draft Plans (1):
|
|
1497
|
+
|
|
1498
|
+
📝 Refactor Database Layer
|
|
1499
|
+
Created: 3 days ago
|
|
1500
|
+
Status: Draft (not started)
|
|
1501
|
+
Steps: 6 planned
|
|
1502
|
+
|
|
1503
|
+
───────────────────────────────────────────────────────────────────
|
|
1504
|
+
📊 Stats:
|
|
1505
|
+
|
|
1506
|
+
Total Plans: 6
|
|
1507
|
+
├─ Active: 2
|
|
1508
|
+
├─ Completed: 3
|
|
1509
|
+
└─ Draft: 1
|
|
1510
|
+
|
|
1511
|
+
Completion Rate: 50%
|
|
1512
|
+
Average Time to Complete: 5 days
|
|
1513
|
+
|
|
1514
|
+
───────────────────────────────────────────────────────────────────
|
|
1515
|
+
💡 Quick Actions:
|
|
1516
|
+
|
|
1517
|
+
• Create plan: /plans create "title"
|
|
1518
|
+
• Generate plan: /plans generate "description"
|
|
1519
|
+
• Mark step done: /plans complete <plan_id> --step <#>
|
|
1520
|
+
• Save template: /plans template <plan_id>
|
|
1521
|
+
• Use template: /plans from-template "name"
|
|
1522
|
+
|
|
1523
|
+
───────────────────────────────────────────────────────────────────
|
|
1524
|
+
📚 Available Templates (5):
|
|
1525
|
+
|
|
1526
|
+
1. "Authentication Setup" (used 23 times, 95% success)
|
|
1527
|
+
2. "REST API Implementation" (used 18 times, 90% success)
|
|
1528
|
+
3. "Database Migration" (used 12 times, 88% success)
|
|
1529
|
+
4. "CI/CD Pipeline Setup" (used 9 times, 92% success)
|
|
1530
|
+
5. "Testing Strategy" (used 7 times, 85% success)
|
|
1531
|
+
|
|
1532
|
+
Create from template: /plans from-template "authentication-setup"
|
|
1533
|
+
```
|
|
1534
|
+
|
|
1535
|
+
**Example - Creating Plan:**
|
|
1536
|
+
```bash
|
|
1537
|
+
/plans create "Implement search feature"
|
|
1538
|
+
|
|
1539
|
+
🎯 Creating Plan: "Implement search feature"
|
|
1540
|
+
|
|
1541
|
+
Let me generate steps for you...
|
|
1542
|
+
|
|
1543
|
+
Generated Plan (6 steps):
|
|
1544
|
+
|
|
1545
|
+
1. [ ] Define search requirements and scope
|
|
1546
|
+
2. [ ] Design search API endpoint
|
|
1547
|
+
3. [ ] Implement backend search logic
|
|
1548
|
+
4. [ ] Add search UI component
|
|
1549
|
+
5. [ ] Integrate with existing UI
|
|
1550
|
+
6. [ ] Add search analytics
|
|
1551
|
+
|
|
1552
|
+
Looks good? (yes/no/edit)
|
|
1553
|
+
> yes
|
|
1554
|
+
|
|
1555
|
+
✅ Plan created! (plan_abc123)
|
|
1556
|
+
|
|
1557
|
+
Status: Draft
|
|
1558
|
+
To start: /plans start plan_abc123
|
|
1559
|
+
```
|
|
1560
|
+
|
|
1561
|
+
**Example - AI-Generated Plan:**
|
|
1562
|
+
```bash
|
|
1563
|
+
/plans generate "Build a blog with comments and likes"
|
|
1564
|
+
|
|
1565
|
+
🤖 Generating Plan...
|
|
1566
|
+
|
|
1567
|
+
Analyzing your request...
|
|
1568
|
+
Searching for relevant patterns...
|
|
1569
|
+
Building optimal step sequence...
|
|
1570
|
+
|
|
1571
|
+
✅ Plan Generated: "Build blog with comments and likes"
|
|
1572
|
+
|
|
1573
|
+
12 Steps (estimated 2-3 weeks):
|
|
1574
|
+
|
|
1575
|
+
Phase 1: Core Blog (4 steps)
|
|
1576
|
+
1. [ ] Create blog post model & database schema
|
|
1577
|
+
2. [ ] Build blog post CRUD API
|
|
1578
|
+
3. [ ] Add markdown rendering
|
|
1579
|
+
4. [ ] Create blog post UI
|
|
1580
|
+
|
|
1581
|
+
Phase 2: Comments (4 steps)
|
|
1582
|
+
5. [ ] Create comment model & API
|
|
1583
|
+
6. [ ] Add comment threading logic
|
|
1584
|
+
7. [ ] Build comment UI component
|
|
1585
|
+
8. [ ] Add comment moderation
|
|
1586
|
+
|
|
1587
|
+
Phase 3: Engagement (4 steps)
|
|
1588
|
+
9. [ ] Add like/unlike functionality
|
|
1589
|
+
10. [ ] Create like counter UI
|
|
1590
|
+
11. [ ] Add notification system
|
|
1591
|
+
12. [ ] Implement activity feed
|
|
1592
|
+
|
|
1593
|
+
Applied Patterns (3):
|
|
1594
|
+
• "REST API with CRUD operations"
|
|
1595
|
+
• "Markdown rendering with syntax highlighting"
|
|
1596
|
+
• "Comment threading with nested replies"
|
|
1597
|
+
|
|
1598
|
+
Save this plan? (yes/save-as-template/edit/cancel)
|
|
1599
|
+
> yes
|
|
1600
|
+
|
|
1601
|
+
✅ Plan saved! (plan_def456)
|
|
1602
|
+
Ready to start: /plans start plan_def456
|
|
1603
|
+
```
|
|
1604
|
+
|
|
1605
|
+
**Example - Using Template:**
|
|
1606
|
+
```bash
|
|
1607
|
+
/plans from-template "authentication-setup"
|
|
1608
|
+
|
|
1609
|
+
📚 Using Template: "Authentication Setup"
|
|
1610
|
+
|
|
1611
|
+
This template has been used 23 times with 95% success rate.
|
|
1612
|
+
|
|
1613
|
+
Steps from template:
|
|
1614
|
+
1. [ ] Install authentication library
|
|
1615
|
+
2. [ ] Configure auth providers
|
|
1616
|
+
3. [ ] Create login/signup pages
|
|
1617
|
+
4. [ ] Add protected route middleware
|
|
1618
|
+
5. [ ] Implement session management
|
|
1619
|
+
6. [ ] Add password reset flow
|
|
1620
|
+
|
|
1621
|
+
Customize for your project:
|
|
1622
|
+
Auth library: (NextAuth/Auth0/Supabase)
|
|
1623
|
+
> NextAuth
|
|
1624
|
+
|
|
1625
|
+
Providers: (Google/GitHub/Email/All)
|
|
1626
|
+
> Google, Email
|
|
1627
|
+
|
|
1628
|
+
✅ Plan created from template! (plan_ghi789)
|
|
1629
|
+
|
|
1630
|
+
Customized for:
|
|
1631
|
+
• NextAuth with Google + Email
|
|
1632
|
+
• Next.js 14 App Router
|
|
1633
|
+
• Your project structure
|
|
1634
|
+
|
|
1635
|
+
Ready to start: /plans start plan_ghi789
|
|
1636
|
+
```
|
|
1637
|
+
|
|
1638
|
+
**Example - Marking Steps:**
|
|
1639
|
+
```bash
|
|
1640
|
+
/plans complete plan_abc123 --step 1
|
|
1641
|
+
|
|
1642
|
+
✅ Step 1 marked complete!
|
|
1643
|
+
|
|
1644
|
+
Plan: "Implement search feature"
|
|
1645
|
+
Progress: 1/6 steps (17%)
|
|
1646
|
+
|
|
1647
|
+
Completed:
|
|
1648
|
+
[✅] 1. Define search requirements and scope
|
|
1649
|
+
|
|
1650
|
+
Next step:
|
|
1651
|
+
[ ] 2. Design search API endpoint
|
|
1652
|
+
|
|
1653
|
+
Keep going! 🚀
|
|
1654
|
+
```
|
|
1655
|
+
|
|
1656
|
+
**Value:**
|
|
1657
|
+
- Organize complex multi-step work
|
|
1658
|
+
- AI-generated plans from patterns
|
|
1659
|
+
- Reusable templates for common workflows
|
|
1660
|
+
- Track progress across sessions
|
|
1661
|
+
- Learn from successful plan templates
|
|
1662
|
+
- All plans attached to user ID (portable across projects)
|
|
1663
|
+
|
|
1664
|
+
**Why This is Essential:**
|
|
1665
|
+
- **IMPORTANT:** All Plan tools (ekkOS_Plan, ekkOS_Plans, ekkOS_PlanStatus, etc.) are USER-FACING tools attached to user IDs
|
|
1666
|
+
- Users should have direct UI for plan management
|
|
1667
|
+
- Plans persist across sessions and projects
|
|
1668
|
+
- Templates enable knowledge sharing
|
|
1669
|
+
- Combines with Project Onboarding for fresh projects
|
|
1670
|
+
|
|
1671
|
+
---
|
|
1672
|
+
|
|
1673
|
+
## Summary of Proposed Plugins
|
|
1674
|
+
|
|
1675
|
+
| # | Plugin Name | Commands | MCP Tools | Value Proposition |
|
|
1676
|
+
|---|------------|----------|-----------|-------------------|
|
|
1677
|
+
| 6 | Time Travel Debugger | `/time-travel` | Recall, Search, Codebase, Summary | Debug "when did X break?" |
|
|
1678
|
+
| 7 | Secret Vault | `/secrets` | StoreSecret, GetSecret, ListSecrets, RotateSecret, DeleteSecret | Secure credential management |
|
|
1679
|
+
| 8 | Pre-Flight Checker | `/check` | Conflict, Search, Directive, Recall | Prevent destructive actions |
|
|
1680
|
+
| 9 | Pattern Quality Coach | `/improve-patterns` | Search, Stats, Outcome, Reflect, Forge | Improve pattern library quality |
|
|
1681
|
+
| 10 | Project Onboarding | `/onboard` | Plan, Generate, Templates, Search, Forge | Fresh project setup wizard |
|
|
1682
|
+
| 11 | Memory Health Dashboard | `/health` | Stats, Summary, Search, Reflect | Memory system health check |
|
|
1683
|
+
| 12 | Knowledge Backup Manager | `/backup` | Export, Import, Stats, Summary | Backup and share knowledge |
|
|
1684
|
+
| 13 | Smart Context Builder | `/context` | Context, Codebase, Search, Recall, GetSchema | Automatic context assembly |
|
|
1685
|
+
| 14 | Anti-Pattern Tracker | `/anti-patterns` | Search, Forge, Outcome, Directive | Learn from failures |
|
|
1686
|
+
| 15 | Deployment Safety Net | `/deploy-check` | Conflict, Search, Recall, Directive, Plan | Pre-deployment safety checks |
|
|
1687
|
+
| 16 | Plan Manager | `/plans` | Plan, Plans, PlanStatus, PlanStep, Generate, SaveTemplate, Templates, FromTemplate | Multi-step task management |
|
|
1688
|
+
|
|
1689
|
+
---
|
|
1690
|
+
|
|
1691
|
+
## MCP Tool Coverage After All 16 Plugins (5 Core + 11 Proposed)
|
|
1692
|
+
|
|
1693
|
+
**Tools Used Across All Plugins:**
|
|
1694
|
+
|
|
1695
|
+
✅ ekkOS_Search (used in 12 plugins)
|
|
1696
|
+
✅ ekkOS_Forge (used in 5 plugins)
|
|
1697
|
+
✅ ekkOS_Stats (used in 4 plugins)
|
|
1698
|
+
✅ ekkOS_Summary (used in 5 plugins)
|
|
1699
|
+
✅ ekkOS_Directive (used in 5 plugins)
|
|
1700
|
+
✅ ekkOS_Recall (used in 4 plugins)
|
|
1701
|
+
✅ ekkOS_Codebase (used in 3 plugins)
|
|
1702
|
+
✅ ekkOS_Conflict (used in 3 plugins)
|
|
1703
|
+
✅ ekkOS_Context (used in 1 plugin)
|
|
1704
|
+
✅ ekkOS_Outcome (used in 2 plugins)
|
|
1705
|
+
✅ ekkOS_Reflect (used in 3 plugins)
|
|
1706
|
+
✅ ekkOS_IndexSchema (used in 1 plugin)
|
|
1707
|
+
✅ ekkOS_GetSchema (used in 2 plugins)
|
|
1708
|
+
✅ ekkOS_Export (used in 1 plugin)
|
|
1709
|
+
✅ ekkOS_Import (used in 1 plugin)
|
|
1710
|
+
✅ ekkOS_Plan (used in 4 plugins)
|
|
1711
|
+
✅ ekkOS_Plans (used in 1 plugin)
|
|
1712
|
+
✅ ekkOS_PlanStatus (used in 1 plugin)
|
|
1713
|
+
✅ ekkOS_PlanStep (used in 1 plugin)
|
|
1714
|
+
✅ ekkOS_Generate (used in 2 plugins)
|
|
1715
|
+
✅ ekkOS_SaveTemplate (used in 1 plugin)
|
|
1716
|
+
✅ ekkOS_Templates (used in 2 plugins)
|
|
1717
|
+
✅ ekkOS_FromTemplate (used in 1 plugin)
|
|
1718
|
+
✅ ekkOS_StoreSecret (used in 1 plugin)
|
|
1719
|
+
✅ ekkOS_GetSecret (used in 1 plugin)
|
|
1720
|
+
✅ ekkOS_ListSecrets (used in 1 plugin)
|
|
1721
|
+
✅ ekkOS_RotateSecret (used in 1 plugin)
|
|
1722
|
+
✅ ekkOS_DeleteSecret (used in 1 plugin)
|
|
1723
|
+
|
|
1724
|
+
**Tools NOT used in plugins (but available via MCP):**
|
|
1725
|
+
- ekkOS_Capture (auto-managed by hooks, could add manual interface)
|
|
1726
|
+
- ekkOS_Detect (auto-managed by hooks, could add manual interface)
|
|
1727
|
+
- ekkOS_Track (auto-managed by hooks, could add manual interface)
|
|
1728
|
+
|
|
1729
|
+
**Coverage: 28/31 tools (90%) actively used in user-facing plugins**
|
|
1730
|
+
|
|
1731
|
+
**Note:** The 3 remaining tools (Capture, Detect, Track) are primarily auto-managed by hooks but could potentially have manual user-facing interfaces added if needed.
|
|
1732
|
+
|
|
1733
|
+
---
|
|
1734
|
+
|
|
1735
|
+
## Prioritization for Implementation
|
|
1736
|
+
|
|
1737
|
+
### Tier 1: Must-Have (Implement First)
|
|
1738
|
+
1. **Plan Manager** - Exposes ALL 8 plan management tools, essential for multi-step work
|
|
1739
|
+
2. **Secret Vault** - Critical for security, immediate value
|
|
1740
|
+
3. **Pre-Flight Checker** - Prevents disasters, high ROI
|
|
1741
|
+
4. **Time Travel Debugger** - Unique capability, high value
|
|
1742
|
+
|
|
1743
|
+
### Tier 2: High Value (Implement Next)
|
|
1744
|
+
5. **Project Onboarding** - Great for new users, fresh projects
|
|
1745
|
+
6. **Smart Context Builder** - Saves significant time
|
|
1746
|
+
7. **Deployment Safety Net** - Prevents production incidents
|
|
1747
|
+
|
|
1748
|
+
### Tier 3: Polish & Enhancement (Later)
|
|
1749
|
+
8. **Memory Health Dashboard** - Nice to have, less urgent
|
|
1750
|
+
9. **Pattern Quality Coach** - Continuous improvement
|
|
1751
|
+
10. **Knowledge Backup Manager** - Important but not urgent
|
|
1752
|
+
11. **Anti-Pattern Tracker** - Educational value
|
|
1753
|
+
|
|
1754
|
+
---
|
|
1755
|
+
|
|
1756
|
+
## Next Steps
|
|
1757
|
+
|
|
1758
|
+
1. **Implement Tier 1 plugins first (4 plugins)** - Plan Manager, Secret Vault, Pre-Flight Checker, Time Travel Debugger
|
|
1759
|
+
2. **Ensure proper data isolation** - All plugins must scope to user_id, never expose other users' data
|
|
1760
|
+
3. **Update extension.ts deployment array** to include new plugins
|
|
1761
|
+
4. **Test each plugin** with real user scenarios and security review
|
|
1762
|
+
5. **Gather feedback** from early users
|
|
1763
|
+
6. **Iterate based on usage data**
|
|
1764
|
+
|
|
1765
|
+
With these 11 additional plugins, users will have comprehensive tools covering:
|
|
1766
|
+
- **Task Management** (Plan Manager - 8 plan tools)
|
|
1767
|
+
- **Security** (Secret Vault, Pre-Flight Checker)
|
|
1768
|
+
- **Debugging** (Time Travel, Context Builder)
|
|
1769
|
+
- **Onboarding** (Project Onboarding)
|
|
1770
|
+
- **Safety** (Deployment Safety Net, Pre-Flight Checker)
|
|
1771
|
+
- **Learning** (Pattern Quality Coach, Anti-Pattern Tracker)
|
|
1772
|
+
- **Maintenance** (Memory Health, Knowledge Backup)
|
|
1773
|
+
|
|
1774
|
+
**Total: 16 user-focused plugins covering 90% of MCP tools (28/31)!**
|
|
1775
|
+
|
|
1776
|
+
**Critical Security Note:** All plugins must implement proper user_id scoping to prevent data leakage between users.
|