brain

Original：🇺🇸 English

Translated

Read/write brain files (Obsidian vault at brain/). Use for any task that persists knowledge — reflection, planning, or direct edits. Triggers: brain/ modifications, "add to brain".

2installs

Sourcepoteto/noodle

Added on2026-03-06

NPX Install

npx skill4agent add poteto/noodle brain

SKILL.md Content

View Translation Comparison →

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.