Agent Skills › poteto/noodle › brain

brain

GitHub

用于在Obsidian仓库中持久化存储知识,如反思、计划和架构决策。触发于调试后或需跨会话保留洞察时,支持读写笔记并维护索引结构。

.agents/skills/brain/SKILL.md poteto/noodle

Trigger Scenarios

调试会话后记录经验 做出架构决策 用户指令包含'add to brain' 需要跨会话持久化知识

Install

npx skills add poteto/noodle --skill brain -g -y
More Options

Non-standard path

npx skills add https://github.com/poteto/noodle/tree/main/.agents/skills/brain -g -y

Use without installing

npx skills use poteto/noodle@brain

指定 Agent (Claude Code)

npx skills add poteto/noodle --skill brain -a claude-code -g -y

安装 repo 全部 skill

npx skills add poteto/noodle --all -g -y

预览 repo 内 skill

npx skills add poteto/noodle --list

SKILL.md

Frontmatter
{
    "name": "brain",
    "description": "Read\/write brain files (Obsidian vault at brain\/). Use for any task that persists knowledge — reflection, planning, or direct edits. Triggers after debugging sessions, mistakes, corrections, architectural decisions, or any insight worth preserving across sessions. Use on 'add to brain', 'remember this', 'write a note', or brain\/ modifications."
}

Brain

Persistent memory across sessions. Obsidian vault at brain/.

The brain is the foundation of the entire workflow — every agent, skill, and session reads it. Low-quality or speculative content degrades everything downstream. Before adding anything, ask: "Does this genuinely improve how the system operates?" If the answer isn't a clear yes, don't write it.

Before Writing

Read brain/index.md first. Then read the relevant entrypoint for your topic:

  • brain/principles.md for principle updates
  • brain/plans/index.md for plan-related notes

For directories without a dedicated index file yet (brain/codebase/, brain/audits/), scan nearby files directly and edit an existing note when possible.

Structure

brain/
├── index.md              ← root entry point, links to everything
├── principles.md         ← index for principles/
├── todos.md              ← product backlog
├── vision.md             ← elevator pitch + link to architecture
├── architecture.md       ← full technical reference
├── principles/           ← engineering and design principles
├── codebase/             ← project-specific knowledge and gotchas
├── plans/                ← numbered feature plans (02-arrow-bindings/, etc.)
└── audits/               ← design and quality audits (date-prefixed filenames, e.g. 2026-02-20-quality-audit.md)

Rules:

  • One topic per file. brain/codebase/noodle-spawn-gotchas.md, not a mega-file.
  • Maintain existing index entrypoints: brain/index.md, brain/principles.md, brain/plans/index.md.
  • If you introduce a new top-level category, add an index-style entrypoint for it (links only, no inlined content).
  • brain/index.md is the root. Every brain file must be reachable from it.
  • File names: lowercase, hyphenated. worktree-gotchas.md.
  • Plan directories: prefixed with the todo ID from brain/todos.md. 02-arrow-bindings/ with overview.md and phase-N-*.md inside.

Wikilinks

Format: [[section/file-name]]. Resolution order: same directory, then relative path, then vault root. Heading anchors ([[file#heading]]) are stripped during resolution.

Writing Style

  • Bullets over prose. No preamble.
  • Plain markdown with # Title. No Obsidian frontmatter.
  • Keep notes under ~50 lines. Split if longer.

After Writing

Update brain/index.md for any files you added or removed. Also update the relevant entrypoint (brain/principles.md, brain/delegation.md, or brain/plans/index.md) when applicable. Keep indexes link-only and scannable.

Durability Test

Ask: "Would I include this in a prompt for a different task?"

  • Yes → write to brain/. It's durable knowledge.
  • No, it's plan-specific → update the plan's phase doc instead.
  • No, it's a skill issue → update the skill file directly.
  • No, it needs follow-up work → file a todo with the todo skill.

Maintenance

  • Delete outdated or subsumed notes.
  • Delete random-named files in brain/plans/ — stale plan-mode artifacts.
  • Merge overlapping notes before adding new ones.

Version History

  • 82d2921 Current 2026-11-19 21:08

Same Skill Collection

.agents/skills/adversarial-review/SKILL.md
.agents/skills/ast-grep/SKILL.md
.agents/skills/codex/SKILL.md
.agents/skills/commit/SKILL.md
.agents/skills/debugging/SKILL.md
.agents/skills/execute/SKILL.md
.agents/skills/find-skills/SKILL.md
.agents/skills/frontend-design/SKILL.md
.agents/skills/go-best-practices/SKILL.md
.agents/skills/interaction-design/SKILL.md
.agents/skills/make-interfaces-feel-better/SKILL.md
.agents/skills/meditate/SKILL.md
.agents/skills/noodle/SKILL.md
.agents/skills/oops/SKILL.md
.agents/skills/plan/SKILL.md
.agents/skills/quality/SKILL.md
.agents/skills/react-best-practices/SKILL.md
.agents/skills/refine/SKILL.md
.agents/skills/reflect/SKILL.md
.agents/skills/review/SKILL.md
.agents/skills/ruminate/SKILL.md
.agents/skills/schedule/SKILL.md
.agents/skills/skill-creator/SKILL.md
.agents/skills/testing/SKILL.md
.agents/skills/todo/SKILL.md
.agents/skills/unslop/SKILL.md
.agents/skills/worktree/SKILL.md
examples/minimal/.agents/skills/execute/SKILL.md
examples/minimal/.agents/skills/schedule/SKILL.md
examples/multi-skill/.agents/skills/execute/SKILL.md
examples/multi-skill/.agents/skills/schedule/SKILL.md
skills/skill-creator/SKILL.md
.agents/skills/ts-best-practices/SKILL.md
examples/multi-skill/.agents/skills/deploy/SKILL.md
examples/multi-skill/.agents/skills/test/SKILL.md

Metadata

Files
0
Version
82d2921
Hash
0f214f7b
Indexed
2026-11-19 21:08

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-20 03:01
浙ICP备14020137号-1