brain-tree-ai 0.1.1 → 0.1.2
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/commands/init.js +868 -61
- package/dist/commands/init.js.map +1 -1
- package/package.json +1 -1
package/dist/commands/init.js
CHANGED
|
@@ -7,118 +7,925 @@ const DEFAULT_MCP_URL = 'https://braintree-mcp-production.up.railway.app/sse';
|
|
|
7
7
|
// Brain commands that get installed to ~/.claude/commands/
|
|
8
8
|
const BRAIN_COMMANDS = [
|
|
9
9
|
{
|
|
10
|
-
name: 'init-
|
|
11
|
-
content: `# Initialize
|
|
10
|
+
name: 'init-brain.md',
|
|
11
|
+
content: `# Initialize Brain
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
You are setting up a brand new BrainTree brain for the user. A brain is a living, structured knowledge base that organizes everything about a project, goal, or domain. It is powered by the BrainTree MCP server. All file operations MUST go through the MCP tools (never the local filesystem).
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
This command is a guided, multi-step conversation. Each question adapts based on the previous answer. Ask ONE question at a time. Do NOT rush through the phases.
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
17
|
+
## Phase 1: Role Discovery
|
|
18
|
+
|
|
19
|
+
Start with a friendly welcome, then ask the FIRST question:
|
|
20
|
+
|
|
21
|
+
"Welcome to BrainTree! I'm going to help you set up your brain, a living knowledge base that keeps everything about your work organized and actionable.
|
|
22
|
+
|
|
23
|
+
Let's start with the most important question:"
|
|
24
|
+
|
|
25
|
+
**Question 1** (present as a numbered list):
|
|
26
|
+
|
|
27
|
+
"What best describes your role?"
|
|
28
|
+
1. Solo founder building from scratch
|
|
29
|
+
2. Technical founder (I code, need help with everything else)
|
|
30
|
+
3. Non-technical founder (I have the vision, need technical execution)
|
|
31
|
+
4. Team lead / Engineering manager
|
|
32
|
+
5. Product Manager
|
|
33
|
+
6. Marketing / Growth
|
|
34
|
+
7. Customer Success / Support
|
|
35
|
+
8. Other (tell me your role)
|
|
36
|
+
|
|
37
|
+
Wait for their answer. Their role shapes EVERYTHING that follows. Do NOT proceed until you have a clear answer.
|
|
38
|
+
|
|
39
|
+
## Phase 2: Goals & Identity
|
|
40
|
+
|
|
41
|
+
**Question 2** (open-ended, this is the most important input):
|
|
42
|
+
|
|
43
|
+
Based on their role, ask a tailored version of this question. Adapt the phrasing to their role:
|
|
44
|
+
|
|
45
|
+
- Solo founder: "Tell me about what you're building. What stage are you at? What's your biggest challenge right now? The more context you give me, the smarter your brain will be."
|
|
46
|
+
- Technical founder: "What are you building and what's your tech stack? Where do you need the most help beyond coding?"
|
|
47
|
+
- Non-technical founder: "What's your vision? What problem are you solving and for whom? What have you done so far?"
|
|
48
|
+
- Team lead: "What does your team build? How big is the team? What's your current biggest operational challenge?"
|
|
49
|
+
- Product Manager: "What product do you manage? What's your team size and structure? What are your current priorities?"
|
|
50
|
+
- Marketing: "What company or product are you marketing? What channels are you focused on? What are your goals this quarter?"
|
|
51
|
+
- Customer Success: "What product do you support? How big is your customer base? What's your biggest retention challenge?"
|
|
52
|
+
- Other: "Tell me about yourself, your work, and what you want this brain to help you with."
|
|
53
|
+
|
|
54
|
+
Let them write as much as they want. This is where the magic happens. Acknowledge what they shared and summarize it back: "Here's what I understand: [summary]. Does that sound right?"
|
|
55
|
+
|
|
56
|
+
Wait for confirmation before proceeding.
|
|
57
|
+
|
|
58
|
+
## Phase 3: Context Source Discovery
|
|
59
|
+
|
|
60
|
+
**Question 3**:
|
|
61
|
+
|
|
62
|
+
"Now let's make your brain smart from day one. Do you have any existing context I can pull from?"
|
|
63
|
+
|
|
64
|
+
Present as a numbered list:
|
|
65
|
+
1. Local folder(s) on your computer (share the path and I'll read through everything)
|
|
66
|
+
2. URLs or web pages (docs, wikis, competitor sites, anything)
|
|
67
|
+
3. Paste text directly (specs, notes, plans, meeting notes, anything goes)
|
|
68
|
+
4. Nothing yet, starting fresh
|
|
69
|
+
|
|
70
|
+
**MCP Detection** (do this automatically, no need to ask):
|
|
71
|
+
Check what MCP servers are available in the current session. If you detect useful ones beyond the BrainTree MCP (e.g., GitHub, Slack, Notion, Linear, Figma, Google Drive, file system access), proactively suggest them:
|
|
72
|
+
|
|
73
|
+
"I also notice you have [MCP name] connected. Want me to pull relevant context from there too?"
|
|
74
|
+
|
|
75
|
+
For each source the user provides:
|
|
76
|
+
- **Local folders**: Read through files systematically. Summarize what you find. Identify the most relevant content.
|
|
77
|
+
- **URLs**: Fetch and extract relevant content using web tools.
|
|
78
|
+
- **Pasted text**: Acknowledge and organize it.
|
|
79
|
+
- **MCP sources**: Use the available MCP tools to explore and pull relevant data.
|
|
80
|
+
|
|
81
|
+
After exploring all sources, present a summary: "Here's what I gathered from your sources: [organized summary]. I'll weave this into your brain structure."
|
|
82
|
+
|
|
83
|
+
## Phase 4: Structure Preview
|
|
84
|
+
|
|
85
|
+
Based on everything learned in Phases 1-3, design a custom brain structure. The structure MUST be tailored to the user's role and goals.
|
|
86
|
+
|
|
87
|
+
### Structure Principles:
|
|
88
|
+
- Do NOT default to a corporate department structure unless the user is explicitly building a company/startup
|
|
89
|
+
- Name folders in the user's language (a PM thinks in "Discovery", "Specs", "Roadmap" not "02_Product", "03_Marketing")
|
|
90
|
+
- Keep it between 5-10 top-level folders. Less is more.
|
|
91
|
+
- ALWAYS include: Assets/, Handoffs/, Templates/
|
|
92
|
+
- If the user is building something with phases, include an Execution Plan
|
|
93
|
+
- If the user has an ongoing role, include working rhythms or processes
|
|
94
|
+
|
|
95
|
+
### Structure Templates by Role (use as starting points, customize based on actual goals):
|
|
96
|
+
|
|
97
|
+
**Solo Founder / Building a Product:**
|
|
98
|
+
\`\`\`
|
|
99
|
+
Vision/ - Identity, pitch, target users, problem/solution
|
|
100
|
+
Build/ - Architecture, tech stack, implementation notes
|
|
101
|
+
Product/ - Features, user flows, specs, decisions
|
|
102
|
+
Go-To-Market/ - Launch plan, channels, messaging, content
|
|
103
|
+
Operations/ - Processes, tools, hiring, budget
|
|
104
|
+
Assets/ - Images, videos, PDFs, mockups, screenshots
|
|
105
|
+
Handoffs/ - Session continuity notes
|
|
106
|
+
Templates/ - Reusable note structures
|
|
107
|
+
\`\`\`
|
|
108
|
+
|
|
109
|
+
**Technical Founder:**
|
|
110
|
+
\`\`\`
|
|
111
|
+
Architecture/ - System design, diagrams, tech decisions
|
|
112
|
+
Services/ - Service docs, APIs, schemas, integrations
|
|
113
|
+
Product/ - Feature specs, user stories, roadmap
|
|
114
|
+
Runbooks/ - Deploy guides, operational procedures
|
|
115
|
+
Research/ - Spikes, POCs, technology evaluations
|
|
116
|
+
Assets/ - Diagrams, screenshots, recordings
|
|
117
|
+
Handoffs/ - Session continuity notes
|
|
118
|
+
Templates/ - Reusable note structures
|
|
119
|
+
\`\`\`
|
|
120
|
+
|
|
121
|
+
**Non-Technical Founder:**
|
|
122
|
+
\`\`\`
|
|
123
|
+
Vision/ - Mission, values, pitch, brand identity
|
|
124
|
+
Product/ - Features, user experience, requirements
|
|
125
|
+
Business/ - Market research, competitors, partnerships
|
|
126
|
+
Marketing/ - Content, social media, campaigns, SEO
|
|
127
|
+
Finance/ - Budget, revenue model, funding
|
|
128
|
+
Assets/ - Mockups, brand assets, pitch decks
|
|
129
|
+
Handoffs/ - Session continuity notes
|
|
130
|
+
Templates/ - Reusable note structures
|
|
131
|
+
\`\`\`
|
|
132
|
+
|
|
133
|
+
**Product Manager:**
|
|
134
|
+
\`\`\`
|
|
135
|
+
Strategy/ - Product vision, OKRs, competitive landscape
|
|
136
|
+
Discovery/ - User research, interviews, pain points
|
|
137
|
+
Roadmap/ - Current quarter, backlog, prioritization
|
|
138
|
+
Specs/ - Feature specs (one per feature)
|
|
139
|
+
Stakeholders/ - Engineering, design, leadership alignment
|
|
140
|
+
Metrics/ - KPIs, experiments, dashboards
|
|
141
|
+
Assets/ - Screenshots, mockups, recordings
|
|
142
|
+
Handoffs/ - Session continuity notes
|
|
143
|
+
Templates/ - Reusable note structures
|
|
144
|
+
\`\`\`
|
|
145
|
+
|
|
146
|
+
**Marketing / Growth:**
|
|
147
|
+
\`\`\`
|
|
148
|
+
Strategy/ - Positioning, messaging, brand voice
|
|
149
|
+
Campaigns/ - Campaign briefs, results, learnings
|
|
150
|
+
Content/ - Content calendar, posts, email sequences
|
|
151
|
+
Channels/ - Per-channel strategy (social, email, paid, SEO)
|
|
152
|
+
Audience/ - Personas, segments, research
|
|
153
|
+
Analytics/ - Performance data, attribution, funnel analysis
|
|
154
|
+
Assets/ - Brand assets, creatives, videos
|
|
155
|
+
Handoffs/ - Session continuity notes
|
|
156
|
+
Templates/ - Reusable note structures
|
|
157
|
+
\`\`\`
|
|
158
|
+
|
|
159
|
+
**Customer Success:**
|
|
160
|
+
\`\`\`
|
|
161
|
+
Accounts/ - Key account profiles, health scores
|
|
162
|
+
Playbooks/ - Onboarding, renewal, expansion, churn prevention
|
|
163
|
+
Feedback/ - Customer feedback, feature requests, NPS
|
|
164
|
+
Processes/ - Escalation paths, SLAs, workflows
|
|
165
|
+
Knowledge-Base/ - FAQs, troubleshooting, documentation
|
|
166
|
+
Metrics/ - Retention, NRR, CSAT, health scores
|
|
167
|
+
Assets/ - Training materials, recordings
|
|
168
|
+
Handoffs/ - Session continuity notes
|
|
169
|
+
Templates/ - Reusable note structures
|
|
170
|
+
\`\`\`
|
|
171
|
+
|
|
172
|
+
**Team Lead / Engineering Manager:**
|
|
173
|
+
\`\`\`
|
|
174
|
+
Team/ - Members, roles, growth plans, 1:1 notes
|
|
175
|
+
Architecture/ - System design, tech debt, ADRs
|
|
176
|
+
Planning/ - Sprint plans, capacity, roadmap alignment
|
|
177
|
+
Processes/ - Code review, on-call, incident response
|
|
178
|
+
Hiring/ - Job descriptions, interview guides, pipeline
|
|
179
|
+
Metrics/ - Velocity, quality, team health
|
|
180
|
+
Assets/ - Diagrams, org charts, presentations
|
|
181
|
+
Handoffs/ - Session continuity notes
|
|
182
|
+
Templates/ - Reusable note structures
|
|
183
|
+
\`\`\`
|
|
184
|
+
|
|
185
|
+
**Trader / Finance:**
|
|
186
|
+
\`\`\`
|
|
187
|
+
Strategies/ - Trading strategies, backtests, edge definitions
|
|
188
|
+
Trade-Log/ - Trade journal, entries, exits, reviews
|
|
189
|
+
Market-Research/ - Macro, sectors, earnings, catalysts
|
|
190
|
+
Risk-Management/ - Position sizing, stop rules, risk limits
|
|
191
|
+
Watchlists/ - Tickers, setups, alerts
|
|
192
|
+
Performance/ - P&L tracking, analytics, equity curve
|
|
193
|
+
Assets/ - Charts, screenshots, data exports
|
|
194
|
+
Handoffs/ - Session continuity notes
|
|
195
|
+
Templates/ - Reusable note structures
|
|
196
|
+
\`\`\`
|
|
197
|
+
|
|
198
|
+
**Student / Researcher:**
|
|
199
|
+
\`\`\`
|
|
200
|
+
Courses/ - Course notes, syllabi, assignments
|
|
201
|
+
Research/ - Papers, literature reviews, methodology
|
|
202
|
+
Projects/ - Project plans, deliverables, timelines
|
|
203
|
+
Notes/ - Lecture notes, reading notes, summaries
|
|
204
|
+
Resources/ - Links, tools, references, datasets
|
|
205
|
+
Schedule/ - Deadlines, milestones, calendar
|
|
206
|
+
Assets/ - Papers, slides, diagrams, data
|
|
207
|
+
Handoffs/ - Session continuity notes
|
|
208
|
+
Templates/ - Reusable note structures
|
|
209
|
+
\`\`\`
|
|
210
|
+
|
|
211
|
+
If the user's role doesn't match any template, create a fully custom structure.
|
|
212
|
+
|
|
213
|
+
**Present the structure as an interactive preview:**
|
|
214
|
+
|
|
215
|
+
Show the full folder tree with brief descriptions for each folder. Then:
|
|
216
|
+
|
|
217
|
+
1. Explicitly highlight the Assets folder: "The **Assets/** folder is where you can drop images, videos, PDFs, and any other files. I can analyze all of them, including screenshots, mockups, screen recordings, documents, and data files."
|
|
218
|
+
|
|
219
|
+
2. Ask: "Would you like to add, remove, or rename any folders before I build it?"
|
|
220
|
+
|
|
221
|
+
Wait for confirmation before proceeding.
|
|
222
|
+
|
|
223
|
+
## Phase 5: Build
|
|
224
|
+
|
|
225
|
+
Create all brain files using the BrainTree MCP tools.
|
|
226
|
+
|
|
227
|
+
### Step 1: Create CLAUDE.md
|
|
228
|
+
This is the brain's DNA. Every AI agent reads this file first. Use \`write_file\` to create \`CLAUDE.md\` at the brain root.
|
|
229
|
+
|
|
230
|
+
CLAUDE.md must include ALL of these sections:
|
|
231
|
+
|
|
232
|
+
\`\`\`
|
|
233
|
+
# [Brain Name] - Agent Instructions
|
|
234
|
+
|
|
235
|
+
## What Is This Brain?
|
|
236
|
+
[2-3 sentences: what this brain is for, written as context for an AI seeing it for the first time]
|
|
237
|
+
|
|
238
|
+
## Owner
|
|
239
|
+
- **Role**: [user's role]
|
|
240
|
+
- **Context**: [key context from their answers, summarized]
|
|
241
|
+
- **Goals**: [primary goals extracted from the conversation]
|
|
242
|
+
|
|
243
|
+
## Brain Structure
|
|
244
|
+
[Full map of folders with one-line descriptions]
|
|
245
|
+
|
|
246
|
+
## Conventions
|
|
247
|
+
- Use [[wikilinks]] for all cross-references between notes
|
|
248
|
+
- Keep files concise and actionable
|
|
249
|
+
- Tag files with relevant hashtags for discoverability
|
|
250
|
+
- Check Assets/ for related images, videos, PDFs when working on any task
|
|
251
|
+
- Update Handoffs/ at the end of every work session
|
|
252
|
+
- Reference the Execution Plan as the source of truth for build order (if applicable)
|
|
253
|
+
|
|
254
|
+
## Assets
|
|
255
|
+
The Assets/ folder contains images, videos, PDFs, and other media. When working on any task, check Assets/ for related materials. You can analyze images, read PDFs, and process any file dropped there.
|
|
256
|
+
|
|
257
|
+
## Agent Personas
|
|
258
|
+
Available specialized agents in .claude/agents/:
|
|
259
|
+
[List each agent: name and one-line purpose]
|
|
260
|
+
|
|
261
|
+
## Commands
|
|
262
|
+
- /init-brain - Initialize a new brain
|
|
263
|
+
- /brain-resume - Resume from where you left off
|
|
264
|
+
- /brain-wrap-up - End session with proper handoff
|
|
265
|
+
- /brain-status - View progress dashboard
|
|
266
|
+
- /brain-plan [step] - Plan a specific step
|
|
267
|
+
- /brain-sprint - Plan the week's work
|
|
268
|
+
- /brain-sync - Health check and sync
|
|
269
|
+
- /brain-feature [name] - Plan a new feature
|
|
270
|
+
\`\`\`
|
|
271
|
+
|
|
272
|
+
### Step 2: Create Agent Personas
|
|
273
|
+
Use \`write_file\` to create 2-4 agent persona files in \`.claude/agents/\`. Each persona must be specifically useful for THIS user's role and goals. Reference the user's actual project and context in each persona.
|
|
274
|
+
|
|
275
|
+
Each persona file:
|
|
276
|
+
\`\`\`
|
|
277
|
+
# [Agent Name]
|
|
278
|
+
|
|
279
|
+
## Purpose
|
|
280
|
+
[One sentence: what this agent does for this specific user]
|
|
281
|
+
|
|
282
|
+
## Expertise
|
|
283
|
+
[What this agent knows, specific to the user's domain and project]
|
|
284
|
+
|
|
285
|
+
## Approach
|
|
286
|
+
[How this agent thinks, communicates, and works]
|
|
287
|
+
|
|
288
|
+
## When to Use
|
|
289
|
+
[Specific scenarios where this agent is the right choice]
|
|
290
|
+
|
|
291
|
+
## Instructions
|
|
292
|
+
[Detailed instructions for operating in this brain, referencing actual folders and files]
|
|
293
|
+
\`\`\`
|
|
294
|
+
|
|
295
|
+
**Select personas based on role** (adapt to actual goals, these are starting points):
|
|
296
|
+
|
|
297
|
+
Solo Founder:
|
|
298
|
+
- builder.md: Full-stack implementation, ships code, makes technical decisions
|
|
299
|
+
- strategist.md: Product thinking, prioritization, business model, go-to-market
|
|
300
|
+
- researcher.md: Market analysis, competitor intel, user insights, validation
|
|
301
|
+
- writer.md: Copy, content, docs, pitch materials, social media
|
|
302
|
+
|
|
303
|
+
Technical Founder:
|
|
304
|
+
- architect.md: System design, tech decisions, scalability planning
|
|
305
|
+
- product.md: Feature prioritization, user stories, product-market fit
|
|
306
|
+
- devops.md: Infrastructure, CI/CD, monitoring, deployment
|
|
307
|
+
- growth.md: Launch strategy, marketing, user acquisition
|
|
308
|
+
|
|
309
|
+
Non-Technical Founder:
|
|
310
|
+
- product.md: Feature definition, user experience, requirements
|
|
311
|
+
- business.md: Market research, competitive analysis, business model
|
|
312
|
+
- marketing.md: Brand, content, social media, launch campaigns
|
|
313
|
+
- hiring.md: Team building, job descriptions, interview process
|
|
314
|
+
|
|
315
|
+
Product Manager:
|
|
316
|
+
- analyst.md: Data analysis, metrics, experiment design, dashboards
|
|
317
|
+
- spec-writer.md: Feature specs, PRDs, acceptance criteria, user stories
|
|
318
|
+
- researcher.md: User interview synthesis, competitive analysis, market trends
|
|
319
|
+
- facilitator.md: Stakeholder alignment, decision documentation, trade-offs
|
|
320
|
+
|
|
321
|
+
Marketing / Growth:
|
|
322
|
+
- content-creator.md: Blog posts, social media, email campaigns, copywriting
|
|
323
|
+
- analyst.md: Campaign performance, funnel analysis, attribution modeling
|
|
324
|
+
- strategist.md: Positioning, messaging, channel strategy, brand voice
|
|
325
|
+
- seo.md: Search optimization, keyword research, content planning
|
|
326
|
+
|
|
327
|
+
Customer Success:
|
|
328
|
+
- account-manager.md: Account health, renewal strategies, expansion playbooks
|
|
329
|
+
- analyst.md: Churn analysis, NPS trends, customer health scoring
|
|
330
|
+
- content.md: Help docs, onboarding guides, training materials
|
|
331
|
+
- process.md: Workflow optimization, escalation procedures, SLA management
|
|
332
|
+
|
|
333
|
+
Team Lead:
|
|
334
|
+
- architect.md: System design, tech debt assessment, architecture decisions
|
|
335
|
+
- planner.md: Sprint planning, task breakdown, dependency mapping
|
|
336
|
+
- people.md: 1:1 prep, growth plans, hiring pipeline, team health
|
|
337
|
+
- reviewer.md: Code review guidance, quality standards, best practices
|
|
338
|
+
|
|
339
|
+
Trader / Finance:
|
|
340
|
+
- analyst.md: Market analysis, sector research, earnings analysis
|
|
341
|
+
- risk.md: Position sizing, risk management, portfolio allocation
|
|
342
|
+
- journal.md: Trade review, pattern recognition, performance analysis
|
|
343
|
+
- researcher.md: Macro trends, catalyst identification, data analysis
|
|
344
|
+
|
|
345
|
+
Student / Researcher:
|
|
346
|
+
- tutor.md: Concept explanation, study strategies, problem solving
|
|
347
|
+
- writer.md: Paper writing, citations, literature review synthesis
|
|
348
|
+
- planner.md: Project planning, deadline management, task breakdown
|
|
349
|
+
- reviewer.md: Draft feedback, argument analysis, fact checking
|
|
350
|
+
|
|
351
|
+
IMPORTANT: Every persona MUST reference the user's actual project, goals, and brain structure. Generic personas are useless. Write them as if they were custom-built for this specific user.
|
|
352
|
+
|
|
353
|
+
### Step 3: Create BRAIN-INDEX.md
|
|
354
|
+
Use \`write_file\` to create \`BRAIN-INDEX.md\` at the brain root. This is the master navigation file. Include:
|
|
355
|
+
- Brain name and description
|
|
356
|
+
- Creation date
|
|
357
|
+
- Owner/role
|
|
358
|
+
- A linked table of contents to every folder index
|
|
359
|
+
- A "Quick Links" section for the most important files
|
|
360
|
+
- Session log section (starts with "Session 0: Brain Initialized")
|
|
361
|
+
|
|
362
|
+
### Step 4: Create folder index files
|
|
363
|
+
For each folder in the structure, use \`write_file\` to create an index file (e.g., \`Vision/README.md\`). Each index should:
|
|
364
|
+
- Describe the folder's purpose in context of THIS user's project
|
|
365
|
+
- List what will go in it
|
|
366
|
+
- Include wikilinks (\`[[filename]]\`) to planned content files
|
|
367
|
+
- Be concise (20-40 lines max)
|
|
368
|
+
|
|
369
|
+
### Step 5: Create Assets/README.md
|
|
370
|
+
Always create this file:
|
|
371
|
+
|
|
372
|
+
\`\`\`
|
|
373
|
+
# Assets
|
|
374
|
+
|
|
375
|
+
Drop any files here that you want your AI agents to understand.
|
|
376
|
+
|
|
377
|
+
## Supported Formats
|
|
378
|
+
- Images (PNG, JPG, SVG): screenshots, mockups, diagrams, whiteboard photos
|
|
379
|
+
- Videos (MP4, MOV): recordings, demos, user sessions, presentations
|
|
380
|
+
- PDFs: documents, reports, contracts, research papers
|
|
381
|
+
- Data (CSV, JSON, Excel): datasets, exports, analytics
|
|
382
|
+
|
|
383
|
+
## How It Works
|
|
384
|
+
When you or an agent works on a task, this folder is checked for related materials.
|
|
385
|
+
You can also point an agent here directly: "analyze the mockup in Assets/homepage-v2.png"
|
|
386
|
+
|
|
387
|
+
## Naming Convention
|
|
388
|
+
Use descriptive names: competitor-pricing-screenshot.png not IMG_4521.png
|
|
389
|
+
\`\`\`
|
|
390
|
+
|
|
391
|
+
### Step 6: Create Execution Plan or Working Rhythms
|
|
392
|
+
If the user is building something with clear phases (product, project, course), create \`Execution-Plan.md\` with:
|
|
393
|
+
- Numbered phases with milestones
|
|
394
|
+
- Steps with: step ID, title, description, status (not_started), dependencies
|
|
395
|
+
- Parallel groups where applicable
|
|
396
|
+
|
|
397
|
+
If the brain is ongoing/operational, create \`Working-Rhythms.md\` with:
|
|
398
|
+
- Daily/weekly/monthly recurring workflows
|
|
399
|
+
- Review cadences
|
|
400
|
+
- Templates for recurring tasks
|
|
401
|
+
|
|
402
|
+
### Step 7: Create Templates
|
|
403
|
+
Use \`write_file\` to create 2-3 templates in \`Templates/\`:
|
|
404
|
+
- A general note template
|
|
405
|
+
- A domain-specific template based on the user's role
|
|
406
|
+
- A decision log template
|
|
407
|
+
|
|
408
|
+
### Step 8: Seed initial content
|
|
409
|
+
Using context gathered in Phase 3, create real content files in the relevant folders:
|
|
410
|
+
- Specs, plans, research organized into the right locations
|
|
411
|
+
- Content from MCP sources placed appropriately
|
|
412
|
+
- Competitive analysis, tech stack docs, whatever was gathered
|
|
413
|
+
|
|
414
|
+
This is what makes the brain feel alive from day one.
|
|
415
|
+
|
|
416
|
+
## Phase 6: Handoff
|
|
417
|
+
|
|
418
|
+
1. Use \`create_handoff\` with session_number 0, a summary of what was created, and content that includes:
|
|
419
|
+
- The brain structure
|
|
420
|
+
- Context gathered and where it was placed
|
|
421
|
+
- Agent personas created
|
|
422
|
+
- Recommended first steps for the next session
|
|
423
|
+
- Key files to read when resuming
|
|
424
|
+
|
|
425
|
+
2. Present a final summary to the user:
|
|
426
|
+
- Show the complete file tree with counts
|
|
427
|
+
- List agent personas and their purposes
|
|
428
|
+
- Highlight the Assets folder: "Remember, you can drop images, videos, and documents in Assets/ and I can analyze them."
|
|
429
|
+
- Highlight CLAUDE.md: "Your brain has a CLAUDE.md that tells any AI agent how to work here."
|
|
430
|
+
- End with: "Your brain is ready! Run /brain-resume to start your first real work session."
|
|
23
431
|
`,
|
|
24
432
|
},
|
|
25
433
|
{
|
|
26
434
|
name: 'brain-resume.md',
|
|
27
|
-
content: `# Resume
|
|
435
|
+
content: `# Resume Brain Session
|
|
436
|
+
|
|
437
|
+
You are helping the user resume work on their BrainTree brain. This is the most important command because it is how every work session starts. Your goal is to give the user a crystal-clear picture of where they are and exactly what to do next. Do NOT just dump status. Be a strategic advisor.
|
|
438
|
+
|
|
439
|
+
## Step 1: Load Context
|
|
440
|
+
|
|
441
|
+
Run these MCP calls to gather the full picture:
|
|
442
|
+
|
|
443
|
+
1. \`get_latest_handoff()\` to read the last session's summary, what was done, what was recommended next, and which files to focus on.
|
|
444
|
+
2. \`get_execution_plan()\` to see overall progress across all phases and steps.
|
|
445
|
+
3. \`list_unblocked_steps()\` to find all steps that are ready to work on right now (no blockers).
|
|
446
|
+
4. \`list_departments()\` to understand the brain's structure and which areas have content.
|
|
447
|
+
|
|
448
|
+
## Step 2: Read Key Files
|
|
449
|
+
|
|
450
|
+
Based on the handoff's "files to read" recommendation, use \`read_file()\` on the 2-4 most important files for the current context. This gives you the detailed state, not just summaries.
|
|
451
|
+
|
|
452
|
+
## Step 3: Present Targeted Status
|
|
453
|
+
|
|
454
|
+
Present a focused status report. Structure it exactly like this:
|
|
455
|
+
|
|
456
|
+
### Last Session Recap
|
|
457
|
+
"In your last session (Session N), you [concise summary of what was accomplished]. You left off at [specific point]."
|
|
458
|
+
|
|
459
|
+
If there were blockers or open questions from the last session, highlight them here.
|
|
460
|
+
|
|
461
|
+
### Current Progress
|
|
462
|
+
Show a brief progress overview. Use ASCII progress bars for phases:
|
|
463
|
+
\`\`\`
|
|
464
|
+
Phase 1: Setup [========--] 80% (7/9 steps)
|
|
465
|
+
Phase 2: Core Build [===-------] 30% (3/10 steps)
|
|
466
|
+
Phase 3: Launch [----------] 0% (0/5 steps)
|
|
467
|
+
\`\`\`
|
|
468
|
+
|
|
469
|
+
### Recommended Next Steps
|
|
470
|
+
This is the most critical part. Be specific and actionable:
|
|
471
|
+
|
|
472
|
+
"The highest priority next step is **[Step X.Y: Title]** because [reason: it unblocks the most work / it is on the critical path / it was recommended in the last handoff]."
|
|
473
|
+
|
|
474
|
+
For each recommended step (up to 3), include:
|
|
475
|
+
- What the step involves (1-2 sentences)
|
|
476
|
+
- Which brain files are relevant (list specific paths)
|
|
477
|
+
- Estimated complexity (small / medium / large)
|
|
478
|
+
|
|
479
|
+
### Parallel Opportunities
|
|
480
|
+
If multiple unblocked steps can run simultaneously, highlight this: "Steps X.Y and X.Z can run in parallel. Want me to set up a team for parallel execution?"
|
|
28
481
|
|
|
29
|
-
|
|
482
|
+
## Step 4: Ask What to Work On
|
|
30
483
|
|
|
31
|
-
|
|
484
|
+
Present the options as a numbered list and ask the user to pick:
|
|
32
485
|
|
|
33
|
-
1.
|
|
34
|
-
2.
|
|
35
|
-
3.
|
|
36
|
-
4.
|
|
486
|
+
1. [Recommended step] (highest priority)
|
|
487
|
+
2. [Another unblocked step]
|
|
488
|
+
3. [Another unblocked step]
|
|
489
|
+
4. Something else (describe what you want to work on)
|
|
490
|
+
|
|
491
|
+
Wait for the user's choice before proceeding. Once they choose, dive into the work immediately.
|
|
37
492
|
`,
|
|
38
493
|
},
|
|
39
494
|
{
|
|
40
495
|
name: 'brain-wrap-up.md',
|
|
41
|
-
content: `# Wrap Up Session
|
|
496
|
+
content: `# Wrap Up Brain Session
|
|
497
|
+
|
|
498
|
+
You are closing out a work session on the user's BrainTree brain. This is one of the most important commands because it ensures continuity between sessions. A good wrap-up means the next /brain-resume will be seamless. A bad one means lost context and wasted time.
|
|
499
|
+
|
|
500
|
+
Your job: audit everything that happened, update the brain to reflect reality, and create a comprehensive handoff.
|
|
501
|
+
|
|
502
|
+
## Step 1: Audit the Session
|
|
503
|
+
|
|
504
|
+
Before writing anything, figure out what happened this session:
|
|
505
|
+
|
|
506
|
+
1. Review your conversation history to identify:
|
|
507
|
+
- Files that were created or modified (in the brain or in the codebase)
|
|
508
|
+
- Steps from the execution plan that progressed or completed
|
|
509
|
+
- Decisions that were made and their rationale
|
|
510
|
+
- Blockers that were discovered
|
|
511
|
+
- Ideas or insights that came up
|
|
512
|
+
- Any context the user shared that should be preserved
|
|
513
|
+
|
|
514
|
+
2. Use \`list_departments()\` to identify which departments/areas of the brain were touched.
|
|
515
|
+
|
|
516
|
+
## Step 2: Update Department Files
|
|
517
|
+
|
|
518
|
+
For each department/area that was touched during the session:
|
|
519
|
+
|
|
520
|
+
1. Use \`read_file()\` to read the department's index or relevant content files.
|
|
521
|
+
2. Use \`write_file()\` to update those files with:
|
|
522
|
+
- New content created during the session (e.g., if you wrote marketing copy, save it to the Marketing folder)
|
|
523
|
+
- Updated status information
|
|
524
|
+
- New wikilinks to newly created files
|
|
525
|
+
- Notes on decisions or changes made
|
|
526
|
+
|
|
527
|
+
Be thorough. If the session involved work across multiple areas (e.g., frontend code + marketing content + infrastructure setup), update ALL relevant files in the brain.
|
|
528
|
+
|
|
529
|
+
Examples:
|
|
530
|
+
- Built a landing page? Update RnD/Frontend/ with component details and Marketing/ with copy/messaging.
|
|
531
|
+
- Wrote social media content for 5 platforms? Create or update files in Marketing/Content/ for each platform.
|
|
532
|
+
- Set up CI/CD? Update RnD/Infrastructure/ or Runbooks/ with the pipeline details.
|
|
533
|
+
- Had a strategy discussion? Update Product/Strategy/ or Business/ with the decisions.
|
|
534
|
+
|
|
535
|
+
## Step 3: Update Execution Plan
|
|
536
|
+
|
|
537
|
+
Use \`get_execution_plan()\` to see the current plan, then for each step that progressed:
|
|
538
|
+
|
|
539
|
+
- Use \`update_step(step_id, "completed")\` for finished steps. Include a brief note of what was done in the tasks field.
|
|
540
|
+
- Use \`update_step(step_id, "in_progress")\` for steps that were started but not finished. Include what remains in the tasks field.
|
|
541
|
+
- Use \`update_step(step_id, "blocked", "reason")\` for steps that hit a blocker.
|
|
542
|
+
|
|
543
|
+
## Step 4: Create Handoff
|
|
544
|
+
|
|
545
|
+
Use \`create_handoff()\` with a comprehensive handoff. The content MUST include all of these sections:
|
|
546
|
+
|
|
547
|
+
### Summary
|
|
548
|
+
A 2-3 sentence overview of the session.
|
|
549
|
+
|
|
550
|
+
### What Was Done
|
|
551
|
+
Bullet list of concrete accomplishments:
|
|
552
|
+
- Files created/modified (with paths)
|
|
553
|
+
- Features built or content created
|
|
554
|
+
- Configurations changed
|
|
555
|
+
- Issues resolved
|
|
556
|
+
|
|
557
|
+
### Decisions Made
|
|
558
|
+
Document any decisions and their rationale. Future sessions need to know WHY things were done a certain way.
|
|
559
|
+
|
|
560
|
+
### Blockers and Open Questions
|
|
561
|
+
Anything unresolved that the next session needs to address.
|
|
562
|
+
|
|
563
|
+
### Recommended Next Steps
|
|
564
|
+
Specific, actionable items for the next session. Ordered by priority. Include which files to read first and which execution plan steps to tackle.
|
|
565
|
+
|
|
566
|
+
### Files to Read on Resume
|
|
567
|
+
List the 3-5 most important files the next session should read to get up to speed quickly.
|
|
568
|
+
|
|
569
|
+
## Step 5: Update BRAIN-INDEX
|
|
570
|
+
|
|
571
|
+
Use \`read_file()\` on BRAIN-INDEX.md, then \`write_file()\` to:
|
|
572
|
+
- Add a session log entry (Session N: [date] - [brief summary])
|
|
573
|
+
- Update any department status indicators if they changed
|
|
574
|
+
- Update progress percentage if applicable
|
|
42
575
|
|
|
43
|
-
|
|
576
|
+
## Step 6: Present Summary
|
|
44
577
|
|
|
45
|
-
|
|
578
|
+
Show the user a clean summary:
|
|
579
|
+
- Session number and duration
|
|
580
|
+
- Key accomplishments (bullet list)
|
|
581
|
+
- Brain files updated (count and list)
|
|
582
|
+
- Execution plan progress (before and after)
|
|
583
|
+
- What to do next session
|
|
46
584
|
|
|
47
|
-
|
|
48
|
-
2. Use MCP \`update_step\` to mark completed steps
|
|
49
|
-
3. Use MCP \`create_handoff\` with session summary
|
|
50
|
-
4. List recommended next steps
|
|
585
|
+
End with: "Your brain is up to date. Run /brain-resume next time to pick up right where you left off."
|
|
51
586
|
`,
|
|
52
587
|
},
|
|
53
588
|
{
|
|
54
589
|
name: 'brain-status.md',
|
|
55
|
-
content: `#
|
|
590
|
+
content: `# Brain Status Dashboard
|
|
56
591
|
|
|
57
|
-
|
|
592
|
+
Generate a comprehensive status dashboard for the user's BrainTree brain. This should feel like opening a project dashboard, giving an instant, visual overview of everything.
|
|
58
593
|
|
|
59
|
-
##
|
|
594
|
+
## Step 1: Gather Data
|
|
60
595
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
596
|
+
Run all of these MCP calls to collect the full picture:
|
|
597
|
+
|
|
598
|
+
1. \`get_execution_plan()\` for phase-by-phase progress
|
|
599
|
+
2. \`list_departments()\` for department structure and file counts
|
|
600
|
+
3. \`list_handoffs()\` for session history
|
|
601
|
+
4. \`get_graph()\` for the knowledge graph stats (nodes, edges, connectivity)
|
|
602
|
+
|
|
603
|
+
## Step 2: Present the Dashboard
|
|
604
|
+
|
|
605
|
+
Format the output as a rich ASCII dashboard. Include all of these sections:
|
|
606
|
+
|
|
607
|
+
### Execution Plan Progress
|
|
608
|
+
Show each phase with an ASCII progress bar and step counts:
|
|
609
|
+
\`\`\`
|
|
610
|
+
Phase 0: Foundation [==========] 100% (5/5 steps done)
|
|
611
|
+
Phase 1: Core Build [======----] 60% (6/10 steps done)
|
|
612
|
+
Phase 2: Launch Prep [==--------] 20% (2/10 steps done)
|
|
613
|
+
Phase 3: Post-Launch [----------] 0% (0/8 steps done)
|
|
614
|
+
|
|
615
|
+
Overall: [=====-----] 39% complete (13/33 steps)
|
|
616
|
+
\`\`\`
|
|
617
|
+
|
|
618
|
+
### Currently In Progress
|
|
619
|
+
List any steps with status "in_progress":
|
|
620
|
+
- Step X.Y: Title (started Session N)
|
|
621
|
+
|
|
622
|
+
### Blocked Steps
|
|
623
|
+
List any steps with status "blocked" and their blockers.
|
|
624
|
+
|
|
625
|
+
### Unblocked and Ready
|
|
626
|
+
List steps that can be started right now (from \`list_unblocked_steps()\`).
|
|
627
|
+
|
|
628
|
+
### Department Overview
|
|
629
|
+
Show each department with file count and a brief status:
|
|
630
|
+
\`\`\`
|
|
631
|
+
Department Files Status
|
|
632
|
+
00_Company 4 Healthy
|
|
633
|
+
01_RnD 12 Active (last updated Session 5)
|
|
634
|
+
02_Product 3 Needs attention
|
|
635
|
+
03_Marketing 0 Empty
|
|
636
|
+
...
|
|
637
|
+
\`\`\`
|
|
638
|
+
|
|
639
|
+
### Knowledge Graph Stats
|
|
640
|
+
From the graph data:
|
|
641
|
+
- Total nodes (files)
|
|
642
|
+
- Total edges (wikilinks)
|
|
643
|
+
- Average connections per file
|
|
644
|
+
- Orphan files (no incoming or outgoing links)
|
|
645
|
+
- Most connected files (top 3)
|
|
646
|
+
|
|
647
|
+
### Session Timeline
|
|
648
|
+
Show the last 5 sessions from handoffs:
|
|
649
|
+
\`\`\`
|
|
650
|
+
Session 5 (2025-01-15) Built authentication flow
|
|
651
|
+
Session 4 (2025-01-14) Set up database schema
|
|
652
|
+
Session 3 (2025-01-13) Designed landing page
|
|
653
|
+
...
|
|
654
|
+
\`\`\`
|
|
655
|
+
|
|
656
|
+
### Recommendations
|
|
657
|
+
Based on the data, suggest 1-2 actions:
|
|
658
|
+
- If there are orphan files, suggest linking them
|
|
659
|
+
- If a department is empty, suggest populating it
|
|
660
|
+
- If progress has stalled on a phase, highlight the blocking steps
|
|
661
|
+
- If the user has not had a session recently, welcome them back
|
|
65
662
|
`,
|
|
66
663
|
},
|
|
67
664
|
{
|
|
68
665
|
name: 'brain-plan.md',
|
|
69
|
-
content: `# Plan Step
|
|
666
|
+
content: `# Plan a Brain Step
|
|
667
|
+
|
|
668
|
+
Help the user plan the implementation of a specific execution plan step. This command breaks a high-level step into concrete, actionable tasks and prepares everything needed to execute.
|
|
669
|
+
|
|
670
|
+
## Step 1: Identify the Step
|
|
671
|
+
|
|
672
|
+
If the user specified a step (e.g., "/brain-plan 2.3"), use that. Otherwise:
|
|
673
|
+
|
|
674
|
+
1. Use \`get_execution_plan()\` to show available steps.
|
|
675
|
+
2. Use \`list_unblocked_steps()\` to highlight which ones are ready.
|
|
676
|
+
3. Ask the user which step they want to plan. Present as a numbered list of unblocked steps.
|
|
677
|
+
|
|
678
|
+
Wait for the user to choose before proceeding.
|
|
679
|
+
|
|
680
|
+
## Step 2: Gather Context
|
|
681
|
+
|
|
682
|
+
Once the step is identified:
|
|
683
|
+
|
|
684
|
+
1. Use \`get_execution_plan()\` to get the step's full details: title, description, dependencies, and current status.
|
|
685
|
+
2. Use \`list_departments()\` to see which departments are relevant.
|
|
686
|
+
3. Use \`read_file()\` on 2-4 relevant brain files that provide context for this step. For example:
|
|
687
|
+
- The department index for the area this step belongs to
|
|
688
|
+
- Any existing specs or plans related to this step
|
|
689
|
+
- The BRAIN-INDEX for overall context
|
|
690
|
+
4. If the step has dependencies, use \`read_file()\` on files related to completed prerequisite steps to understand what has already been built.
|
|
691
|
+
|
|
692
|
+
## Step 3: Create the Plan
|
|
693
|
+
|
|
694
|
+
Break the step down into concrete implementation tasks. For each task:
|
|
695
|
+
|
|
696
|
+
1. **Title**: What needs to be done (one sentence)
|
|
697
|
+
2. **Details**: How to do it (specific files to create/modify, tools to use, acceptance criteria)
|
|
698
|
+
3. **Effort**: Small (< 30 min) / Medium (30-90 min) / Large (> 90 min)
|
|
699
|
+
4. **Order**: Which tasks depend on others
|
|
700
|
+
|
|
701
|
+
Present the plan as a numbered checklist the user can review.
|
|
702
|
+
|
|
703
|
+
## Step 4: Save the Plan
|
|
70
704
|
|
|
71
|
-
|
|
705
|
+
1. Use \`write_file()\` to save the plan to the appropriate department folder in the brain. Name the file clearly (e.g., \`01_RnD/Plan-Step-2.3-Auth-System.md\`).
|
|
706
|
+
2. Use \`update_step(step_id, "in_progress")\` to mark the step as started. Include the task breakdown in the tasks field.
|
|
707
|
+
3. If the plan references any existing brain files, use \`write_file()\` to add wikilinks back to the plan file from those files.
|
|
72
708
|
|
|
73
|
-
##
|
|
709
|
+
## Step 5: Guide Execution
|
|
74
710
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
711
|
+
Ask the user if they want to start executing the plan now. If yes:
|
|
712
|
+
- Start with the first task
|
|
713
|
+
- Work through them sequentially (or suggest parallel execution if tasks are independent)
|
|
714
|
+
- After each task, check it off and move to the next
|
|
715
|
+
|
|
716
|
+
If no, confirm the plan is saved and they can come back to it later.
|
|
79
717
|
`,
|
|
80
718
|
},
|
|
81
719
|
{
|
|
82
720
|
name: 'brain-sprint.md',
|
|
83
|
-
content: `# Sprint Planning
|
|
721
|
+
content: `# Brain Sprint Planning
|
|
722
|
+
|
|
723
|
+
Help the user plan their week's work by organizing unblocked steps into a focused sprint. This brings structured agile-style planning to the brain.
|
|
724
|
+
|
|
725
|
+
## Step 1: Gather Current State
|
|
726
|
+
|
|
727
|
+
1. Use \`list_unblocked_steps()\` to find all steps that are ready to work on.
|
|
728
|
+
2. Use \`get_execution_plan()\` to get full context on each step and the overall plan.
|
|
729
|
+
3. Use \`get_latest_handoff()\` to see where the last session left off and what was recommended.
|
|
730
|
+
4. Use \`list_departments()\` to understand which areas of the brain are active.
|
|
731
|
+
|
|
732
|
+
## Step 2: Analyze and Group
|
|
733
|
+
|
|
734
|
+
For each unblocked step, determine:
|
|
735
|
+
- **Effort estimate**: S (1-2 hours), M (half day), L (full day), XL (multi-day)
|
|
736
|
+
- **Priority**: Critical (blocks many things), High (on the main path), Medium (nice to have), Low (can wait)
|
|
737
|
+
- **Parallel group**: Which steps can run simultaneously without conflicts
|
|
738
|
+
|
|
739
|
+
Group the steps into logical work blocks.
|
|
740
|
+
|
|
741
|
+
## Step 3: Propose the Sprint
|
|
742
|
+
|
|
743
|
+
Present a sprint plan for the week. Format it clearly:
|
|
744
|
+
|
|
745
|
+
\`\`\`
|
|
746
|
+
SPRINT PLAN: Week of [date]
|
|
747
|
+
|
|
748
|
+
Goal: [One sentence describing the sprint objective]
|
|
749
|
+
|
|
750
|
+
Day 1-2: [Theme]
|
|
751
|
+
[ ] Step X.Y: Title (effort: M, priority: Critical)
|
|
752
|
+
[ ] Step X.Z: Title (effort: S, priority: High)
|
|
753
|
+
^ Can run in parallel with X.Y
|
|
754
|
+
|
|
755
|
+
Day 3-4: [Theme]
|
|
756
|
+
[ ] Step A.B: Title (effort: L, priority: High)
|
|
757
|
+
Depends on: Step X.Y completion
|
|
84
758
|
|
|
85
|
-
|
|
759
|
+
Day 5: [Theme / Buffer]
|
|
760
|
+
[ ] Step C.D: Title (effort: S, priority: Medium)
|
|
761
|
+
[ ] Buffer time for overflow or unexpected work
|
|
86
762
|
|
|
87
|
-
|
|
763
|
+
Total effort: ~X steps across N parallel groups
|
|
764
|
+
\`\`\`
|
|
88
765
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
766
|
+
Include:
|
|
767
|
+
- A clear sprint goal (what will be true at the end of the week)
|
|
768
|
+
- Logical grouping by theme or dependency
|
|
769
|
+
- Parallel execution opportunities highlighted
|
|
770
|
+
- Buffer time for unexpected work
|
|
771
|
+
|
|
772
|
+
## Step 4: Confirm and Save
|
|
773
|
+
|
|
774
|
+
Ask the user to review and adjust:
|
|
775
|
+
- "Would you like to add, remove, or reprioritize any steps?"
|
|
776
|
+
- "Is this the right amount of work for the week?"
|
|
777
|
+
|
|
778
|
+
Once confirmed:
|
|
779
|
+
1. Use \`write_file()\` to save the sprint plan to the brain (e.g., \`Execution-Plan-Sprint-[date].md\` or in an appropriate folder).
|
|
780
|
+
2. Summarize the sprint and wish the user a productive week.
|
|
781
|
+
3. Suggest starting with "/brain-plan [first step]" to plan the first task in detail.
|
|
93
782
|
`,
|
|
94
783
|
},
|
|
95
784
|
{
|
|
96
785
|
name: 'brain-sync.md',
|
|
97
|
-
content: `#
|
|
786
|
+
content: `# Brain Sync
|
|
787
|
+
|
|
788
|
+
Audit and synchronize the brain's content to ensure everything is consistent, connected, and up to date. Think of this as a health check for the knowledge graph.
|
|
789
|
+
|
|
790
|
+
## Step 1: Full Inventory
|
|
791
|
+
|
|
792
|
+
1. Use \`list_files()\` to get a complete list of all files in the brain.
|
|
793
|
+
2. Use \`list_departments()\` to see the expected structure.
|
|
794
|
+
3. Use \`get_graph()\` to get the full node and edge map (files and their wikilink connections).
|
|
795
|
+
4. Use \`get_execution_plan()\` to check plan state.
|
|
796
|
+
|
|
797
|
+
## Step 2: Identify Issues
|
|
798
|
+
|
|
799
|
+
Analyze the data to find problems:
|
|
800
|
+
|
|
801
|
+
### Orphan Files
|
|
802
|
+
Files with no incoming or outgoing wikilinks. These are disconnected from the knowledge graph.
|
|
803
|
+
- List each orphan file
|
|
804
|
+
- Suggest which files should link to it
|
|
805
|
+
|
|
806
|
+
### Broken Wikilinks
|
|
807
|
+
Wikilinks that point to files that do not exist.
|
|
808
|
+
- List each broken link and which file contains it
|
|
809
|
+
- Suggest creating the missing file or fixing the link
|
|
810
|
+
|
|
811
|
+
### Empty Departments
|
|
812
|
+
Folders/departments that exist in the structure but have no content files (only an index).
|
|
813
|
+
- List each empty department
|
|
814
|
+
- Suggest whether it should be populated or removed
|
|
815
|
+
|
|
816
|
+
### Stale Content
|
|
817
|
+
Use \`read_file()\` on a sample of files to check if content is outdated:
|
|
818
|
+
- Files that reference steps marked as "not_started" that are actually completed
|
|
819
|
+
- Files with placeholder text ("TODO", "TBD", "Coming soon")
|
|
820
|
+
- Index files that do not reflect the actual files in their folder
|
|
98
821
|
|
|
99
|
-
|
|
822
|
+
### Execution Plan Drift
|
|
823
|
+
Compare the execution plan status with reality:
|
|
824
|
+
- Steps marked "in_progress" that may have been completed (based on handoff history)
|
|
825
|
+
- Steps marked "not_started" that have related content already created
|
|
100
826
|
|
|
101
|
-
##
|
|
827
|
+
## Step 3: Fix Issues
|
|
102
828
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
829
|
+
For each issue found, take action:
|
|
830
|
+
|
|
831
|
+
1. **Orphan files**: Use \`write_file()\` to add wikilinks from relevant files to connect the orphan.
|
|
832
|
+
2. **Broken links**: Use \`write_file()\` to either create the missing target file or fix the link in the source file.
|
|
833
|
+
3. **Empty departments**: Ask the user if they want to seed content or remove the folder.
|
|
834
|
+
4. **Stale content**: Use \`write_file()\` to update outdated files with current information.
|
|
835
|
+
5. **Plan drift**: Use \`update_step()\` to correct any mismatched statuses.
|
|
836
|
+
|
|
837
|
+
Ask before making destructive changes (removing files or departments). Additive changes (adding links, creating missing files) can be done directly.
|
|
838
|
+
|
|
839
|
+
## Step 4: Report
|
|
840
|
+
|
|
841
|
+
Present a sync report:
|
|
842
|
+
|
|
843
|
+
\`\`\`
|
|
844
|
+
BRAIN SYNC REPORT
|
|
845
|
+
|
|
846
|
+
Files scanned: 45
|
|
847
|
+
Issues found: 7
|
|
848
|
+
Issues fixed: 5
|
|
849
|
+
Issues remaining: 2 (need user input)
|
|
850
|
+
|
|
851
|
+
Orphan files: 2 found, 2 linked
|
|
852
|
+
Broken wikilinks: 3 found, 3 fixed
|
|
853
|
+
Empty departments: 1 found (user to decide)
|
|
854
|
+
Stale content: 1 found, 0 fixed (need user input)
|
|
855
|
+
Plan drift: 0 found
|
|
856
|
+
|
|
857
|
+
Graph health: Good
|
|
858
|
+
Nodes: 45 | Edges: 78 | Avg connections: 3.5
|
|
859
|
+
\`\`\`
|
|
860
|
+
|
|
861
|
+
Use \`search_content()\` to verify that key terms (project name, product name, key concepts) are consistent across files.
|
|
107
862
|
`,
|
|
108
863
|
},
|
|
109
864
|
{
|
|
110
865
|
name: 'brain-feature.md',
|
|
111
|
-
content: `#
|
|
866
|
+
content: `# Brain Feature Planning
|
|
867
|
+
|
|
868
|
+
Help the user plan and track a new feature from idea through implementation using the brain as the source of truth.
|
|
869
|
+
|
|
870
|
+
## Step 1: Understand the Feature
|
|
871
|
+
|
|
872
|
+
Ask the user to describe the feature they want to build or add. Get:
|
|
873
|
+
- What it does (user-facing behavior)
|
|
874
|
+
- Why it matters (business/product value)
|
|
875
|
+
- Any technical constraints or preferences
|
|
876
|
+
|
|
877
|
+
If the user gave a description with the command (e.g., "/brain-feature add dark mode"), use that as the starting point and ask clarifying questions only if needed.
|
|
878
|
+
|
|
879
|
+
## Step 2: Research Existing Context
|
|
880
|
+
|
|
881
|
+
Search the brain for anything related:
|
|
882
|
+
|
|
883
|
+
1. Use \`search_content(query)\` with keywords from the feature description to find related files.
|
|
884
|
+
2. Use \`read_file()\` on the top 3-5 results to understand existing context.
|
|
885
|
+
3. Use \`get_execution_plan()\` to see if this feature maps to an existing step or is entirely new.
|
|
886
|
+
4. Use \`get_backlinks()\` on any relevant files to discover connected context.
|
|
887
|
+
|
|
888
|
+
Summarize what you found: "Here is what your brain already knows about this area: [summary]. This feature [overlaps with / is independent of] existing work."
|
|
889
|
+
|
|
890
|
+
## Step 3: Create Feature Spec
|
|
891
|
+
|
|
892
|
+
Use \`write_file()\` to create a feature spec in the appropriate brain folder (e.g., \`02_Product/Features/Feature-Dark-Mode.md\` or \`Ideas/Feature-Trading-Alerts.md\`).
|
|
893
|
+
|
|
894
|
+
The spec should include:
|
|
895
|
+
- **Title**: Feature name
|
|
896
|
+
- **Status**: Planning
|
|
897
|
+
- **Summary**: One paragraph description
|
|
898
|
+
- **Motivation**: Why this feature matters
|
|
899
|
+
- **User Stories**: 2-3 key user stories or use cases
|
|
900
|
+
- **Requirements**: Specific, testable requirements
|
|
901
|
+
- **Technical Approach**: High-level implementation plan
|
|
902
|
+
- **Dependencies**: What this feature depends on
|
|
903
|
+
- **Open Questions**: Anything still unclear
|
|
904
|
+
- **Related Files**: Wikilinks to related brain files
|
|
905
|
+
|
|
906
|
+
## Step 4: Update the Brain
|
|
907
|
+
|
|
908
|
+
1. If the feature maps to an existing execution plan step, use \`update_step()\` to mark it as in_progress.
|
|
909
|
+
2. If it is a new feature not in the plan, ask the user if they want to add it to the execution plan.
|
|
910
|
+
3. Use \`read_file()\` on the relevant department index, then \`write_file()\` to add a wikilink to the new feature spec.
|
|
911
|
+
4. Use \`read_file()\` on BRAIN-INDEX.md, then \`write_file()\` to add the feature to any relevant sections.
|
|
912
|
+
|
|
913
|
+
## Step 5: Guide Implementation
|
|
914
|
+
|
|
915
|
+
Ask the user if they want to start implementing now. If yes:
|
|
916
|
+
|
|
917
|
+
1. Break the feature into implementation tasks (from the spec's technical approach).
|
|
918
|
+
2. Work through each task, using the brain files for reference.
|
|
919
|
+
3. After completing significant parts, use \`write_file()\` to update the feature spec's status and add implementation notes.
|
|
112
920
|
|
|
113
|
-
|
|
921
|
+
If no, confirm the spec is saved and suggest next steps: "The feature spec is saved at [path]. You can come back to it anytime. I would suggest tackling this in your next sprint."
|
|
114
922
|
|
|
115
|
-
##
|
|
923
|
+
## Step 6: Wrap Up
|
|
116
924
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
5. Create handoff using MCP \`create_handoff\`
|
|
925
|
+
When the feature work is done (or paused):
|
|
926
|
+
1. Use \`write_file()\` to update the feature spec with current status and any implementation notes.
|
|
927
|
+
2. If applicable, use \`update_step()\` to update the execution plan.
|
|
928
|
+
3. Use \`create_handoff()\` to log the feature work in the session handoff.
|
|
122
929
|
`,
|
|
123
930
|
},
|
|
124
931
|
];
|
|
@@ -239,7 +1046,7 @@ export async function initCommand(options) {
|
|
|
239
1046
|
console.log();
|
|
240
1047
|
console.log(' Next steps:');
|
|
241
1048
|
console.log(' 1. Open Claude Code in your project directory');
|
|
242
|
-
console.log(' 2. Type /init-
|
|
1049
|
+
console.log(' 2. Type /init-brain to create your brain');
|
|
243
1050
|
console.log(' 3. Start building with AI-powered project management');
|
|
244
1051
|
console.log();
|
|
245
1052
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACL,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,GAEhB,MAAM,cAAc,CAAC;AAEtB,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,eAAe,GAAG,qDAAqD,CAAC;AAE9E,2DAA2D;AAC3D,MAAM,cAAc,GAAG;IACrB;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE
|
|
1
|
+
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}
|