vault-setup

name	vault-setup
description	Interactive Obsidian vault configurator. Asks the user to describe themselves in free text, then builds a personalized vault structure, CLAUDE.md, and slash commands directly in the current directory.

Vault Setup — Obsidian Configurator

Run from INSIDE the folder you want to become your Obsidian vault.

STEP 1 — One question, free text

Display this message exactly, then wait for their response:

---

Tell me about yourself in a few sentences so I can build your vault.

Answer these in whatever order feels natural:

• What do you do for work?
• What falls through the cracks most — what do you wish you tracked better?
• Work only, or personal life too?
• Do you have existing files to import? (PDFs, docs, slides)

No need to be formal. A few sentences is enough.

---

STEP 2 — Infer and preview, don't ask more questions

From their free-text answer, infer:

• Their role (business owner / developer / consultant / creator / student)
• Their primary pain point
• Scope (work only / work + personal / full life OS)
• Whether they have existing files

Then show a vault preview. Do NOT ask clarifying questions. Make smart inferences.

Here's your vault — ready to build when you are.

📁 [current directory name]
├── inbox/          Drop zone — everything new lands here first
├── daily/          Daily brain dumps and quick captures
├── [folder]/       [purpose based on their role]
├── [folder]/       [purpose based on their role]
├── [folder]/       [purpose based on their role]
├── projects/       Active work with status and next actions
└── archive/        Completed work — never deleted, just moved

Slash commands:
  /daily    — start your day with vault context
  /tldr     — save any session to the right folder
  /[role]   — [role-specific one-liner]

Type "build it" to create this, or tell me what to change.

Wait for confirmation before building anything.

STEP 3 — Build after confirmation

Once they say "build it", "yes", "go", "looks good", or similar:

Create folders

mkdir -p inbox daily [role folders] projects archive scripts \
  .claude/skills/daily .claude/skills/tldr .claude/skills/[role-command]

Role folder sets:

• Business Owner → people/ operations/ decisions/
• Developer → research/ clients/
• Consultant → clients/ research/
• Creator → content/ research/ clients/
• Student → notes/ research/

If personal scope → also personal/

Open in Obsidian

open -a Obsidian "$(pwd)"

Write CLAUDE.md

Write directly to CLAUDE.md in the current directory:

# CLAUDE.md — [inferred role]'s Second Brain

## Who I Am
[2-3 sentences based on what they told you — specific, personal, written in first person as Claude describing its owner]

## My Vault Structure
[folder tree with one-line purpose per folder]

## How I Work
[3-4 bullet points inferred from their answers — capture style, main pain point, scope, what they want from AI]

## Context Rules
When I mention a decision → check [decisions or relevant folder] first
When I mention a person/client/project → look in [relevant folder]
When I ask you to write → read recent daily/ notes to match my voice
When something lands in inbox/ → ask if I want it sorted now

Write skill files

.claude/skills/daily/SKILL.md: Read today's daily note or create one. Check inbox/ for unprocessed files. Surface top 3 priorities. Ask: "What are we working on today?"

.claude/skills/tldr/SKILL.md: Summarize this conversation: decisions, things to remember, next actions. Save to the most relevant folder. Update memory.md.

Role-specific skill:

• Business Owner → .claude/skills/standup/SKILL.md — briefing across projects, decisions, people
• Developer → .claude/skills/project/SKILL.md — load a project's full context
• Consultant → .claude/skills/client/SKILL.md — load a client's full context
• Creator → .claude/skills/content/SKILL.md — read content folder, calibrate voice, develop idea
• Student → .claude/skills/research/SKILL.md — pull all notes on a topic, synthesize

Write memory.md

# Memory

## Session Log
[Updated by Claude Code after each session]

## My Preferences
[Added as Claude learns them]

STEP 4 — Context injection question

After building, ask:

One last thing — how do you want your vault context loaded into Claude Code?

1. Global (recommended) — adds one line to ~/.claude/CLAUDE.md so your vault 
   context loads automatically in every Claude Code session on this machine
2. Manual — I'll give you the line to paste into specific projects when you need it
3. Vault only — works automatically when you run claude from inside this folder

If global: Append to ~/.claude/CLAUDE.md (create if needed):

## My Personal Context
At the start of every session, read [absolute vault path]/CLAUDE.md for context about who I am, my work, and my conventions.

STEP 5 — Final output

Done. Your vault is live in Obsidian.

One manual step left:
  Obsidian → Settings → General → Enable Command Line Interface

Your slash commands:
  /daily    — run this tomorrow morning
  /tldr     — run this at the end of any session
  /[role]   — [one liner]

Have files to import?
  python scripts/process_docs_to_obsidian.py ~/your-files inbox/
  Then: "Sort everything in inbox/ into the right folders"