[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CD1C9R186HXQWMDDM7KG0A":3,"skill-same:01M6CD1C9R186HXQWMDDM7KG0A":206},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":33,"linkOnly":34,"markdownContent":35,"markdownBody":36,"frontMatter":37,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":14,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":51,"install":52,"resources":65},"01M6CD1C9R186HXQWMDDM7KG0A","memory",null,"Memory system for AI agents. Tier 1 Semantic (Brain MCP search). Tier 2-3 (Episodic\u002FCausal) planned for future phases. Enables memory-first architecture.","loriensleafs\u002Fbrain","loriensleafs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F315385?v=4","01M6CCYZETMCJPTHNS258YRCBC","Peter Kloss","01M6CCYZK25T8516A39S9PCJT7",0,"MIT","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[5,24,25,26,27,28,29,30,31,32],"MCP","ai agents","architecture","search","first","system","adr","v0","AI-agents","2026-11-10 10:12:30",false,"---\nname: memory\nversion: 0.1.0\ndescription: Memory system for AI agents. Tier 1 Semantic (Brain MCP search). Tier 2-3\n  (Episodic\u002FCausal) planned for future phases. Enables memory-first architecture.\nlicense: MIT\nmodel: claude-sonnet-4-5\nmetadata:\n  adr: [ADR-007, ADR-020]\n  reference: ai-agents memory skill v0.2.0\n  brain_version: 0.1.0\n  timelessness: 8\u002F10\n---\n\n# Memory System Skill\n\nMemory operations for AI agents using Brain MCP.\n\n---\n\n## Quick Start\n\n```typescript\n\u002F\u002F Tier 1: Search memory (Semantic)\nmcp__plugin_brain_brain__search({\n  query: \"git hooks\",\n  limit: 10,\n  mode: \"auto\",\n});\n\n\u002F\u002F Tier 1: List available memories\nmcp__plugin_brain_brain__list_directory({\n  dir_name: \"\u002F\",\n  depth: 2,\n});\n\n\u002F\u002F Tier 1: Read specific memory\nmcp__plugin_brain_brain__read_note({\n  identifier: \"usage-mandatory\",\n});\n```\n\n```bash\n# Tier 2: Extract episode from session (Episodic)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fextract-episode.ts \\\n  --session SESSION-2026-01-20_06\n\n# Tier 3: Add pattern (Causal)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fadd-pattern.ts \\\n  --name \"Memory-First Investigation\" \\\n  --trigger \"Agent wants to change existing system\" \\\n  --action \"Search memory before making changes\" \\\n  --success-rate 0.95\n```\n\n---\n\n## Memory-First as Chesterton's Fence\n\n**Core Insight**: Memory-first architecture implements Chesterton's Fence principle for AI agents.\n\n> \"Do not remove a fence until you know why it was put up\" - G.K. Chesterton\n\n**Translation for agents**: Do not change code\u002Farchitecture\u002Fprotocol until you search memory for why it exists.\n\n### Why This Matters\n\n**Without memory search** (removing fence without investigation):\n\n- Agent encounters complex code, thinks \"this is ugly, I'll refactor it\"\n- Removes validation logic that prevents edge case\n- Production incident occurs\n- Memory contains past incident that explains why validation existed\n\n**With memory search** (Chesterton's Fence investigation):\n\n- Agent encounters complex code\n- Searches memory: `mcp__plugin_brain_brain__search({ query: \"validation logic edge case\" })`\n- Finds past incident explaining why code exists\n- Makes informed decision: preserve, modify, or replace with equivalent safety\n\n### Investigation Protocol\n\nWhen you encounter something you want to change:\n\n| Change Type           | Memory Search Required                                                |\n| --------------------- | --------------------------------------------------------------------- |\n| Remove ADR constraint | `mcp__plugin_brain_brain__search({ query: \"[constraint name]\" })`     |\n| Bypass protocol       | `mcp__plugin_brain_brain__search({ query: \"[protocol name] why\" })`   |\n| Delete >100 lines     | `mcp__plugin_brain_brain__search({ query: \"[component] purpose\" })`   |\n| Refactor complex code | `mcp__plugin_brain_brain__search({ query: \"[component] edge case\" })` |\n| Change workflow       | `mcp__plugin_brain_brain__search({ query: \"[workflow] rationale\" })`  |\n\n### What Memory Contains (Git Archaeology)\n\n**Tier 1 (Semantic)**: Facts, patterns, constraints\n\n- Why does PowerShell-only constraint exist? (ADR-005)\n- Why do skills exist instead of raw CLI? (usage-mandatory)\n- What incidents led to BLOCKING gates? (protocol-blocking-gates)\n\n**Tier 2 (Episodic)**: Past session outcomes [FUTURE]\n\n- What happened when we tried approach X? (session replay)\n- What edge cases did we encounter? (failure episodes)\n\n**Tier 3 (Causal)**: Decision patterns [FUTURE]\n\n- What decisions led to success? (causal paths)\n- What patterns should we repeat\u002Favoid? (success\u002Ffailure patterns)\n\n### Memory-First Gate (BLOCKING)\n\n**Before changing existing systems, you MUST**:\n\n1. `mcp__plugin_brain_brain__search({ query: \"[topic]\" })`\n2. Review results for historical context\n3. If insufficient, document gap (Tiers 2-3 not yet available)\n4. Document findings in decision rationale\n5. Only then proceed with change\n\n**Why BLOCKING**: \u003C50% compliance with \"check memory first\" guidance. Making it BLOCKING achieves 100% compliance (same pattern as session protocol gates).\n\n**Verification**: Session logs must show memory search BEFORE decisions, not after.\n\n### Connection to Chesterton's Fence Analysis\n\nSee ADR-007 for:\n\n- Memory-first architecture principles\n- Investigation protocol\n- Verification requirements\n- BLOCKING gate enforcement\n\n**Key takeaway**: Memory IS your investigation tool. It contains the \"why\" that Chesterton's Fence requires you to discover.\n\n---\n\n## Triggers\n\n| Trigger Phrase                 | Maps To                                                                                       |\n| ------------------------------ | --------------------------------------------------------------------------------------------- |\n| \"search memory for X\"          | Tier 1: `mcp__plugin_brain_brain__search()`                                                   |\n| \"what do we know about X\"      | Tier 1: `mcp__plugin_brain_brain__search()`                                                   |\n| \"list memories\"                | Tier 1: `mcp__plugin_brain_brain__list_directory()`                                           |\n| \"read memory X\"                | Tier 1: `mcp__plugin_brain_brain__read_note()`                                                |\n| \"extract episode from session\" | Tier 2: `bun run scripts\u002Fextract-episode.ts --session SESSION-X`                              |\n| \"what happened in session X\"   | Tier 2: `mcp__plugin_brain_brain__read_note({ identifier: \"EPISODE-X\" })`                     |\n| \"find sessions with failures\"  | Tier 2: `mcp__plugin_brain_brain__search({ query: \"outcome:failure\", folder: \"episodes\" })`   |\n| \"add pattern\"                  | Tier 3: `bun run scripts\u002Fadd-pattern.ts --name \"...\" --trigger \"...\"`                         |\n| \"what patterns led to success\" | Tier 3: `mcp__plugin_brain_brain__search({ query: \"success_rate:>0.7\", folder: \"patterns\" })` |\n\n---\n\n## Quick Reference\n\n| Operation             | Tool                                      | Key Parameters                                      |\n| --------------------- | ----------------------------------------- | --------------------------------------------------- |\n| Search facts\u002Fpatterns | `mcp__plugin_brain_brain__search`         | `query`, `mode`, `limit`, `depth`, `folder`         |\n| List memories         | `mcp__plugin_brain_brain__list_directory` | `dir_name`, `depth`                                 |\n| Read memory           | `mcp__plugin_brain_brain__read_note`      | `identifier`                                        |\n| Write memory          | `mcp__plugin_brain_brain__write_note`     | `title`, `content`, `folder`                        |\n| Edit memory           | `mcp__plugin_brain_brain__edit_note`      | `identifier`, `operation`, `content`                |\n| Extract episode       | `bun run scripts\u002Fextract-episode.ts`      | `--session SESSION-ID`, `--force`                   |\n| Query episodes        | `mcp__plugin_brain_brain__search`         | `query`, `folder: \"episodes\"`                       |\n| Read episode          | `mcp__plugin_brain_brain__read_note`      | `identifier: \"EPISODE-{id}\"`                        |\n| Add pattern           | `bun run scripts\u002Fadd-pattern.ts`          | `--name`, `--trigger`, `--action`, `--success-rate` |\n| Query patterns        | `mcp__plugin_brain_brain__search`         | `query`, `folder: \"patterns\"`                       |\n| Get antipatterns      | `mcp__plugin_brain_brain__search`         | `query: \"success_rate:\u003C0.3\"`                        |\n\n### Retrieval Depth Strategy\n\nUse `depth` parameter to expand context via relations:\n\n| Depth | Behavior                                 | Use When                          |\n| ----- | ---------------------------------------- | --------------------------------- |\n| 0     | Direct matches only                      | Targeted lookup                   |\n| 1     | Include notes linked via relations       | Standard retrieval (recommended)  |\n| 2     | Include second-level connections (2 hop) | Exploring related decisions       |\n| 3     | Maximum depth (3 hop)                    | Deep investigation, impact analysis |\n\n---\n\n```text\nWhat do you need?\n│\n├─► Current facts, patterns, or rules?\n│   └─► TIER 1: mcp__plugin_brain_brain__search()\n│\n├─► List available memories?\n│   └─► TIER 1: mcp__plugin_brain_brain__list_directory()\n│\n├─► Read specific memory?\n│   └─► TIER 1: mcp__plugin_brain_brain__read_note()\n│\n├─► What happened in a specific session?\n│   ├─ Extract first: bun run scripts\u002Fextract-episode.ts [log-path]\n│   └─► TIER 2: mcp__plugin_brain_brain__read_note({ identifier: \"EPISODE-X\" })\n│\n├─► Recent sessions with specific outcome?\n│   └─► TIER 2: mcp__plugin_brain_brain__search({ query: \"outcome:failure\" })\n│\n├─► Why did decision X lead to outcome Y?\n│   └─► TIER 3: Search related patterns, trace WikiLink relations\n│\n├─► What patterns have high success rate?\n│   └─► TIER 3: mcp__plugin_brain_brain__search({ query: \"success_rate:>0.7\" })\n│\n├─► Need to store new knowledge?\n│   ├─ Session complete? → bun run scripts\u002Fextract-episode.ts\n│   ├─ Pattern discovered? → bun run scripts\u002Fadd-pattern.ts\n│   └─ Factual knowledge? → mcp__plugin_brain_brain__write_note()\n│\n└─► Not sure which tier?\n    └─► Start with TIER 1 (search), escalate to Tier 2\u002F3 if insufficient\n```\n\n---\n\n## Anti-Patterns\n\n| Anti-Pattern                     | Do This Instead                                        |\n| -------------------------------- | ------------------------------------------------------ |\n| Skipping memory search           | Always search before multi-step reasoning              |\n| Using old Serena\u002FForgetful tools | Use Brain MCP tools (`mcp__plugin_brain_brain__*`)     |\n| Expecting Tier 2-3 features      | Document needs, these are planned for future           |\n| Not documenting memory gaps      | When memory lacks info, note it for future enhancement |\n| Skipping pre-flight validation   | ALWAYS complete validation checklist before writes     |\n| Writing to wrong folder          | Check entity type to folder mapping                    |\n| Missing CAPS prefix in filename  | Follow pattern: `{PREFIX}-{NNN}-{topic}.md`            |\n| Fewer than 3 observations        | Add more facts\u002Fdecisions with categories               |\n| No relations section             | Add 2+ wikilinks to related entities                   |\n| Generic NOTE-\\* entity type      | Choose specific entity type (13 valid types)           |\n\n---\n\n## Storage Locations\n\n> **Configuration**: Memory paths configured in `~\u002F.config\u002Fbrain\u002Fconfig.json` (see ADR-020).\n\n| Mode    | Example Path               | Pattern Explanation                        |\n| ------- | -------------------------- | ------------------------------------------ |\n| DEFAULT | ~\u002Fmemories\u002Fbrain\u002Fepisodes\u002F | {memories_location}\u002F{project}\u002Fepisodes\u002F    |\n| CODE    | ~\u002FDev\u002Fbrain\u002Fdocs\u002Fepisodes\u002F | {code_path}\u002Fdocs\u002Fepisodes\u002F (no \u002F{project}) |\n| CUSTOM  | \u002Fcustom\u002Fpath\u002Fepisodes\u002F     | {memories_path}\u002Fepisodes\u002F (no \u002F{project})  |\n\nNote: `memories_location` defaults to `~\u002Fmemories` but is configurable via `brain config set memories-location \u003Cpath>`.\n\n| Data           | Location                                |\n| -------------- | --------------------------------------- |\n| Brain config   | `~\u002F.config\u002Fbrain\u002Fconfig.json`           |\n| Brain memories | `{resolved_path}\u002F` (see modes above)    |\n| Episodes       | `{resolved_path}\u002Fepisodes\u002FEPISODE-*.md` |\n| Patterns       | `{resolved_path}\u002Fpatterns\u002FPATTERN-*.md` |\n| Sessions       | `{resolved_path}\u002Fsessions\u002FSESSION-*.md` |\n| Governance     | `{resolved_path}\u002Fgovernance\u002F`           |\n\n**Notes**:\n\n- Brain MCP tools handle path resolution automatically. Do not use hardcoded paths in agent instructions.\n- The `memories_location` default is `~\u002Fmemories` but can be configured per-project or globally.\n- ADR-020 defines three modes: DEFAULT, CODE, CUSTOM (see table above).\n\n---\n\n## Verification\n\n| Operation         | Verification                                       |\n| ----------------- | -------------------------------------------------- |\n| Search completed  | Result count > 0 OR logged \"no results\"            |\n| Memory read       | Note content returned                              |\n| Memory written    | Confirmation with permalink                        |\n| Episode extracted | Markdown file created in `episodes\u002F` folder        |\n| Pattern added     | Markdown file created in `patterns\u002F` folder        |\n| Pattern updated   | Success rate recalculated, occurrences incremented |\n\n---\n\n## Related Skills\n\n| Skill                       | When to Use Instead                      |\n| --------------------------- | ---------------------------------------- |\n| `curating-memories`         | Memory maintenance (if available)        |\n| `exploring-knowledge-graph` | Multi-hop graph traversal (if available) |\n\n---\n\n## Write Operations Governance (BLOCKING)\n\n> **References**:\n>\n> - ADR-019: Memory Operations Governance (validation-based governance)\n> - ADR-020: Configuration Architecture Refactoring (storage locations, terminology)\n\n**All agents MAY write to Brain memory using this skill.**\n\nThe agent system uses one-level delegation. Subagents cannot delegate to other subagents. When orchestrator delegates to analyst, analyst must be able to write directly. Governance is achieved through pre-flight validation, not access control.\n\n**Non-compliant writes create governance debt**:\n\n- Notes in wrong folders\n- Inconsistent naming (missing CAPS prefix)\n- Missing quality thresholds\n- Broken knowledge graph relations\n\n### All Agents Can Write (with Validation)\n\n| Agent          | write_note | edit_note | Requirement                         |\n| -------------- | ---------- | --------- | ----------------------------------- |\n| **All agents** | **Yes**    | **Yes**   | MUST complete pre-flight validation |\n\n**No delegation required.** All agents write directly after completing validation.\n\n### Pre-Flight Validation (BLOCKING - All Agents)\n\nBefore calling `write_note` or `edit_note`, you MUST complete this checklist:\n\n```markdown\n### Pre-Flight Checklist (MUST all pass before write)\n\n- [ ] Entity type is valid (13 types only, see table below)\n- [ ] Folder matches entity type (see mapping)\n- [ ] File name follows CAPS prefix pattern\n- [ ] Frontmatter has: title, type, tags (2-5)\n- [ ] Observations section: 3-10 entries with categories\n- [ ] Observation format: `- [category] content #tags`\n- [ ] Relations section: 2-8 entries with wikilinks\n- [ ] Relation format: `- relation_type [[Target Entity]]`\n```\n\n**Agents that skip validation create governance debt.** Post-hoc audit will detect violations.\n\n### Entity Type to Folder Mapping (Canonical)\n\n**File names MUST match the File Pattern exactly.** The entity prefix MUST be ALL CAPS — `ADR-`, `SESSION-`, `REQ-`, etc. Never lowercase (`adr-`, `session-`, `req-`). This is non-negotiable; lowercase prefixes are malformed and will break lookups.\n\n| Entity Type   | Folder                                          | File Pattern                       |\n| :------------ | :---------------------------------------------- | :--------------------------------- |\n| decision      | decisions\u002F                                      | `ADR-{NNN}-{topic}.md`             |\n| session       | sessions\u002F                                       | `SESSION-YYYY-MM-DD_NN-{topic}.md` |\n| feature       | features\u002FFEAT-{NNN}-{name}\u002F                     | `FEAT-{NNN}-{name}.md`             |\n| requirement   | features\u002FFEAT-{NNN}-{name}\u002Frequirements\u002F        | `REQ-{NNN}-{topic}.md`             |\n| design        | features\u002FFEAT-{NNN}-{name}\u002Fdesign\u002F              | `DESIGN-{NNN}-{topic}.md`          |\n| task          | features\u002FFEAT-{NNN}-{name}\u002Ftasks\u002F               | `TASK-{NNN}-{topic}.md`            |\n| analysis      | analysis\u002F                                       | `ANALYSIS-{NNN}-{topic}.md`        |\n| epic          | roadmap\u002F                                        | `EPIC-{NNN}-{name}.md`             |\n| critique      | critique\u002F                                       | `CRIT-{NNN}-{topic}.md`            |\n| test-report   | qa\u002F                                             | `QA-{NNN}-{topic}.md`              |\n| security      | security\u002F                                       | `SEC-{NNN}-{component}.md`         |\n| retrospective | retrospective\u002F                                  | `RETRO-YYYY-MM-DD_{topic}.md`      |\n| skill         | skills\u002F                                         | `SKILL-{NNN}-{topic}.md`           |\n\n**No generic `NOTE-*` type allowed.** Forces proper categorization.\n\n**Feature folder naming** (per [[ADR-001-feature-workflow]]): `FEAT-{NNN}-{name}` uses kebab-case name, max 50 characters, validated by `FEAT-\\d{3}-[a-z0-9-]+`. Examples:\n\n- `features\u002FFEAT-001-feature-workflow\u002FFEAT-001-feature-workflow.md`\n- `features\u002FFEAT-001-feature-workflow\u002Frequirements\u002FREQ-001-agent-prompts.md`\n- `features\u002FFEAT-001-feature-workflow\u002Fdesign\u002FDESIGN-001-implementation-plan.md`\n- `features\u002FFEAT-001-feature-workflow\u002Ftasks\u002FTASK-001-create-templates.md`\n\n### Valid Observation Categories\n\n```text\n[fact], [decision], [requirement], [technique], [insight],\n[problem], [solution], [constraint], [risk], [outcome]\n```\n\n### Source Attribution in Observations\n\nEvery observation should include provenance. Three methods:\n\n**Context in observation** — source in parentheses:\n\n```markdown\n- [decision] Using JWT tokens (decided in ADR-005) #auth\n- [fact] Rate limit is 1000\u002Fhour (per API Documentation) #api\n```\n\n**Wikilink to source** — link to related entity:\n\n```markdown\n- [decision] Using JWT tokens #auth\n  - requires [[ADR-005 Auth Token Strategy]]\n```\n\n**Tags for agent source** — indicate which agent created observation:\n\n```markdown\n- [insight] Auth failures spike at token expiry #pattern #analyst\n```\n\n### Valid Relation Types\n\n```text\nimplements, depends_on, relates_to, extends, part_of,\ninspired_by, contains, pairs_with, supersedes, leads_to, caused_by\n```\n\n### Quality Thresholds\n\n| Element      | Min | Max | Example                        |\n| ------------ | --- | --- | ------------------------------ |\n| Observations | 3   | 10  | `- [decision] Using JWT #auth` |\n| Relations    | 2   | 8   | `- implements [[REQ-001]]`     |\n| Tags         | 2   | 5   | `tags: [auth, security]`       |\n\n### Example: Compliant Note Structure\n\nThe frontmatter title prefix MUST be ALL CAPS (`ADR-019`, not `adr-019`). Wikilink references MUST match the canonical title casing.\n\n```markdown\n---\ntitle: ADR-019 Memory Governance\ntype: decision\ntags: [memory, governance, enforcement]\n---\n\n# ADR-019 Memory Governance\n\n## Context\n\nAgents writing to memory without conventions create governance debt.\n\n## Observations\n\n- [decision] Validation-based governance selected #architecture\n- [fact] All agents retain direct write access #one-level-delegation\n- [requirement] Pre-flight validation MUST pass before writes #blocking\n- [technique] Memory skill provides validation guidance (not access control) #pattern\n\n## Relations\n\n- supersedes [[Ad-hoc Memory Writing]]\n- implements [[ADR-007 Memory-First Architecture]]\n- relates_to [[Session 06 Entity Standards]]\n```\n\n### Write Operation Decision Tree\n\n```text\nNeed to write\u002Fedit a memory note?\n│\n├─► Run pre-flight validation checklist\n│   │\n│   ├─► All checks PASS: Proceed with write_note\u002Fedit_note\n│   │\n│   └─► Any check FAILS: Fix violations before writing\n│       │\n│       ├─► Wrong folder? Check entity type mapping\n│       ├─► Missing CAPS prefix? Follow naming pattern\n│       ├─► Too few observations? Add more facts\u002Fdecisions\n│       └─► No relations? Add 2+ wikilinks\n│\n├─► Unsure about conventions?\n│   │\n│   └─► Consult this skill for entity type mapping, naming patterns, examples\n│\n└─► Read\u002Fsearch operations: Always allowed directly (no validation needed)\n```\n\n**All agents write directly.** No delegation to memory agent required.\n\n---\n\n## Storage Protocol\n\n### When to Store\n\nStore frequently. Autocompaction, crashes, and session interruptions lose context. Incremental updates prevent information loss.\n\n| Trigger                    | Action                                        |\n| -------------------------- | --------------------------------------------- |\n| Significant insight\u002Fdecision | Write or update immediately                 |\n| Every back-and-forth exchange | Don't wait for milestones                  |\n| During research\u002Fanalysis   | Update incrementally, not one batch at end    |\n| Before risky operations    | Store before compaction or long-running tasks |\n| Session end                | Final sync                                    |\n\n**Anti-pattern**: Large research task then single update at end.\n**Correct pattern**: Update note after each finding during research.\n\n### Create vs Update Decision\n\n| Condition                              | Action                                 |\n| -------------------------------------- | -------------------------------------- |\n| Existing note covers this topic        | Update with `edit_note`                |\n| Distinct atomic unit, no coverage      | Create new with `write_note`           |\n| Related folder exists                  | Create in appropriate folder           |\n| No related folder                      | Create in closest related folder       |\n\n**Always search before creating** to prevent duplicates.\n\n### Curation Operations\n\nTreat memories as living documents. Refine, reorganize, clarify continuously.\n\n**Append** — add new observations, relations, or context:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"append\"\ncontent: \"- [decision] Made choice X based on constraint Y #topic\"\n```\n\n**Prepend** — add critical updates at top for visibility:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"prepend\"\ncontent: \"- [problem] Critical issue discovered: Z #urgent\"\n```\n\n**Find\u002FReplace** — refine existing observations as understanding evolves:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"find_replace\"\nfind_text: \"- [idea] Might use approach A\"\ncontent: \"- [decision] Decided on approach A after testing B #validated\"\n```\n\n**Replace Section** — update entire sections when context changes:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"replace_section\"\nsection: \"Context\"\ncontent: \"## Context\\n[Updated context with new information]\"\n```\n\n---\n\n## Freshness Protocol\n\n### Update Triggers\n\nUpdate parent memory entities when downstream refinements occur:\n\n| Event                    | Action                                | Example                        |\n| ------------------------ | ------------------------------------- | ------------------------------ |\n| Epic refined             | Update `EPIC-*` entity with new scope | Scope narrowed during planning |\n| PRD completed            | Add observation linking to PRD        | PRD created from epic          |\n| Tasks decomposed         | Update with task count and coverage   | 15 tasks generated             |\n| Implementation started   | Add progress observations             | Sprint 1 started               |\n| Milestone completed      | Update with outcome                   | Auth feature shipped           |\n| Decision changed         | Supersede old observation             | ADR-005 supersedes ADR-003     |\n\n### Staleness Detection\n\nObservations older than 30 days without updates should be reviewed:\n\n1. **Mark for review**: Add `[REVIEW]` tag if uncertain about accuracy\n2. **Supersede if outdated**: Create new observation with `supersedes` relation\n3. **Archive if irrelevant**: Move to archive folder or delete note\n\n### Conflict Resolution\n\nWhen observations contradict:\n\n1. Prefer most recent observation\n2. Create relation with type `supersedes`\n3. Add `[REVIEW]` tag if uncertain\n\n---\n\n## Session Log Creation\n\nSession logs are stored in Brain memory under `sessions\u002F` folder.\n\n```text\nmcp__plugin_brain_brain__write_note\ntitle: \"SESSION-YYYY-MM-DD_NN-topic\"\nfolder: \"sessions\"\ncontent: \"[Session log template content]\"\n```\n\n**Session Log Template**:\n\n```markdown\n---\ntitle: SESSION-YYYY-MM-DD_NN-topic\ntype: session\ntags: [session, YYYY-MM-DD]\n---\n\n# Session NN - YYYY-MM-DD\n\n## Session Info\n\n- **Date**: YYYY-MM-DD\n- **Branch**: [branch name]\n- **Starting Commit**: [SHA]\n- **Objective**: [What this session aims to accomplish]\n\n## Protocol Compliance\n\n[Session start checklist here]\n\n## Work Log\n\n### [Task\u002FTopic]\n\n**Status**: In Progress \u002F Complete \u002F Blocked\n\n**What was done**:\n- [Action taken]\n\n**Decisions made**:\n- [Decision]: [Rationale]\n\n## Relations\n\n- part_of [[Current Project]]\n- leads_to [[Next Session Topic]]\n```\n\n---\n\n## Governance Access\n\nProject governance documents are stored in Brain memory under `governance\u002F` folder:\n\n| Document            | Identifier             | Access Pattern                                                        |\n| ------------------- | ---------------------- | --------------------------------------------------------------------- |\n| Project Handoff     | `handoff`              | `mcp__plugin_brain_brain__read_note(identifier=\"handoff\")`            |\n| Project Constraints | `constraints`          | `mcp__plugin_brain_brain__read_note(identifier=\"constraints\")`        |\n| Naming Conventions  | `naming-conventions`   | `mcp__plugin_brain_brain__read_note(identifier=\"naming-conventions\")` |\n\n**At session start**: Read handoff for current state.\n**At session end**: Update handoff with `edit_note` using `replace_section` on \"Current State\".\n\n---\n\nEntity naming is enforced by validators in both TypeScript and Go:\n\n- **TypeScript**: `@brain\u002Fvalidation` package (MCP runtime)\n- **Go**: `packages\u002Fvalidation\u002Finternal\u002Fvalidate_consistency.go` (CLI\u002Fhooks)\n- **Parity**: Cross-language tests ensure identical validation (`packages\u002Fvalidation\u002Fsrc\u002F__tests__\u002Fparity\u002F`)\n\nSee ADR-023 for validation architecture details.\n\n---\n\n## Tier 2: Episodic Memory\n\nSession replay via structured episode extraction. Reduces session logs from 10K-50K tokens to 500-2000 tokens.\n\n**Capabilities**:\n\n- Extract structured episodes from completed session logs\n- Query past sessions by outcome\u002Ftask\u002Fdate\n- Read decision sequences and event timelines\n- 95% token reduction vs full session logs\n\n**Architecture**: Markdown notes in `episodes\u002F` folder with structured frontmatter, integrated with basic-memory knowledge graph.\n\n**Usage**:\n\n```bash\n# Extract episode from completed session (reads from Brain memory)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fextract-episode.ts \\\n  --session SESSION-2026-01-20_06\n\n# Query episodes by outcome\nmcp__plugin_brain_brain__search({\n  query: \"outcome:failure\",\n  folder: \"episodes\",\n  limit: 10\n})\n\n# Read specific episode\nmcp__plugin_brain_brain__read_note({\n  identifier: \"EPISODE-2026-01-20-06\"\n})\n```\n\n### Tier 3: Causal Graph\n\nDecision pattern tracking with statistical validation. Prevents repeated mistakes through success rate tracking.\n\n**Capabilities**:\n\n- Track cause-effect relationships via WikiLink relations\n- Success rate tracking for patterns (running average)\n- Anti-pattern detection (low success rate patterns)\n- Pattern queries via semantic search\n\n**Architecture**: Pattern notes in `patterns\u002F` folder with typed WikiLink relations (causes, enables, prevents, correlates).\n\n**Usage**:\n\n```bash\n# Add new pattern\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fadd-pattern.ts \\\n  --name \"Memory-First Investigation\" \\\n  --trigger \"Agent wants to change existing system\" \\\n  --action \"Search memory before making changes\" \\\n  --success-rate 0.95\n\n# Query high success patterns\nmcp__plugin_brain_brain__search({\n  query: \"success_rate:>0.7\",\n  folder: \"patterns\"\n})\n\n# Find antipatterns\nmcp__plugin_brain_brain__search({\n  query: \"success_rate:\u003C0.3\",\n  folder: \"patterns\"\n})\n```\n\n**Reference**: See ADR-018 for complete episodic and causal memory architecture.\n\n---\n","# Memory System Skill\n\nMemory operations for AI agents using Brain MCP.\n\n---\n\n## Quick Start\n\n```typescript\n\u002F\u002F Tier 1: Search memory (Semantic)\nmcp__plugin_brain_brain__search({\n  query: \"git hooks\",\n  limit: 10,\n  mode: \"auto\",\n});\n\n\u002F\u002F Tier 1: List available memories\nmcp__plugin_brain_brain__list_directory({\n  dir_name: \"\u002F\",\n  depth: 2,\n});\n\n\u002F\u002F Tier 1: Read specific memory\nmcp__plugin_brain_brain__read_note({\n  identifier: \"usage-mandatory\",\n});\n```\n\n```bash\n# Tier 2: Extract episode from session (Episodic)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fextract-episode.ts \\\n  --session SESSION-2026-01-20_06\n\n# Tier 3: Add pattern (Causal)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fadd-pattern.ts \\\n  --name \"Memory-First Investigation\" \\\n  --trigger \"Agent wants to change existing system\" \\\n  --action \"Search memory before making changes\" \\\n  --success-rate 0.95\n```\n\n---\n\n## Memory-First as Chesterton's Fence\n\n**Core Insight**: Memory-first architecture implements Chesterton's Fence principle for AI agents.\n\n> \"Do not remove a fence until you know why it was put up\" - G.K. Chesterton\n\n**Translation for agents**: Do not change code\u002Farchitecture\u002Fprotocol until you search memory for why it exists.\n\n### Why This Matters\n\n**Without memory search** (removing fence without investigation):\n\n- Agent encounters complex code, thinks \"this is ugly, I'll refactor it\"\n- Removes validation logic that prevents edge case\n- Production incident occurs\n- Memory contains past incident that explains why validation existed\n\n**With memory search** (Chesterton's Fence investigation):\n\n- Agent encounters complex code\n- Searches memory: `mcp__plugin_brain_brain__search({ query: \"validation logic edge case\" })`\n- Finds past incident explaining why code exists\n- Makes informed decision: preserve, modify, or replace with equivalent safety\n\n### Investigation Protocol\n\nWhen you encounter something you want to change:\n\n| Change Type           | Memory Search Required                                                |\n| --------------------- | --------------------------------------------------------------------- |\n| Remove ADR constraint | `mcp__plugin_brain_brain__search({ query: \"[constraint name]\" })`     |\n| Bypass protocol       | `mcp__plugin_brain_brain__search({ query: \"[protocol name] why\" })`   |\n| Delete >100 lines     | `mcp__plugin_brain_brain__search({ query: \"[component] purpose\" })`   |\n| Refactor complex code | `mcp__plugin_brain_brain__search({ query: \"[component] edge case\" })` |\n| Change workflow       | `mcp__plugin_brain_brain__search({ query: \"[workflow] rationale\" })`  |\n\n### What Memory Contains (Git Archaeology)\n\n**Tier 1 (Semantic)**: Facts, patterns, constraints\n\n- Why does PowerShell-only constraint exist? (ADR-005)\n- Why do skills exist instead of raw CLI? (usage-mandatory)\n- What incidents led to BLOCKING gates? (protocol-blocking-gates)\n\n**Tier 2 (Episodic)**: Past session outcomes [FUTURE]\n\n- What happened when we tried approach X? (session replay)\n- What edge cases did we encounter? (failure episodes)\n\n**Tier 3 (Causal)**: Decision patterns [FUTURE]\n\n- What decisions led to success? (causal paths)\n- What patterns should we repeat\u002Favoid? (success\u002Ffailure patterns)\n\n### Memory-First Gate (BLOCKING)\n\n**Before changing existing systems, you MUST**:\n\n1. `mcp__plugin_brain_brain__search({ query: \"[topic]\" })`\n2. Review results for historical context\n3. If insufficient, document gap (Tiers 2-3 not yet available)\n4. Document findings in decision rationale\n5. Only then proceed with change\n\n**Why BLOCKING**: \u003C50% compliance with \"check memory first\" guidance. Making it BLOCKING achieves 100% compliance (same pattern as session protocol gates).\n\n**Verification**: Session logs must show memory search BEFORE decisions, not after.\n\n### Connection to Chesterton's Fence Analysis\n\nSee ADR-007 for:\n\n- Memory-first architecture principles\n- Investigation protocol\n- Verification requirements\n- BLOCKING gate enforcement\n\n**Key takeaway**: Memory IS your investigation tool. It contains the \"why\" that Chesterton's Fence requires you to discover.\n\n---\n\n## Triggers\n\n| Trigger Phrase                 | Maps To                                                                                       |\n| ------------------------------ | --------------------------------------------------------------------------------------------- |\n| \"search memory for X\"          | Tier 1: `mcp__plugin_brain_brain__search()`                                                   |\n| \"what do we know about X\"      | Tier 1: `mcp__plugin_brain_brain__search()`                                                   |\n| \"list memories\"                | Tier 1: `mcp__plugin_brain_brain__list_directory()`                                           |\n| \"read memory X\"                | Tier 1: `mcp__plugin_brain_brain__read_note()`                                                |\n| \"extract episode from session\" | Tier 2: `bun run scripts\u002Fextract-episode.ts --session SESSION-X`                              |\n| \"what happened in session X\"   | Tier 2: `mcp__plugin_brain_brain__read_note({ identifier: \"EPISODE-X\" })`                     |\n| \"find sessions with failures\"  | Tier 2: `mcp__plugin_brain_brain__search({ query: \"outcome:failure\", folder: \"episodes\" })`   |\n| \"add pattern\"                  | Tier 3: `bun run scripts\u002Fadd-pattern.ts --name \"...\" --trigger \"...\"`                         |\n| \"what patterns led to success\" | Tier 3: `mcp__plugin_brain_brain__search({ query: \"success_rate:>0.7\", folder: \"patterns\" })` |\n\n---\n\n## Quick Reference\n\n| Operation             | Tool                                      | Key Parameters                                      |\n| --------------------- | ----------------------------------------- | --------------------------------------------------- |\n| Search facts\u002Fpatterns | `mcp__plugin_brain_brain__search`         | `query`, `mode`, `limit`, `depth`, `folder`         |\n| List memories         | `mcp__plugin_brain_brain__list_directory` | `dir_name`, `depth`                                 |\n| Read memory           | `mcp__plugin_brain_brain__read_note`      | `identifier`                                        |\n| Write memory          | `mcp__plugin_brain_brain__write_note`     | `title`, `content`, `folder`                        |\n| Edit memory           | `mcp__plugin_brain_brain__edit_note`      | `identifier`, `operation`, `content`                |\n| Extract episode       | `bun run scripts\u002Fextract-episode.ts`      | `--session SESSION-ID`, `--force`                   |\n| Query episodes        | `mcp__plugin_brain_brain__search`         | `query`, `folder: \"episodes\"`                       |\n| Read episode          | `mcp__plugin_brain_brain__read_note`      | `identifier: \"EPISODE-{id}\"`                        |\n| Add pattern           | `bun run scripts\u002Fadd-pattern.ts`          | `--name`, `--trigger`, `--action`, `--success-rate` |\n| Query patterns        | `mcp__plugin_brain_brain__search`         | `query`, `folder: \"patterns\"`                       |\n| Get antipatterns      | `mcp__plugin_brain_brain__search`         | `query: \"success_rate:\u003C0.3\"`                        |\n\n### Retrieval Depth Strategy\n\nUse `depth` parameter to expand context via relations:\n\n| Depth | Behavior                                 | Use When                          |\n| ----- | ---------------------------------------- | --------------------------------- |\n| 0     | Direct matches only                      | Targeted lookup                   |\n| 1     | Include notes linked via relations       | Standard retrieval (recommended)  |\n| 2     | Include second-level connections (2 hop) | Exploring related decisions       |\n| 3     | Maximum depth (3 hop)                    | Deep investigation, impact analysis |\n\n---\n\n```text\nWhat do you need?\n│\n├─► Current facts, patterns, or rules?\n│   └─► TIER 1: mcp__plugin_brain_brain__search()\n│\n├─► List available memories?\n│   └─► TIER 1: mcp__plugin_brain_brain__list_directory()\n│\n├─► Read specific memory?\n│   └─► TIER 1: mcp__plugin_brain_brain__read_note()\n│\n├─► What happened in a specific session?\n│   ├─ Extract first: bun run scripts\u002Fextract-episode.ts [log-path]\n│   └─► TIER 2: mcp__plugin_brain_brain__read_note({ identifier: \"EPISODE-X\" })\n│\n├─► Recent sessions with specific outcome?\n│   └─► TIER 2: mcp__plugin_brain_brain__search({ query: \"outcome:failure\" })\n│\n├─► Why did decision X lead to outcome Y?\n│   └─► TIER 3: Search related patterns, trace WikiLink relations\n│\n├─► What patterns have high success rate?\n│   └─► TIER 3: mcp__plugin_brain_brain__search({ query: \"success_rate:>0.7\" })\n│\n├─► Need to store new knowledge?\n│   ├─ Session complete? → bun run scripts\u002Fextract-episode.ts\n│   ├─ Pattern discovered? → bun run scripts\u002Fadd-pattern.ts\n│   └─ Factual knowledge? → mcp__plugin_brain_brain__write_note()\n│\n└─► Not sure which tier?\n    └─► Start with TIER 1 (search), escalate to Tier 2\u002F3 if insufficient\n```\n\n---\n\n## Anti-Patterns\n\n| Anti-Pattern                     | Do This Instead                                        |\n| -------------------------------- | ------------------------------------------------------ |\n| Skipping memory search           | Always search before multi-step reasoning              |\n| Using old Serena\u002FForgetful tools | Use Brain MCP tools (`mcp__plugin_brain_brain__*`)     |\n| Expecting Tier 2-3 features      | Document needs, these are planned for future           |\n| Not documenting memory gaps      | When memory lacks info, note it for future enhancement |\n| Skipping pre-flight validation   | ALWAYS complete validation checklist before writes     |\n| Writing to wrong folder          | Check entity type to folder mapping                    |\n| Missing CAPS prefix in filename  | Follow pattern: `{PREFIX}-{NNN}-{topic}.md`            |\n| Fewer than 3 observations        | Add more facts\u002Fdecisions with categories               |\n| No relations section             | Add 2+ wikilinks to related entities                   |\n| Generic NOTE-\\* entity type      | Choose specific entity type (13 valid types)           |\n\n---\n\n## Storage Locations\n\n> **Configuration**: Memory paths configured in `~\u002F.config\u002Fbrain\u002Fconfig.json` (see ADR-020).\n\n| Mode    | Example Path               | Pattern Explanation                        |\n| ------- | -------------------------- | ------------------------------------------ |\n| DEFAULT | ~\u002Fmemories\u002Fbrain\u002Fepisodes\u002F | {memories_location}\u002F{project}\u002Fepisodes\u002F    |\n| CODE    | ~\u002FDev\u002Fbrain\u002Fdocs\u002Fepisodes\u002F | {code_path}\u002Fdocs\u002Fepisodes\u002F (no \u002F{project}) |\n| CUSTOM  | \u002Fcustom\u002Fpath\u002Fepisodes\u002F     | {memories_path}\u002Fepisodes\u002F (no \u002F{project})  |\n\nNote: `memories_location` defaults to `~\u002Fmemories` but is configurable via `brain config set memories-location \u003Cpath>`.\n\n| Data           | Location                                |\n| -------------- | --------------------------------------- |\n| Brain config   | `~\u002F.config\u002Fbrain\u002Fconfig.json`           |\n| Brain memories | `{resolved_path}\u002F` (see modes above)    |\n| Episodes       | `{resolved_path}\u002Fepisodes\u002FEPISODE-*.md` |\n| Patterns       | `{resolved_path}\u002Fpatterns\u002FPATTERN-*.md` |\n| Sessions       | `{resolved_path}\u002Fsessions\u002FSESSION-*.md` |\n| Governance     | `{resolved_path}\u002Fgovernance\u002F`           |\n\n**Notes**:\n\n- Brain MCP tools handle path resolution automatically. Do not use hardcoded paths in agent instructions.\n- The `memories_location` default is `~\u002Fmemories` but can be configured per-project or globally.\n- ADR-020 defines three modes: DEFAULT, CODE, CUSTOM (see table above).\n\n---\n\n## Verification\n\n| Operation         | Verification                                       |\n| ----------------- | -------------------------------------------------- |\n| Search completed  | Result count > 0 OR logged \"no results\"            |\n| Memory read       | Note content returned                              |\n| Memory written    | Confirmation with permalink                        |\n| Episode extracted | Markdown file created in `episodes\u002F` folder        |\n| Pattern added     | Markdown file created in `patterns\u002F` folder        |\n| Pattern updated   | Success rate recalculated, occurrences incremented |\n\n---\n\n## Related Skills\n\n| Skill                       | When to Use Instead                      |\n| --------------------------- | ---------------------------------------- |\n| `curating-memories`         | Memory maintenance (if available)        |\n| `exploring-knowledge-graph` | Multi-hop graph traversal (if available) |\n\n---\n\n## Write Operations Governance (BLOCKING)\n\n> **References**:\n>\n> - ADR-019: Memory Operations Governance (validation-based governance)\n> - ADR-020: Configuration Architecture Refactoring (storage locations, terminology)\n\n**All agents MAY write to Brain memory using this skill.**\n\nThe agent system uses one-level delegation. Subagents cannot delegate to other subagents. When orchestrator delegates to analyst, analyst must be able to write directly. Governance is achieved through pre-flight validation, not access control.\n\n**Non-compliant writes create governance debt**:\n\n- Notes in wrong folders\n- Inconsistent naming (missing CAPS prefix)\n- Missing quality thresholds\n- Broken knowledge graph relations\n\n### All Agents Can Write (with Validation)\n\n| Agent          | write_note | edit_note | Requirement                         |\n| -------------- | ---------- | --------- | ----------------------------------- |\n| **All agents** | **Yes**    | **Yes**   | MUST complete pre-flight validation |\n\n**No delegation required.** All agents write directly after completing validation.\n\n### Pre-Flight Validation (BLOCKING - All Agents)\n\nBefore calling `write_note` or `edit_note`, you MUST complete this checklist:\n\n```markdown\n### Pre-Flight Checklist (MUST all pass before write)\n\n- [ ] Entity type is valid (13 types only, see table below)\n- [ ] Folder matches entity type (see mapping)\n- [ ] File name follows CAPS prefix pattern\n- [ ] Frontmatter has: title, type, tags (2-5)\n- [ ] Observations section: 3-10 entries with categories\n- [ ] Observation format: `- [category] content #tags`\n- [ ] Relations section: 2-8 entries with wikilinks\n- [ ] Relation format: `- relation_type [[Target Entity]]`\n```\n\n**Agents that skip validation create governance debt.** Post-hoc audit will detect violations.\n\n### Entity Type to Folder Mapping (Canonical)\n\n**File names MUST match the File Pattern exactly.** The entity prefix MUST be ALL CAPS — `ADR-`, `SESSION-`, `REQ-`, etc. Never lowercase (`adr-`, `session-`, `req-`). This is non-negotiable; lowercase prefixes are malformed and will break lookups.\n\n| Entity Type   | Folder                                          | File Pattern                       |\n| :------------ | :---------------------------------------------- | :--------------------------------- |\n| decision      | decisions\u002F                                      | `ADR-{NNN}-{topic}.md`             |\n| session       | sessions\u002F                                       | `SESSION-YYYY-MM-DD_NN-{topic}.md` |\n| feature       | features\u002FFEAT-{NNN}-{name}\u002F                     | `FEAT-{NNN}-{name}.md`             |\n| requirement   | features\u002FFEAT-{NNN}-{name}\u002Frequirements\u002F        | `REQ-{NNN}-{topic}.md`             |\n| design        | features\u002FFEAT-{NNN}-{name}\u002Fdesign\u002F              | `DESIGN-{NNN}-{topic}.md`          |\n| task          | features\u002FFEAT-{NNN}-{name}\u002Ftasks\u002F               | `TASK-{NNN}-{topic}.md`            |\n| analysis      | analysis\u002F                                       | `ANALYSIS-{NNN}-{topic}.md`        |\n| epic          | roadmap\u002F                                        | `EPIC-{NNN}-{name}.md`             |\n| critique      | critique\u002F                                       | `CRIT-{NNN}-{topic}.md`            |\n| test-report   | qa\u002F                                             | `QA-{NNN}-{topic}.md`              |\n| security      | security\u002F                                       | `SEC-{NNN}-{component}.md`         |\n| retrospective | retrospective\u002F                                  | `RETRO-YYYY-MM-DD_{topic}.md`      |\n| skill         | skills\u002F                                         | `SKILL-{NNN}-{topic}.md`           |\n\n**No generic `NOTE-*` type allowed.** Forces proper categorization.\n\n**Feature folder naming** (per [[ADR-001-feature-workflow]]): `FEAT-{NNN}-{name}` uses kebab-case name, max 50 characters, validated by `FEAT-\\d{3}-[a-z0-9-]+`. Examples:\n\n- `features\u002FFEAT-001-feature-workflow\u002FFEAT-001-feature-workflow.md`\n- `features\u002FFEAT-001-feature-workflow\u002Frequirements\u002FREQ-001-agent-prompts.md`\n- `features\u002FFEAT-001-feature-workflow\u002Fdesign\u002FDESIGN-001-implementation-plan.md`\n- `features\u002FFEAT-001-feature-workflow\u002Ftasks\u002FTASK-001-create-templates.md`\n\n### Valid Observation Categories\n\n```text\n[fact], [decision], [requirement], [technique], [insight],\n[problem], [solution], [constraint], [risk], [outcome]\n```\n\n### Source Attribution in Observations\n\nEvery observation should include provenance. Three methods:\n\n**Context in observation** — source in parentheses:\n\n```markdown\n- [decision] Using JWT tokens (decided in ADR-005) #auth\n- [fact] Rate limit is 1000\u002Fhour (per API Documentation) #api\n```\n\n**Wikilink to source** — link to related entity:\n\n```markdown\n- [decision] Using JWT tokens #auth\n  - requires [[ADR-005 Auth Token Strategy]]\n```\n\n**Tags for agent source** — indicate which agent created observation:\n\n```markdown\n- [insight] Auth failures spike at token expiry #pattern #analyst\n```\n\n### Valid Relation Types\n\n```text\nimplements, depends_on, relates_to, extends, part_of,\ninspired_by, contains, pairs_with, supersedes, leads_to, caused_by\n```\n\n### Quality Thresholds\n\n| Element      | Min | Max | Example                        |\n| ------------ | --- | --- | ------------------------------ |\n| Observations | 3   | 10  | `- [decision] Using JWT #auth` |\n| Relations    | 2   | 8   | `- implements [[REQ-001]]`     |\n| Tags         | 2   | 5   | `tags: [auth, security]`       |\n\n### Example: Compliant Note Structure\n\nThe frontmatter title prefix MUST be ALL CAPS (`ADR-019`, not `adr-019`). Wikilink references MUST match the canonical title casing.\n\n```markdown\n---\ntitle: ADR-019 Memory Governance\ntype: decision\ntags: [memory, governance, enforcement]\n---\n\n# ADR-019 Memory Governance\n\n## Context\n\nAgents writing to memory without conventions create governance debt.\n\n## Observations\n\n- [decision] Validation-based governance selected #architecture\n- [fact] All agents retain direct write access #one-level-delegation\n- [requirement] Pre-flight validation MUST pass before writes #blocking\n- [technique] Memory skill provides validation guidance (not access control) #pattern\n\n## Relations\n\n- supersedes [[Ad-hoc Memory Writing]]\n- implements [[ADR-007 Memory-First Architecture]]\n- relates_to [[Session 06 Entity Standards]]\n```\n\n### Write Operation Decision Tree\n\n```text\nNeed to write\u002Fedit a memory note?\n│\n├─► Run pre-flight validation checklist\n│   │\n│   ├─► All checks PASS: Proceed with write_note\u002Fedit_note\n│   │\n│   └─► Any check FAILS: Fix violations before writing\n│       │\n│       ├─► Wrong folder? Check entity type mapping\n│       ├─► Missing CAPS prefix? Follow naming pattern\n│       ├─► Too few observations? Add more facts\u002Fdecisions\n│       └─► No relations? Add 2+ wikilinks\n│\n├─► Unsure about conventions?\n│   │\n│   └─► Consult this skill for entity type mapping, naming patterns, examples\n│\n└─► Read\u002Fsearch operations: Always allowed directly (no validation needed)\n```\n\n**All agents write directly.** No delegation to memory agent required.\n\n---\n\n## Storage Protocol\n\n### When to Store\n\nStore frequently. Autocompaction, crashes, and session interruptions lose context. Incremental updates prevent information loss.\n\n| Trigger                    | Action                                        |\n| -------------------------- | --------------------------------------------- |\n| Significant insight\u002Fdecision | Write or update immediately                 |\n| Every back-and-forth exchange | Don't wait for milestones                  |\n| During research\u002Fanalysis   | Update incrementally, not one batch at end    |\n| Before risky operations    | Store before compaction or long-running tasks |\n| Session end                | Final sync                                    |\n\n**Anti-pattern**: Large research task then single update at end.\n**Correct pattern**: Update note after each finding during research.\n\n### Create vs Update Decision\n\n| Condition                              | Action                                 |\n| -------------------------------------- | -------------------------------------- |\n| Existing note covers this topic        | Update with `edit_note`                |\n| Distinct atomic unit, no coverage      | Create new with `write_note`           |\n| Related folder exists                  | Create in appropriate folder           |\n| No related folder                      | Create in closest related folder       |\n\n**Always search before creating** to prevent duplicates.\n\n### Curation Operations\n\nTreat memories as living documents. Refine, reorganize, clarify continuously.\n\n**Append** — add new observations, relations, or context:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"append\"\ncontent: \"- [decision] Made choice X based on constraint Y #topic\"\n```\n\n**Prepend** — add critical updates at top for visibility:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"prepend\"\ncontent: \"- [problem] Critical issue discovered: Z #urgent\"\n```\n\n**Find\u002FReplace** — refine existing observations as understanding evolves:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"find_replace\"\nfind_text: \"- [idea] Might use approach A\"\ncontent: \"- [decision] Decided on approach A after testing B #validated\"\n```\n\n**Replace Section** — update entire sections when context changes:\n\n```text\nmcp__plugin_brain_brain__edit_note\nidentifier: \"[note-title]\"\noperation: \"replace_section\"\nsection: \"Context\"\ncontent: \"## Context\\n[Updated context with new information]\"\n```\n\n---\n\n## Freshness Protocol\n\n### Update Triggers\n\nUpdate parent memory entities when downstream refinements occur:\n\n| Event                    | Action                                | Example                        |\n| ------------------------ | ------------------------------------- | ------------------------------ |\n| Epic refined             | Update `EPIC-*` entity with new scope | Scope narrowed during planning |\n| PRD completed            | Add observation linking to PRD        | PRD created from epic          |\n| Tasks decomposed         | Update with task count and coverage   | 15 tasks generated             |\n| Implementation started   | Add progress observations             | Sprint 1 started               |\n| Milestone completed      | Update with outcome                   | Auth feature shipped           |\n| Decision changed         | Supersede old observation             | ADR-005 supersedes ADR-003     |\n\n### Staleness Detection\n\nObservations older than 30 days without updates should be reviewed:\n\n1. **Mark for review**: Add `[REVIEW]` tag if uncertain about accuracy\n2. **Supersede if outdated**: Create new observation with `supersedes` relation\n3. **Archive if irrelevant**: Move to archive folder or delete note\n\n### Conflict Resolution\n\nWhen observations contradict:\n\n1. Prefer most recent observation\n2. Create relation with type `supersedes`\n3. Add `[REVIEW]` tag if uncertain\n\n---\n\n## Session Log Creation\n\nSession logs are stored in Brain memory under `sessions\u002F` folder.\n\n```text\nmcp__plugin_brain_brain__write_note\ntitle: \"SESSION-YYYY-MM-DD_NN-topic\"\nfolder: \"sessions\"\ncontent: \"[Session log template content]\"\n```\n\n**Session Log Template**:\n\n```markdown\n---\ntitle: SESSION-YYYY-MM-DD_NN-topic\ntype: session\ntags: [session, YYYY-MM-DD]\n---\n\n# Session NN - YYYY-MM-DD\n\n## Session Info\n\n- **Date**: YYYY-MM-DD\n- **Branch**: [branch name]\n- **Starting Commit**: [SHA]\n- **Objective**: [What this session aims to accomplish]\n\n## Protocol Compliance\n\n[Session start checklist here]\n\n## Work Log\n\n### [Task\u002FTopic]\n\n**Status**: In Progress \u002F Complete \u002F Blocked\n\n**What was done**:\n- [Action taken]\n\n**Decisions made**:\n- [Decision]: [Rationale]\n\n## Relations\n\n- part_of [[Current Project]]\n- leads_to [[Next Session Topic]]\n```\n\n---\n\n## Governance Access\n\nProject governance documents are stored in Brain memory under `governance\u002F` folder:\n\n| Document            | Identifier             | Access Pattern                                                        |\n| ------------------- | ---------------------- | --------------------------------------------------------------------- |\n| Project Handoff     | `handoff`              | `mcp__plugin_brain_brain__read_note(identifier=\"handoff\")`            |\n| Project Constraints | `constraints`          | `mcp__plugin_brain_brain__read_note(identifier=\"constraints\")`        |\n| Naming Conventions  | `naming-conventions`   | `mcp__plugin_brain_brain__read_note(identifier=\"naming-conventions\")` |\n\n**At session start**: Read handoff for current state.\n**At session end**: Update handoff with `edit_note` using `replace_section` on \"Current State\".\n\n---\n\nEntity naming is enforced by validators in both TypeScript and Go:\n\n- **TypeScript**: `@brain\u002Fvalidation` package (MCP runtime)\n- **Go**: `packages\u002Fvalidation\u002Finternal\u002Fvalidate_consistency.go` (CLI\u002Fhooks)\n- **Parity**: Cross-language tests ensure identical validation (`packages\u002Fvalidation\u002Fsrc\u002F__tests__\u002Fparity\u002F`)\n\nSee ADR-023 for validation architecture details.\n\n---\n\n## Tier 2: Episodic Memory\n\nSession replay via structured episode extraction. Reduces session logs from 10K-50K tokens to 500-2000 tokens.\n\n**Capabilities**:\n\n- Extract structured episodes from completed session logs\n- Query past sessions by outcome\u002Ftask\u002Fdate\n- Read decision sequences and event timelines\n- 95% token reduction vs full session logs\n\n**Architecture**: Markdown notes in `episodes\u002F` folder with structured frontmatter, integrated with basic-memory knowledge graph.\n\n**Usage**:\n\n```bash\n# Extract episode from completed session (reads from Brain memory)\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fextract-episode.ts \\\n  --session SESSION-2026-01-20_06\n\n# Query episodes by outcome\nmcp__plugin_brain_brain__search({\n  query: \"outcome:failure\",\n  folder: \"episodes\",\n  limit: 10\n})\n\n# Read specific episode\nmcp__plugin_brain_brain__read_note({\n  identifier: \"EPISODE-2026-01-20-06\"\n})\n```\n\n### Tier 3: Causal Graph\n\nDecision pattern tracking with statistical validation. Prevents repeated mistakes through success rate tracking.\n\n**Capabilities**:\n\n- Track cause-effect relationships via WikiLink relations\n- Success rate tracking for patterns (running average)\n- Anti-pattern detection (low success rate patterns)\n- Pattern queries via semantic search\n\n**Architecture**: Pattern notes in `patterns\u002F` folder with typed WikiLink relations (causes, enables, prevents, correlates).\n\n**Usage**:\n\n```bash\n# Add new pattern\nbun run apps\u002Fclaude-plugin\u002Fskills\u002Fmemory\u002Fscripts\u002Fadd-pattern.ts \\\n  --name \"Memory-First Investigation\" \\\n  --trigger \"Agent wants to change existing system\" \\\n  --action \"Search memory before making changes\" \\\n  --success-rate 0.95\n\n# Query high success patterns\nmcp__plugin_brain_brain__search({\n  query: \"success_rate:>0.7\",\n  folder: \"patterns\"\n})\n\n# Find antipatterns\nmcp__plugin_brain_brain__search({\n  query: \"success_rate:\u003C0.3\",\n  folder: \"patterns\"\n})\n```\n\n**Reference**: See ADR-018 for complete episodic and causal memory architecture.\n\n---\n",{"name":5,"model":38,"license":15,"version":39,"metadata":40,"description":7},"claude-sonnet-4-5","0.1.0",{"adr":41,"reference":44,"timelessness":45,"brain_version":39},[42,43],"ADR-007","ADR-020","ai-agents memory skill v0.2.0","8\u002F10","main","2bd10cb7ca989f88dbf338b57957763718eda59b","templates\u002Fskills\u002Fmemory","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain","https:\u002F\u002Fgithub.com\u002Floriensleafs","2026-03-11 23:51:59",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add loriensleafs\u002Fbrain --skill memory",{"tool":58,"command":59},"bunx","bunx skills add loriensleafs\u002Fbrain --skill memory",{"tool":61,"command":62},"pnpm","pnpm dlx skills add loriensleafs\u002Fbrain --skill memory","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002FSKILL.md",true,[66,72,76,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138,142,148,152,156,160,164,168,172,176,180,184,188,192,198,202],{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"assets\u002Ffew-shot-examples.json","ASSET","资产文件",4174,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Fassets\u002Ffew-shot-examples.json",{"path":73,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":74,"sourceHtmlUrl":75},"assets\u002Fprompt-template-library.md",3273,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Fassets\u002Fprompt-template-library.md",{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fagent-integration.md","REFERENCE","参考文档",19717,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fagent-integration.md",{"path":83,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fapi-reference.md",18497,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fapi-reference.md",{"path":87,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fbenchmarking.md",14527,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fbenchmarking.md",{"path":91,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fchain-of-thought.md",9386,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Freferences\u002Fchain-of-thought.md",{"path":95,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":96,"sourceHtmlUrl":97},"references\u002Ffew-shot-learning.md",11171,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Freferences\u002Ffew-shot-learning.md",{"path":99,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":100,"sourceHtmlUrl":101},"references\u002Fmemory-router.md",14078,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fmemory-router.md",{"path":103,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":104,"sourceHtmlUrl":105},"references\u002Fprompt-optimization.md",12778,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Freferences\u002Fprompt-optimization.md",{"path":107,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":108,"sourceHtmlUrl":109},"references\u002Fprompt-templates.md",11395,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Freferences\u002Fprompt-templates.md",{"path":111,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":112,"sourceHtmlUrl":113},"references\u002Fquick-start.md",13823,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fquick-start.md",{"path":115,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":116,"sourceHtmlUrl":117},"references\u002Freflexion-memory.md",26460,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Freflexion-memory.md",{"path":119,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":120,"sourceHtmlUrl":121},"references\u002Fskill-reference.md",9545,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Fskill-reference.md",{"path":123,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fsystem-prompts.md",5438,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Freferences\u002Fsystem-prompts.md",{"path":127,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Ftier-selection-guide.md",3437,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Ftier-selection-guide.md",{"path":131,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Ftroubleshooting.md",15685,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Freferences\u002Ftroubleshooting.md",{"path":135,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":136,"sourceHtmlUrl":137},"resources\u002Fschemas\u002Fcausal-graph.schema.json",3471,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fresources\u002Fschemas\u002Fcausal-graph.schema.json",{"path":139,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":140,"sourceHtmlUrl":141},"resources\u002Fschemas\u002Fepisode.schema.json",3595,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fresources\u002Fschemas\u002Fepisode.schema.json",{"path":143,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":146,"sourceHtmlUrl":147},"scripts\u002Fadd-pattern.ts","SCRIPT","脚本",16623,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002Fadd-pattern.ts",{"path":149,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":150,"sourceHtmlUrl":151},"scripts\u002Fextract-episode.ts",18979,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002Fextract-episode.ts",{"path":153,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":154,"sourceHtmlUrl":155},"scripts\u002FExtract-SessionEpisode.ps1",14361,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FExtract-SessionEpisode.ps1",{"path":157,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":158,"sourceHtmlUrl":159},"scripts\u002FMeasure-MemoryPerformance.ps1",18106,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FMeasure-MemoryPerformance.ps1",{"path":161,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":162,"sourceHtmlUrl":163},"scripts\u002FMemoryRouter.psm1",15031,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FMemoryRouter.psm1",{"path":165,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":166,"sourceHtmlUrl":167},"scripts\u002Foptimize-prompt.py",9159,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fllm-application-dev\u002Fskills\u002Fprompt-engineering-patterns\u002Fscripts\u002Foptimize-prompt.py",{"path":169,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":170,"sourceHtmlUrl":171},"scripts\u002Fpackage.json",298,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002Fpackage.json",{"path":173,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":174,"sourceHtmlUrl":175},"scripts\u002FReflexionMemory.psm1",26886,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FReflexionMemory.psm1",{"path":177,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":178,"sourceHtmlUrl":179},"scripts\u002FSearch-Memory.ps1",4887,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FSearch-Memory.ps1",{"path":181,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":182,"sourceHtmlUrl":183},"scripts\u002FTest-MemoryHealth.ps1",11392,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FTest-MemoryHealth.ps1",{"path":185,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":186,"sourceHtmlUrl":187},"scripts\u002Ftsconfig.json",279,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002Ftsconfig.json",{"path":189,"resourceType":144,"resourceTypeDesc":145,"sizeBytes":190,"sourceHtmlUrl":191},"scripts\u002FUpdate-CausalGraph.ps1",10628,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fscripts\u002FUpdate-CausalGraph.ps1",{"path":193,"resourceType":194,"resourceTypeDesc":195,"sizeBytes":196,"sourceHtmlUrl":197},"spec\u002Fskill-specification.xml","OTHER","其他",10738,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Fspec\u002Fskill-specification.xml",{"path":199,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":200,"sourceHtmlUrl":201},"templates\u002Fepisode-template.md",912,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Ftemplates\u002Fepisode-template.md",{"path":203,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":204,"sourceHtmlUrl":205},"templates\u002Fpattern-template.md",568,"https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fmemory\u002Ftemplates\u002Fpattern-template.md",[207,224,240,262,279,303],{"skillNo":208,"name":209,"nameZh":6,"description":210,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":211,"categories":212,"keywords":213,"publishedAt":33},"01M6CD3KHDHPR633RVP95G4XWN","validation-authority","Treat upstream validators as authoritative. Align local config to them. Use when validation fails unexpectedly, before modifying validator behavior, or when tempted to change upstream tool code.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fvalidation-authority\u002FSKILL.md",[],[214,215,216,217,218,219,220,221,222,223],"validation authority","validation","config","use","implementer","behavior","tool","architect","code","change",{"skillNo":225,"name":226,"nameZh":6,"description":227,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":228,"categories":229,"keywords":230,"publishedAt":33},"01M6CD3H29Q8FWN9YETT8YVQTS","using-brain-memory","Guidance for using Brain semantic memory effectively. Applies Zettelkasten atomic note principles with observations and relations. Use when deciding whether to query or create notes, structuring note content, or understanding the semantic knowledge graph.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fusing-forgetful-memory\u002FSKILL.md",[],[231,5,232,233,234,235,236,217,237,238,239],"using brain memory","content","create","notes","graph","guidance","context","knowledge","knowledge graph",{"skillNo":241,"name":242,"nameZh":6,"description":243,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":244,"categories":245,"keywords":246,"publishedAt":33},"01M6CD3E2KTTMNSWXRJAAZA7D1","threat-modeling","Structured security analysis using OWASP Four-Question Framework and STRIDE methodology. Generates threat matrices with risk ratings, mitigations, and prioritization. Use for attack surface analysis, security architecture review, or when asking what can go wrong.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fthreat-modeling\u002FSKILL.md",[],[247,248,249,217,250,221,251,252,253,254,255,256,257,258,26,259,260,261],"threat","threat modeling","prioritization","question","architecture review","stride","analysis","risk","owasp","methodology","framework","security analysis","security","go","review",{"skillNo":263,"name":264,"nameZh":6,"description":265,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":266,"categories":267,"keywords":269,"publishedAt":33},"01M6CD3BC6G0Q2MDNW6X51XHBQ","taste-lints","Custom lints with agent-readable remediation instructions. Enforces taste invariants (file size, naming conventions, structured logging, complexity) and surfaces errors that agents can act on directly. Use when writing or reviewing code to catch style violations early.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Ftaste-lints\u002FSKILL.md",[268],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[270,218,271,272,217,273,274,275,276,277,222,278],"taste lints","surfaces","complexity","instructions","remediation","file","logging","qa","writing",{"skillNo":280,"name":281,"nameZh":6,"description":282,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":283,"categories":284,"keywords":285,"publishedAt":33},"01M6CD37Z7VD22BH42TG0GM66V","style-enforcement","Validate code against style rules from .editorconfig, StyleCop.json, and Directory.Build.props. Detects line ending violations, naming convention issues, indentation problems, and charset mismatches across C#, Python, TypeScript, and JavaScript. Produces JSON reports for pre-commit hooks and CI pipelines.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fstyle-enforcement\u002FSKILL.md",[],[286,287,288,289,290,291,218,292,293,294,295,296,277,297,222,298,299,300,301,302],"style enforcement","enforcement","ci","pipelines","directory","hooks","Rules","json","pre-commit","editorconfig","reports","issues","validate","commit","javascript","python","typescript",{"skillNo":304,"name":305,"nameZh":6,"description":306,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":307,"categories":308,"keywords":309,"publishedAt":33},"01M6CD35JW73TPMCZBF9DTDEE8","steering-matcher","Match file paths against steering file glob patterns to determine applicable steering guidance. Use when orchestrator needs to inject context-aware guidance based on files being modified.","https:\u002F\u002Fgithub.com\u002Floriensleafs\u002Fbrain\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Fsteering-matcher\u002FSKILL.md",[],[310,217,311,312,237,313,236,275],"steering matcher","files","haiku","orchestrator"]