📝 Gremlins Phase 3 trunk notes

This commit is contained in:
2026-10-16 18:44:28 +02:00
parent 242935f90c
commit f95f58c167
2 changed files with 11 additions and 1 deletions
@@ -648,7 +648,7 @@ Release gating keeps 0.3.0 unreleased until Linux and macOS lift their gates, so
### A8. Three more routed text items (§2.6, §7.1, §7.7)
- (a) `preamble.md` no longer points at `plugins/spire/skills/implementation/references/run-log.md` (it does not resolve in other projects). Block 3.1 **inlines the handoff-note format** in `preamble.md`: the seven fields `Model`, `Start / end` (from `date`), `Done`, `Deviations from plan`, `Flagged for review`, `Left for later`, `Expected broken`, `Commits`, as a short bullet template.
- (a) `preamble.md` no longer points at `plugins/spire/skills/implementation/references/run-log.md` (it does not resolve in other projects). Block 3.1 **inlines the handoff-note format** in `preamble.md`: the fields `Model`, `Start / end` (from `date`), `Done`, `Deviations from plan`, `Flagged for review`, `Left for later`, `Expected broken`, `Commits`, as a short bullet template.
- (b) SKILL §6/§7: `stalled` together with `clock_jump` is a host suspend, not a hung gremlin; `wait` again before acting.
- (c) SKILL §6: an action per failure reason. `model_refused` → the model id is not admitted (`availableModels`), the user must change settings. `usage_limit` → plan usage hit; stop launching, flag it, hand back. `overloaded`, `api_error` → transient; `continue` once later, else flag. `prompt_too_long` → the base is too large; re-train or rebase smaller. `is_error`, `exit_code`, `no_result` → read `raw/<job>.err` and the note, `continue` once, else flag. `detach_failed`, `launch_error`, `supervisor_error` → helper or host problem; flag it, do not retry blindly.
- Add these three rows to the §7.7 checklist.