system-manual

# System Manual — Task Router `system-manual` routes System's lifecycle, identity, presets, settings, and peer controls. Schema owns action names, fields, and types; read one route below for unfamiliar or consequential work. ## Task routes | Task | Read | |---|---| | Runtime/lifecycle, alarms, MCP, memory, presets, or peer recovery | [substrate manual](reference/substrate-manual/SKILL.md) | | Action discipline, authorization, collaboration, or deliverables | [procedures manual](reference/procedures-manual/SKILL.md) | | Any refresh transaction: same-runtime reload, preset swap/revert, source/venv cutover, or failure recovery | [refresh pre-check](reference/refresh-precheck/SKILL.md) | | Update/source/install/nudge/mismatch diagnosis and cutover handoff, including `source_drift` | [runtime update checks](reference/runtime-update-checks/SKILL.md) | | Settings and SHOW ownership | [settings inventory](reference/settings-inventory/SKILL.md) | | Environment variables and runtime controls | [environment variables](reference/environment-variables/SKILL.md) | | Provider transport and adapter behavior | [LLM adapters](reference/llm-adapters/SKILL.md) | | SQLite traces and log queries | [SQLite log query](reference/sqlite-log-query/SKILL.md) | | Trajectory mining and recurring patterns | [trajectory mining](reference/trajectory-mining/SKILL.md) | | Goal lifecycle and goal records | [goal manual](reference/goal-manual/SKILL.md) | | Agent or Project address/workdir rename or relocation (mechanical cutover) | [migration-guide](reference/migration-guide/SKILL.md) | | External attach diagnostics | [external-attach diagnostic](reference/external-attach-diagnostic/SKILL.md) | | ToolFamily/plugin settings | [ToolFamily settings](reference/tool-plugin-settings/SKILL.md) | | Context, notification, MCP, shell, daemon, avatar, skills, or knowledge | Read that owning tool's manual; System does not own its procedure. | ## Everyday use Use `action` with only that action's `input` fields and a short `reasoning`; `summarize` is optional. Fetch the installed manual with `system(action="manual", input={})` and keep it unsummarized. `settings` is read-only and its `comment` points to the owner; `presets` is allowed-only, so pass an exact returned path. Availability is not authority. Normal waiting is IDLE; positive `sleep.delay` is only a last-resort alarm without a reliable completion notification, and pending notifications require intentional `force`. `name_set` is immutable, `name_nickname` mutable, and neither moves the address/workdir. Route mechanical Agent/Project address or workdir movement through [migration-guide](reference/migration-guide/SKILL.md). `notification` owns reads/dismissals; `context` owns summarize/rebuild/molt and provider replay. ## Consequential use - **Refresh/preset:** `reference/refresh-precheck/SKILL.md` is the single owner of same-runtime reload, preset swap/revert, source/venv cutover, and failure recovery: one targeted preflight, exactly one refresh, and one targeted receipt. Route update/source/install/nudge/mismatch diagnosis through `reference/runtime-update-checks/SKILL.md` first. Refresh never installs, upgrades, fetches, or repairs code. - **Peer recovery:** use the exact target working-directory address within authority and diagnose/communicate first. `lull`, `interrupt`, `suspend`, `cpr`, and `clear` require `admin.karma=True`; `nirvana` also requires `admin.nirvana=True` and permanently destroys the target. Read `reference/substrate-manual/SKILL.md`. ### Cache-miss budget `system-manual#cache-miss-budget` remains an alias for `reference/settings-inventory/SKILL.md#cache-miss-budget`; query SHOW first. ### Runtime policy (v2) `system-manual#runtime-policy-v2` remains an alias for `reference/settings-inventory/SKILL.md#runtime-policy-v2-document-shape`.