Agent onboarding vault

A reference implementation of one onboarding prompt for any AI coding agent — Cursor, Claude Code, Windsurf, Copilot, and others.

Instead of committing IDE-specific config (.cursor/, .claude/, etc.), this repo keeps canonical rules and bootstrap instructions in git under .vault/. Each agent compiles its own local runtime on first use. Secrets stay on your machine.

Quick start

Paste this into a fresh agent session after cloning:

Go to .vault/agents and follow the onboarding instructions

The agent will wire up MCP servers, materialize rules and skills for its runtime, and locate the project docs — then wait for a task.

What's in .vault/

Zone	Purpose
agents/	Bootstrap playbooks, MCP setup, and version-controlled instructions
atlas/	Living architecture and feature documentation
archive/	Historical ADRs and superseded specs

Humans start at .vault/atlas/+home.md. Agents start at .vault/agents/README.md.

Core idea

Intent in git, runtime on disk. Rules and tool guardrails live in .vault/agents/instructions/. Onboarding compiles them into whatever your IDE expects — locally, gitignored, and disposable.