# System Manual

> Short router for runtime, lifecycle, identity, Agent/Project relocation, refresh transactions, presets, settings, update/mismatch diagnosis, LLM adapters, and operating procedures.

- Skill: `lingtai-ai/system-manual` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lingtai-ai/system-manual`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lingtai-ai/system-manual/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lingtai-ai (https://skillmd.com/u/lingtai-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lingtai-ai/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, soul, 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`.

