-
-
Notifications
You must be signed in to change notification settings - Fork 1.6k
feat(skills): add BrainDump skill to Thinking category #877
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,94 @@ | ||
| --- | ||
| name: BrainDump | ||
| description: Structured thought and emotion processing — receive raw thoughts, match against TELOS patterns, structure into MEMORY. USE WHEN brain dump, unload thoughts, process emotions, decompress, vent, think out loud, end of day, debrief, what happened today, need to talk. | ||
| --- | ||
|
|
||
| ## Customization | ||
|
|
||
| **Before executing, check for user customizations at:** | ||
| `~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/BrainDump/` | ||
|
|
||
| If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults. | ||
|
|
||
|
|
||
| ## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION) | ||
|
|
||
| **You MUST send this notification BEFORE doing anything else when this skill is invoked.** | ||
|
|
||
| 1. **Send voice notification**: | ||
| ```bash | ||
| curl -s -X POST http://localhost:8888/notify \ | ||
| -H "Content-Type: application/json" \ | ||
| -d '{"message": "Running the WORKFLOWNAME workflow in the BrainDump skill to ACTION"}' \ | ||
| > /dev/null 2>&1 & | ||
| ``` | ||
|
|
||
| 2. **Output text notification**: | ||
| ``` | ||
| Running the **WorkflowName** workflow in the **BrainDump** skill to ACTION... | ||
| ``` | ||
|
|
||
| **This is not optional. Execute this curl command immediately upon skill invocation.** | ||
|
|
||
| # BrainDump Skill | ||
|
|
||
| Structured processing of thoughts, emotions, and experiences. Turns raw, unstructured input into pattern-matched, structured content connected to {PRINCIPAL.NAME}'s TELOS system. The skill listens first, reflects patterns back, then structures and stores. | ||
|
|
||
|
|
||
| ## Workflow Routing | ||
|
|
||
| Route to the appropriate workflow based on the request. | ||
|
|
||
| **When executing a workflow, output this notification directly:** | ||
|
|
||
| ``` | ||
| Running the **WorkflowName** workflow in the **BrainDump** skill to ACTION... | ||
| ``` | ||
|
|
||
| | Trigger | Workflow | | ||
| |---------|----------| | ||
| | Full structured dump (all 5 phases: receive → pattern match → structure → validate → cross-reference) | `Workflows/FullDump.md` | | ||
| | Quick capture (just receive and structure, skip pattern matching) | `Workflows/QuickDump.md` | | ||
| | Analyze existing content against TELOS patterns | `Workflows/PatternMatch.md` | | ||
|
|
||
| ## Quick Reference | ||
|
|
||
| | Workflow | Purpose | Phases | Output | | ||
| |----------|---------|--------|--------| | ||
| | **FullDump** | Complete thought processing | 5 | Structured content + pattern analysis + MEMORY update | | ||
| | **QuickDump** | Rapid capture | 2 | Structured content in MEMORY | | ||
| | **PatternMatch** | Pattern analysis only | 1 | Pattern connections to TELOS | | ||
|
|
||
| ## Examples | ||
|
|
||
| ``` | ||
| "I need to unload what's on my mind" | ||
| -> Invokes FullDump workflow -> 5-phase processing | ||
|
|
||
| "Quick dump: had a weird interaction at work today" | ||
| -> Invokes QuickDump workflow -> Rapid capture | ||
|
|
||
| "Look at what I wrote yesterday and find patterns" | ||
| -> Invokes PatternMatch workflow -> TELOS pattern analysis | ||
| ``` | ||
|
|
||
| ## Integration | ||
|
|
||
| **Works well with:** | ||
| - **Telos** — Pattern matching reads from `~/.claude/PAI/USER/TELOS/` (BELIEFS, CHALLENGES, GOALS, LEARNED, NARRATIVES, TRAUMAS, WRONG) | ||
| - **FocusAlignment** — If dump touches goals/direction, suggest running alignment check | ||
| - **Research** — If dump reveals knowledge gaps, suggest research | ||
|
|
||
| ## Principles | ||
|
|
||
| 1. **Dump first, structure later** — don't impose structure on the dump itself | ||
| 2. **Patterns are tools, not labels** — use them to help see connections, not to categorize | ||
| 3. **Corrections are expected** — memory is imperfect, especially emotional memory | ||
| 4. **Their voice, not yours** — structured output should sound like {PRINCIPAL.NAME} wrote it | ||
| 5. **Direct over diplomatic** — if you see something concerning, say it | ||
| 6. **Not everything is a pattern** — sometimes a bad day is just a bad day | ||
| 7. **Ask before writing elsewhere** — MEMORY is fair game, other files need permission | ||
|
|
||
| --- | ||
|
|
||
| **Last Updated:** 2026-03-02 |
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,91 @@ | ||||||
| # FullDump Workflow | ||||||
|
|
||||||
| Full 5-phase structured processing of thoughts, emotions, and experiences. | ||||||
|
|
||||||
| ## Phase 1: Receive (Listen Mode) | ||||||
|
|
||||||
| Let {PRINCIPAL.NAME} talk. Don't interrupt with analysis yet. Capture everything. | ||||||
|
|
||||||
| **Your job:** | ||||||
| - Listen to the full dump without structuring prematurely | ||||||
| - Note key themes, people mentioned, emotions expressed | ||||||
| - Identify factual details that need clarifying (dates, names, what actually happened vs. interpretation) | ||||||
|
|
||||||
| **Ask only clarifying questions about facts**, not feelings. Don't psychoanalyze mid-dump. One question at a time. Let them finish before switching to Phase 2. | ||||||
|
|
||||||
| **Language:** {PRINCIPAL.NAME} may dump in any language or a mix. Process in whatever language the input comes in. | ||||||
|
|
||||||
| ## Phase 2: Pattern Match (Reflect Back) | ||||||
|
|
||||||
| After the dump is complete: | ||||||
|
|
||||||
| 1. **Read TELOS files** from `~/.claude/PAI/USER/TELOS/` — focus on: | ||||||
| - `CHALLENGES.md` — current struggles | ||||||
| - `LEARNED.md` — lessons learned | ||||||
| - `WRONG.md` — past mistakes | ||||||
| - `TRAUMAS.md` — past experiences | ||||||
| - `NARRATIVES.md` — self-stories | ||||||
| - `BELIEFS.md` — core beliefs | ||||||
| - `GOALS.md` — what they're working toward | ||||||
|
|
||||||
| 2. **Name the patterns you see** — explicitly, with references: | ||||||
| - "This connects to your challenge around [X from CHALLENGES.md]" | ||||||
| - "I see a link between this and what you learned about [Y from LEARNED.md]" | ||||||
| - Connect dots across different TELOS areas | ||||||
|
|
||||||
| 3. **Share your honest read** of the situation — what you think is actually going on beneath the surface | ||||||
|
|
||||||
| 4. **Ask {PRINCIPAL.NAME} to validate:** "Does this land? What am I missing?" | ||||||
|
|
||||||
| **Rules for pattern matching:** | ||||||
| - Be direct. Don't coddle. | ||||||
| - Connect dots they might not see | ||||||
| - If you think they're rationalizing, say so | ||||||
| - If something doesn't match a documented pattern, say that too | ||||||
| - If you see a NEW pattern worth documenting, flag it | ||||||
|
|
||||||
| ## Phase 3: Structure & Write | ||||||
|
|
||||||
| Write structured output to `~/.claude/MEMORY/`. | ||||||
|
||||||
| Write structured output to `~/.claude/MEMORY/`. | |
| Write structured output to a new markdown file under `~/.claude/MEMORY/FullDump/`, using a timestamped filename (for example: `~/.claude/MEMORY/FullDump/YYYYMMDD-HHMMSS.md`). |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,37 @@ | ||
| # PatternMatch Workflow | ||
|
|
||
| Isolated Phase 2 — analyze existing content against TELOS patterns. Use when {PRINCIPAL.NAME} wants to find connections in things already written, not process new thoughts. | ||
|
|
||
|
Comment on lines
+1
to
+4
|
||
| ## Input | ||
|
|
||
| Ask what content to analyze: | ||
| - Recent MEMORY entries | ||
| - A specific piece of writing | ||
| - A conversation or interaction they want examined | ||
|
|
||
| ## Process | ||
|
|
||
| 1. **Read the content** to be analyzed | ||
|
|
||
| 2. **Load TELOS context** from `~/.claude/PAI/USER/TELOS/`: | ||
| - CHALLENGES.md, LEARNED.md, WRONG.md, TRAUMAS.md | ||
| - NARRATIVES.md, BELIEFS.md, GOALS.md | ||
|
|
||
| 3. **Find connections:** | ||
| - What TELOS patterns appear in this content? | ||
| - Are there contradictions between stated beliefs and actions? | ||
| - Do any challenges or goals get reinforced or challenged? | ||
| - Are there new patterns not yet in TELOS? | ||
|
|
||
| 4. **Present findings:** | ||
| - Named patterns with TELOS file references | ||
| - Connections across different TELOS areas | ||
| - Honest assessment of what's beneath the surface | ||
| - Any new patterns worth adding to TELOS | ||
|
|
||
| ## Output | ||
|
|
||
| Structured analysis with: | ||
| - Pattern connections (referenced to specific TELOS files) | ||
| - Cross-cutting themes | ||
| - Recommended TELOS updates (if any — always ask before making changes) | ||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,20 @@ | ||||||
| # QuickDump Workflow | ||||||
|
|
||||||
| Rapid capture — Phase 1 (Receive) + Phase 3 (Structure) only. Skip pattern matching for when {PRINCIPAL.NAME} just needs to get thoughts out quickly. | ||||||
|
|
||||||
|
Comment on lines
+1
to
+4
|
||||||
| ## Phase 1: Receive | ||||||
|
|
||||||
| Let {PRINCIPAL.NAME} talk. Capture everything without analysis. | ||||||
|
|
||||||
| - Note key themes and emotions | ||||||
| - Ask minimal clarifying questions (facts only) | ||||||
| - Don't pattern match or reflect back | ||||||
|
|
||||||
| ## Phase 3: Structure & Write | ||||||
|
|
||||||
| Write directly to `~/.claude/MEMORY/`. | ||||||
|
||||||
| Write directly to `~/.claude/MEMORY/`. | |
| Write directly to `~/.claude/MEMORY/quickdump-{YYYYMMDD-HHMMSS}.md` (create if it doesn't exist). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This workflow file doesn’t include the standard per-workflow Voice Notification block (curl + matching ‘Running X in Skill…’ line) that other workflows include. Adding it makes the ACTION text explicit and keeps workflow execution UX consistent across the skills system.