gbrain/templates/bootstrap/template-repo/README.md

gbrain agent workspace — template

This repository is the "Use this template" distribution artifact for a gbrain personal-agent workspace — the same file set gbrain bootstrap render produces, with every value still a {{TOKEN}} placeholder. Nothing in this tree is real data: your agent fills the placeholders from YOUR interview answers, on your machine.

Use this template

1. Click Use this template → Create a new repository, and make the new repository Private. The bootstrap flow refuses to put identity files in a public repository.

2. Clone your new repository, then open Claude Code or Codex (desktop app or CLI) in that folder.

3. Paste this into your agent:

   Read and follow every step of:
   https://raw.githubusercontent.com/garrytan/gbrain/latest-stable/BOOTSTRAP_FOR_AGENTS.md
   Goal: finish setting up this cloned template as my persistent personal
   agent, with gbrain as your memory. Interview me before writing any
   identity file — never invent answers. You are not done until
   `gbrain bootstrap verify` exits 0.
   

   Already running the gbrain CLI (bun install -g github:garrytan/gbrain#latest-stable)? Then the first step is always:

   gbrain bootstrap status
   

   bootstrap status hard-fails while this repository's origin is public, before any identity file lands.

What's in this tree

• agent.json — workspace manifest with initialized: false; gbrain bootstrap render flips it to true on your machine. That flag (never the file's mere presence) is what distinguishes a fresh template clone from a machine-two clone of a live workspace.
• Identity files (SOUL.md, USER.md, MEMORY.md, …) and operating contracts (AGENTS.md, HEARTBEAT.md, ACCESS_POLICY.md, GITHUB.md) — placeholder-only until your interview.
• .gitignore — pre-configured so the local brain database, env files, and machine-local state never reach this repository.

This README is generated by gbrain's release pipeline; edits made here are overwritten on the next gbrain release. The stamp at the top records the gbrain version that generated this tree — gbrain bootstrap status compares it to your installed binary and warns on skew.