diff options
| author | sillylaird <sillyfanboy@gmail.com> | 2026-09-03 00:33:59 +0000 |
|---|---|---|
| committer | sillylaird <sillyfanboy@gmail.com> | 2026-09-03 00:33:59 +0000 |
| commit | 898b52edcb47bcb3e9d6106e74ca73e74ea01e70 (patch) | |
| tree | 85c6ee5ad58b860144551184d4cf86b560c62b91 /.agents/skills/obsidian-project-bootstrap/references/BOOTSTRAP-RUNBOOK.md | |
| download | www-main.tar.gz www-main.zip | |
Diffstat (limited to '')
| -rw-r--r-- | .agents/skills/obsidian-project-bootstrap/references/BOOTSTRAP-RUNBOOK.md | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/.agents/skills/obsidian-project-bootstrap/references/BOOTSTRAP-RUNBOOK.md b/.agents/skills/obsidian-project-bootstrap/references/BOOTSTRAP-RUNBOOK.md new file mode 100644 index 0000000..597f59c --- /dev/null +++ b/.agents/skills/obsidian-project-bootstrap/references/BOOTSTRAP-RUNBOOK.md @@ -0,0 +1,27 @@ +# Bootstrap Runbook + +## Preflight decisions + +1. Run `detect` first. +2. If the repo is already bound, stop and reuse the existing project. +3. If the repo is not research-like, stop and ask for confirmation instead of forcing bootstrap. +4. If `OBSIDIAN_VAULT_PATH` is missing, request it explicitly. + +## Common failure modes + +- `vault path missing` -> require explicit path or environment variable. +- `already bound` -> do not rebuild by default. +- `repo not research-like` -> do not create a vault structure automatically without confirmation. +- `python interpreter mismatch` -> run with the available interpreter and state the path used. + +## Post-bootstrap verification + +Check for these minimum artifacts: +- `.claude/project-memory/registry.yaml` +- `.claude/project-memory/<project_id>.md` +- `Research/{project-slug}/00-Hub.md` +- `Research/{project-slug}/01-Plan.md` +- `Research/{project-slug}/Knowledge/Source-Inventory.md` +- `Research/{project-slug}/Knowledge/Codebase-Overview.md` + +If the project still feels empty after bootstrap, continue with agent-first synthesis instead of adding placeholder notes. |
