forked from jason/echo
38 lines
2.2 KiB
Markdown
38 lines
2.2 KiB
Markdown
|
# Bootstrap Procedure
|
||
|
|
|
||
|
|
The ECHO vault ships its **own** `BOOTSTRAP.md` at the vault root — that file is the canonical preflight/repair manifest. This plugin defers to it rather than duplicating the logic.
|
||
|
|
|
||
|
|
## Normal case — vault already bootstrapped
|
||
|
|
|
||
|
|
ECHO was bootstrapped on 2026-06-05, so this is the expected path. At session start, read the in-vault manifest:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -s \
|
||
|
|
-H "Authorization: Bearer 241265fbe6830934a9a4ad3e69335f64a42153b663aa5b0017cb1ea1217b2bab" \
|
||
|
|
"https://echoapi.alwisp.com/vault/BOOTSTRAP.md"
|
||
|
|
```
|
||
|
|
|
||
|
|
If it returns content (200), the vault is set up. Skim its preflight checklist, then read `CLAUDE.md` for the operating contract and proceed with the loading procedure in `SKILL.md`. The in-vault `BOOTSTRAP.md` describes how to repair any missing folders/files; follow it if something is absent. **Never overwrite an existing file** during repair — generate only what is missing.
|
||
|
|
|
||
|
|
## Fresh-vault case — BOOTSTRAP.md returns 404
|
||
|
|
|
||
|
|
This would mean the REST API is pointed at an empty or wrong vault. Confirm with Jason once:
|
||
|
|
|
||
|
|
> "The ECHO vault looks empty — there's no `BOOTSTRAP.md`. That's unexpected (it was bootstrapped 2026-06-05). Is the REST API pointed at the right vault, or should I re-seed the scaffold?"
|
||
|
|
|
||
|
|
If a re-seed is wanted, create the minimum viable seed with `PUT` (the API creates intermediate directories automatically), then let the vault's own structure grow from there:
|
||
|
|
|
||
|
|
1. `CLAUDE.md` — operating contract and session protocol
|
||
|
|
2. `BOOTSTRAP.md` — preflight/repair manifest
|
||
|
|
3. `STRUCTURE.md` — layout, taxonomy, frontmatter standard
|
||
|
|
4. `index.md` — navigation hub
|
||
|
|
5. `_agent/memory/semantic/operator-preferences.md` — operator profile (no fabricated facts)
|
||
|
|
6. `_agent/context/current-context.md` — empty context bundle
|
||
|
|
7. `inbox/captures/inbox.md` — capture file
|
||
|
|
|
||
|
|
Prefer copying the full prepared scaffold over reconstructing it by hand — the canonical scaffold lives in `F:\CODING\echo\.references\goldbrain-obsidian\` (adapt operator references to Jason).
|
||
|
|
|
||
|
|
## After bootstrap
|
||
|
|
|
||
|
|
Tell Jason briefly what was created, append a line to the daily note's **Agent Log**, and write a session log in `_agent/sessions/`. Do not over-explain — he can browse the vault.
|