second-brainlisted
Install: claude install-skill dmitrax/second-brain-setup
# Second Brain — vault operation rules
## Vault
Path: ~/Workspace/second-brain-vault/
Always load at session start: 00-shared/CRITICAL_FACTS.md
## Structure
```
vault/
├── 00-system/ ← index.md, connections.md
├── 00-shared/ ← SOUL.md, CRITICAL_FACTS.md
└── [project]/ ← _PROJECT.md, taskboard.md, raw/, wiki/, output/, sessions/
architecture-map.md ← code/mixed projects only
```
## Wiki note format (AI-First)
Every note in wiki/ MUST contain both blocks:
**1. YAML frontmatter:**
```yaml
---
tags: [tag1, tag2]
date: YYYY-MM-DD
project: project-name
sources: ["raw/path/to/source"]
status: draft | stable
---
```
**2. ## For future Claude (immediately after frontmatter):**
```markdown
## For future Claude
**Use when:** [specific triggers — when this note is needed]
**Key facts:** [2-5 bullet points]
**Last updated:** YYYY-MM-DD
```
## Principles
**Rewrite, not append.**
When processing a new source — rewrite existing notes.
Update facts, remove outdated content, add new links.
Do not create a new page on top of the old one.
**_PROJECT.md links, wiki holds the detail.**
`_PROJECT.md` has three sections prone to this, all governed the same way:
"Current state" (status + blockers only), "Последняя сессия" (1-2 line-per-entry
changelog), and its own "For future Claude" (a bounded, curated quick-reference of
hard constraints and currently-relevant gotchas — not a technical archive). None of
the three ever repeats a wiki note's prose — if the