/bootstrap

Scaffold a complete Brain OS markdown vault. Follow these steps:

1. Check target directory

Use $ARGUMENTS if provided, otherwise default to ~/brain. If the directory already exists, check for a CLAUDE.md file inside it. If CLAUDE.md is present, this is an existing vault. Warn the user and offer three options:

• (a) Skip existing files — only write files that do not already exist
• (b) Add missing templates only — write template files that are missing but leave everything else
• (c) Abort — do nothing

Wait for the user to choose before proceeding.

2. Initialize

Create the target directory if it does not exist. Initialize a git repository with git init.

3. Create all module directories

Create the following directories inside the target:

identity/
brand/
content/ideas/
content/posts/
content/drafts/
content/drafts/templates/
knowledge/bookmarks/
code/decisions/
code/debugging/
code/tech-debt/
network/contacts/
network/interactions/
operations/metrics/
memory/decisions/
memory/failures/
memory/experiences/
workbench/promotions/
health/
journal/events/
home/

4. Copy entity templates

Copy the following entity template files from the plugin into the vault as _template.md in each corresponding directory:

• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/entity-templates/idea-template.md to content/ideas/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/entity-templates/post-template.md to content/posts/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/entity-templates/bookmark-template.md to knowledge/bookmarks/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/network/references/contact-template.md to network/contacts/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/network/references/interaction-template.md to network/interactions/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-life/references/daily-note-template.md to journal/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-life/references/life-event-template.md to journal/events/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-life/references/health-entity-template.md to health/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/engineering-knowledge/references/adr-template.md to code/decisions/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/engineering-knowledge/references/debugging-template.md to code/debugging/_template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/engineering-knowledge/references/tech-debt-template.md to code/tech-debt/_template.md

Read each source file and write its contents to the destination. If a source template does not exist yet, skip it and note the skip in the summary.

5. Copy config templates

Copy the following config template files from the plugin into the vault as actual config files:

• ${CLAUDE_PLUGIN_ROOT}/skills/personal-identity/references/voice-template.md to identity/voice.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-identity/references/anti-patterns-template.md to identity/anti-patterns.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-identity/references/brand-template.md to brand/positioning.md
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-identity/references/values-template.yaml to identity/values.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-identity/references/bio-variants-template.md to identity/bio-variants.md
• ${CLAUDE_PLUGIN_ROOT}/skills/operations-memory/references/goals-template.yaml to operations/goals.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/operations-memory/references/heuristics-template.yaml to memory/heuristics.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/operations-memory/references/promotion-rules-template.yaml to workbench/promotion-rules.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/operations-memory/references/rhythms-template.yaml to operations/rhythms.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/operations-memory/references/active-contexts-template.yaml to workbench/active-contexts.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/network/references/circles-template.yaml to network/circles.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-life/references/routines-template.yaml to home/routines.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/personal-life/references/family-template.yaml to home/family.yaml
• ${CLAUDE_PLUGIN_ROOT}/skills/engineering-knowledge/references/patterns-template.md to code/patterns.md
• ${CLAUDE_PLUGIN_ROOT}/skills/engineering-knowledge/references/projects-template.yaml to code/projects.yaml

Read each source file and write its contents to the destination. If a source template does not exist yet, skip it and note the skip in the summary.

6. Copy platform templates

Copy the following platform draft templates from the plugin into content/drafts/templates/:

• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/blog-template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/linkedin-template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/newsletter-template.md
• ${CLAUDE_PLUGIN_ROOT}/skills/content-pipeline/assets/templates/thread-template.md

Keep the original filenames. If a source template does not exist yet, skip it and note the skip in the summary.

7. Create CLAUDE.md

Create CLAUDE.md at the vault root with the following content:

# Brain OS — [Your Name]

## TL;DR
[2-3 sentences: who you are, what you do, what this vault is for]

## About
[Expand on your professional identity, current focus, goals]

## Repo Map
This is a Personal Brain OS markdown vault. Key directories:
- `identity/` — voice, values, anti-patterns, bios
- `brand/` — positioning, audience, pillars
- `content/` — ideas pipeline, published posts, drafts
- `knowledge/` — bookmarks, learning
- `code/` — ADRs, debugging log, tech debt, patterns
- `network/` — contacts, interactions, circles
- `operations/` — goals, metrics, rhythms, deadlines
- `memory/` — decisions, failures, experiences, heuristics
- `workbench/` — active contexts, promotion rules
- `journal/` — daily notes (merged wellness + reflection)
- `health/` — standalone health entities (encrypted)
- `home/` — routines, family

8. Create operations stubs

Create operations/todos.md with a heading and empty task list placeholder:

# Todos

<!-- Active tasks. Managed by Brain OS. -->

Create operations/deadlines.yaml with minimal placeholder structure:

# Upcoming deadlines
deadlines: []

9. Create brand and content stubs

Create brand/audience.yaml:

# Target audience segments
audiences: []

Create brand/pillars.yaml:

# Content / brand pillars
pillars: []

Create content/calendar.yaml:

# Content calendar
entries: []

10. Create .gitignore

Create .gitignore at the vault root:

.DS_Store
.obsidian/workspace.json
.obsidian/workspace-mobile.json
*.swp
*~

11. Set up git-crypt

Check if git-crypt is installed by running which git-crypt. If it is installed:

1. Run git-crypt init inside the vault directory.
2. Copy .gitattributes from ${CLAUDE_PLUGIN_ROOT}/assets/gitcrypt/.gitattributes-template to the vault root as .gitattributes. If the source file does not exist, create a sensible default .gitattributes that encrypts health/**, journal/**, and network/contacts/**.

If git-crypt is not installed: warn the user that git-crypt is not available, encryption is not configured, and they should install it later and run git-crypt init manually.

12. Create example entity files

Create one sample entity file alongside each _template.md to show users what a filled-in entity looks like:

• network/contacts/jane-doe.md — a sample contact with realistic placeholder data (name, email, company, notes, tags).
• content/ideas/example-idea.md — a sample idea with a title, status, summary, and tags.
• memory/decisions/example-decision.md — a sample decision record with context, decision, consequences, and date.

Use the corresponding _template.md structure for each example, filling in plausible placeholder values.

13. Initial git commit

Stage all files with git add -A and commit with the message: Initial Brain OS vault scaffold.

14. Print summary

Print a summary for the user that includes:

• The vault location (absolute path)
• Total number of directories created
• Total number of files created
• Whether git-crypt encryption was configured
• Any templates that were skipped because the source did not exist
• Next steps: fill in CLAUDE.md with personal info, populate identity/voice.md and identity/values.yaml, add contacts and ideas