Skip to content

AGENTS.md

Latest commit

 

History

History
81 lines (63 loc) · 3.71 KB

AGENTS.md

File metadata and controls

81 lines (63 loc) · 3.71 KB

Brain — Personal Knowledge Vault

Personal compounding knowledge base and AI-powered development platform. Obsidian vault + MCP server + Claude Code commands + Git.

Vault Structure

Folder Domain What goes here
vault/inbox/ Capture Unprocessed captures from Telegram, terminal, or quick dumps
vault/daily/ Daily notes One file per day: YYYY-MM-DD.md. Append-only scratch pads
vault/ai-workflows/ AI Development AI dev patterns, CLAUDE.md configs, hooks, MCP, skills
vault/coding/ Coding Language patterns, architecture decisions, debugging playbooks
vault/tools/ Tool Mastery Tool configs, shortcuts, integrations
vault/projects/ Projects Per-project learnings (subfolder per project)
vault/industry/ Industry Intel Trends, research papers, conference talks, blog posts
vault/innovations/ Personal R&D Own workflow experiments and results
vault/weekly-reviews/ Reviews Weekly synthesis notes
vault/decisions/ ADRs Architecture Decision Records
vault/sources/ Source Material Raw content — YouTube transcripts, RSS captures, papers. vault/sources/<type>/<channel>/
vault/library/ Artifact Library Reusable AI artifacts (skills, commands, hooks, patterns)
vault/templates/ Templates Obsidian note templates (do not put notes here)
vault/_attachments/ Media Images, PDFs, attached files

Note Conventions

Every vault note MUST have this YAML frontmatter:

---
title: "Note title"
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: []
visibility: private          # private | team | public
source: manual               # telegram | terminal | claude | manual | import | harvest | ecosystem
status: seedling             # seedling | growing | evergreen
aliases: []
related: []                  # [[wiki-links]] to other notes
---

File naming: Domain notes: kebab-case-title.md · Inbox: YYYYMMDD-HHMMSS.md · Daily: YYYY-MM-DD.md

Status: seedling (raw) → growing (developing) → evergreen (mature)

Wiki-links: Use [[Note Title]] syntax. The title must exactly match the title: field of the target note.

Tags

Domains: ai-development, coding, tools, architecture, debugging, workflow, infrastructure

Types: pattern, anti-pattern, gotcha, til, config, playbook, trend, adr, project, daily, tool, skill, artifact

Languages/Tools: python, typescript, go, git, claude-code, obsidian, docker, mcp

Rules

  1. Search before creating. Always search for existing notes on the same topic before creating a new one.
  2. Use wiki-links. All internal references use [[Note Title]] syntax (exact title match).
  3. Prefer linking over creating. If a related note exists, link to it rather than duplicating.
  4. Use templates. Every new note starts from the appropriate template in vault/templates/.
  5. Never delete or move files without explicit user instruction.
  6. Daily notes are append-only during their active day.
  7. Use existing tags first. Check the tags list above before inventing new ones.
  8. Update the updated field whenever you modify a note's content or frontmatter.

Search

vault/ai-workflows/**/*.md    — AI dev patterns
vault/coding/**/*.md          — Coding patterns
vault/industry/**/*.md        — Trends and research
vault/projects/**/*.md        — Project learnings
vault/tools/**/*.md           — Tool configs
vault/library/**/*.md         — Library artifacts

grep -rl "  - claude-code" vault/ --include="*.md"   # search by tag
grep -rL "processed: true" vault/inbox/ --include="*.md"  # unprocessed items