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 |
| Action discipline, authorization, collaboration, or deliverables |
procedures manual |
| Any refresh transaction: same-runtime reload, preset swap/revert, source/venv cutover, or failure recovery |
refresh pre-check |
Update/source/install/nudge/mismatch diagnosis and cutover handoff, including source_drift |
runtime update checks |
| Settings and SHOW ownership |
settings inventory |
| Environment variables and runtime controls |
environment variables |
| Provider transport and adapter behavior |
LLM adapters |
Pooling several Codex accounts, or migrating a removed codex-pool config |
subs-pool |
| SQLite traces and log queries |
SQLite log query |
| Trajectory mining and recurring patterns |
trajectory mining |
| Goal lifecycle and goal records |
goal manual |
| Agent or Project address/workdir rename or relocation (mechanical cutover) |
migration-guide |
| External attach diagnostics |
external-attach diagnostic |
| ToolFamily/plugin settings |
ToolFamily settings |
| 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; meta (input={}) is the
read-only on-demand full runtime snapshot — the per-result tail carries only
time, context size and active warnings — and neither refreshes, molts, nor
consumes one-shot events; 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.
notification owns reads, hooks, and delay (delivery is one-shot); 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.
1---2name: system-manual3description: >4 Short router for runtime, lifecycle, identity, Agent/Project relocation,5 refresh transactions, presets, settings, update/mismatch diagnosis, LLM6 adapters, and operating procedures.7version: 1.25.08last_changed_at: "2026-09-29T00:00:00Z"9tags: [lingtai, agent, project, workdir, relocation, runtime, procedures, substrate, system, lifecycle, alarm, memory, communication, skills, settings, molt, summarize, nudge, updates, refresh, preset, llm, adapters, codex, websocket]10related_files:11- src/lingtai/prompts/substrate/substrate.md12- src/lingtai/prompts/procedures/procedures.md13- src/lingtai/kernel/base_agent/lifecycle.py14- src/lingtai/tools/system/karma.py15- src/lingtai/tools/system/schema.py16- src/lingtai/tools/system/CONTRACT.md17- src/lingtai/tools/system/ANATOMY.md18- src/lingtai/tools/system/settings.py19- src/lingtai/kernel/nudge/ANATOMY.md20- src/lingtai/intrinsic_skills/system-manual/reference/llm-adapters/SKILL.md21- src/lingtai/intrinsic_skills/system-manual/reference/subs-pool/SKILL.md22- src/lingtai/intrinsic_skills/system-manual/reference/refresh-precheck/SKILL.md23- src/lingtai/intrinsic_skills/system-manual/reference/runtime-update-checks/SKILL.md24- src/lingtai/intrinsic_skills/system-manual/reference/migration-guide/SKILL.md25- src/lingtai/intrinsic_skills/system-manual/reference/external-attach-diagnostic/SKILL.md26- src/lingtai/llm/_register.py27- src/lingtai/llm/openai/adapter.py28- src/lingtai/intrinsic_skills/system-manual/reference/tool-plugin-settings/SKILL.md29- src/lingtai/intrinsic_skills/system-manual/reference/settings-inventory/SKILL.md30maintenance: |31 Tracks the routed source/resources it summarizes; keep refresh-precheck as the32 single refresh-transaction owner and runtime-update-checks as the update,33 source, install, nudge, and mismatch owner.34metadata:35 source: https://skillmd.com/skills/lingtai-ai/system-manual36---3738# System Manual — Task Router3940`system-manual` routes System's lifecycle, identity, presets, settings, and peer41controls. Schema owns action names, fields, and types;42read one route below for unfamiliar or consequential work.4344## Task routes4546| Task | Read |47|---|---|48| Runtime/lifecycle, alarms, MCP, memory, presets, or peer recovery | [substrate manual](reference/substrate-manual/SKILL.md) |49| Action discipline, authorization, collaboration, or deliverables | [procedures manual](reference/procedures-manual/SKILL.md) |50| Any refresh transaction: same-runtime reload, preset swap/revert, source/venv cutover, or failure recovery | [refresh pre-check](reference/refresh-precheck/SKILL.md) |51| Update/source/install/nudge/mismatch diagnosis and cutover handoff, including `source_drift` | [runtime update checks](reference/runtime-update-checks/SKILL.md) |52| Settings and SHOW ownership | [settings inventory](reference/settings-inventory/SKILL.md) |53| Environment variables and runtime controls | [environment variables](reference/environment-variables/SKILL.md) |54| Provider transport and adapter behavior | [LLM adapters](reference/llm-adapters/SKILL.md) |55| Pooling several Codex accounts, or migrating a removed `codex-pool` config | [subs-pool](reference/subs-pool/SKILL.md) |56| SQLite traces and log queries | [SQLite log query](reference/sqlite-log-query/SKILL.md) |57| Trajectory mining and recurring patterns | [trajectory mining](reference/trajectory-mining/SKILL.md) |58| Goal lifecycle and goal records | [goal manual](reference/goal-manual/SKILL.md) |59| Agent or Project address/workdir rename or relocation (mechanical cutover) | [migration-guide](reference/migration-guide/SKILL.md) |60| External attach diagnostics | [external-attach diagnostic](reference/external-attach-diagnostic/SKILL.md) |61| ToolFamily/plugin settings | [ToolFamily settings](reference/tool-plugin-settings/SKILL.md) |62| Context, notification, MCP, shell, daemon, avatar, skills, or knowledge | Read that owning tool's manual; System does not own its procedure. |6364## Everyday use6566Use `action` with only that action's `input` fields and a short `reasoning`;67`summarize` is optional. Fetch the installed manual with68`system(action="manual", input={})` and keep it unsummarized. `settings` is69read-only and its `comment` points to the owner; `meta` (`input={}`) is the70read-only on-demand full runtime snapshot — the per-result tail carries only71time, context size and active warnings — and neither refreshes, molts, nor72consumes one-shot events; `presets` is allowed-only, so73pass an exact returned path. Availability is not authority. Normal waiting is74IDLE; positive `sleep.delay` is only a last-resort alarm without a reliable75completion notification, and pending notifications require intentional `force`.76`name_set` is immutable, `name_nickname` mutable, and neither moves the77address/workdir. Route mechanical Agent/Project address or workdir movement78through [migration-guide](reference/migration-guide/SKILL.md).79`notification` owns reads, hooks, and delay (delivery is one-shot); `context` owns summarize/rebuild/molt and80provider replay.8182## Consequential use8384- **Refresh/preset:** `reference/refresh-precheck/SKILL.md` is the single85 owner of same-runtime reload, preset swap/revert, source/venv cutover, and86 failure recovery: one targeted preflight, exactly one refresh, and one87 targeted receipt. Route update/source/install/nudge/mismatch diagnosis through88 `reference/runtime-update-checks/SKILL.md` first. Refresh never installs,89 upgrades, fetches, or repairs code.90- **Peer recovery:** use the exact target working-directory address within authority and91 diagnose/communicate first. `lull`, `interrupt`, `suspend`, `cpr`, and `clear`92 require `admin.karma=True`; `nirvana` also requires `admin.nirvana=True` and93 permanently destroys the target. Read `reference/substrate-manual/SKILL.md`.9495### Cache-miss budget9697`system-manual#cache-miss-budget` remains an alias for98`reference/settings-inventory/SKILL.md#cache-miss-budget`; query SHOW first.99100### Runtime policy (v2)101102`system-manual#runtime-policy-v2` remains an alias for103`reference/settings-inventory/SKILL.md#runtime-policy-v2-document-shape`.
