Brain
세션 간 지속적인 메모리. Obsidian 볼트는 brain/에 있습니다.
브레인은 전체 워크플로우의 기초입니다. 모든 에이전트, 스킬, 세션이 이를 읽습니다. 품질이 낮거나 추측성인 내용은 다운스트림 전체를 저하시킵니다. 무엇이든 추가하기 전에 스스로에게 물어보세요: "이 내용이 시스템 운영을 진정으로 개선하는가?" 명확한 '예'가 아니라면, 작성하지 마세요.
작성 전
먼저 brain/index.md를 읽으세요. 그런 다음 주제에 맞는 관련 진입점을 읽으세요.
brain/principles.md— 원칙 업데이트용brain/plans/index.md— 계획 관련 노트용
아직 전용 인덱스 파일이 없는 디렉토리(brain/codebase/, brain/audits/)의 경우, 근처 파일을 직접 스캔하고 가능하면 기존 노트를 편집하세요.
구조
brain/
├── index.md ← 루트 진입점, 모든 항목에 연결
├── principles.md ← principles/의 인덱스
├── todos.md ← 제품 백로그
├── vision.md ← 엘리베이터 피치 + 아키텍처 링크
├── architecture.md ← 전체 기술 참조
├── principles/ ← 엔지니어링 및 설계 원칙
├── codebase/ ← 프로젝트별 지식 및 주의사항
├── plans/ ← 번호가 매겨진 기능 계획 (02-arrow-bindings/ 등)
└── audits/ ← 설계 및 품질 감사 (날짜 접두사 파일명, 예: 2026-02-20-quality-audit.md)
규칙:
- 파일당 하나의 주제.
brain/codebase/noodle-spawn-gotchas.md처럼 거대한 파일을 만들지 마세요. - 기존 인덱스 진입점 유지:
brain/index.md,brain/principles.md,brain/plans/index.md. - 새로운 최상위 카테고리를 도입하는 경우, 해당 카테고리의 인덱스 스타일 진입점을 추가하세요(링크만, 인라인 내용 없음).
brain/index.md는 루트입니다. 모든 브레인 파일이 여기에서 도달 가능해야 합니다.- 파일명: 소문자, 하이픈 구분.
worktree-gotchas.md. - 계획 디렉토리:
brain/todos.md의 할 일 ID를 접두사로 사용.02-arrow-bindings/내부에overview.md와phase-N-*.md.
위키링크
형식: [[section/file-name]]. 해석 순서: 같은 디렉토리, 그 다음 상대 경로, 마지막으로 볼트 루트. 헤딩 앵커([[file#heading]])는 해석 중 제거됩니다.
작성 스타일
- 산문보다는 글머리 기호. 서론 없음.
# 제목형식의 일반 마크다운. Obsidian 프론트매터 없음.- 노트는 약 50줄 미만으로 유지. 더 길면 분할.
작성 후
추가하거나 제거한 모든 파일에 대해 brain/index.md를 업데이트하세요. 또한 해당되는 경우 관련 진입점(brain/principles.md, brain/delegation.md, 또는 brain/plans/index.md)도 업데이트하세요. 인덱스는 링크 전용으로 유지하고 훑어보기 쉽게 하세요.
내구성 테스트
스스로에게 물어보세요: "이 내용을 다른 작업의 프롬프트에 포함하겠는가?"
- 예 →
brain/에 작성. 내구성 있는 지식입니다. - 아니요, 계획별 내용입니다 → 계획의 단계 문서를 업데이트하세요.
- 아니요, 스킬 문제입니다 → 스킬 파일을 직접 업데이트하세요.
- 아니요, 후속 작업이 필요합니다 →
todo스킬을 사용하여 할 일을 등록하세요.
유지보수
- 오래되었거나 다른 노트에 포함된 노트를 삭제하세요.
brain/plans/에 있는 무작위 이름의 파일을 삭제하세요. — 오래된 계획 모드 아티팩트입니다.- 새 노트를 추가하기 전에 중복된 노트를 병합하세요.