poteto/noodle

brain

Read/write brain files (Obsidian vault at brain/).

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/poteto/noodle --skill brain

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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.
같은 저장소의 Skills

더 많은 Skills

모든 Skills