Psyche
Psyche is the read-only public root for pad + lingtai + knowledge + skills.
Routine schema-sufficient calls may go directly to their action. For unfamiliar
or consequential work, read the matching domain manual first; use this router
only if the domain is unclear. There is no required router-then-domain double read.
Routing table
Call (strict input={}) |
Returns / owner |
psyche(action="pad", input={}, reasoning="load Pad guidance") |
Pad manual: system/pad.md, system/pad_append.json |
psyche(action="lingtai", input={}, reasoning="load identity guidance") |
LingTai manual: system/lingtai.md |
psyche(action="knowledge", input={}, reasoning="load knowledge guidance") |
Knowledge manual: knowledge/<name>/KNOWLEDGE.md |
psyche(action="skills", input={}, reasoning="load skills guidance") |
Skills manual: .library/{intrinsic,custom}/ and configured paths |
psyche(action="settings", input={}, reasoning="inspect Psyche settings") |
redacted settings SHOW |
psyche(action="manual", input={}, reasoning="load the routing table") |
this router |
All six actions require strict empty input and are read-only: no authoring,
editing, pinning, installing, migration, catalog rescan, or prompt reload. Keep
root summarize=false when exact guidance matters.
One mutation model
Change durable content with file.write (full rewrite) or file.edit (exact
replacement) on its owning path, then apply one
context(action="rebuild", input={}, reasoning="apply durable changes") (or let
refresh/molt reconstruct). File mutation never hot-loads; there is no per-domain
reload, and Skills/Knowledge retain catalog ownership.
Lifecycle and settings
context owns molt, summarize, and rebuild; system owns lifecycle
controls and mechanical names. LingTai owns self-authored character guidance.
settings is SHOW-only, fully redacted, and reports the last successful applied
snapshot. Read the settings reference for grammar,
precedence, timing, rollback, and all eight anchors.
Setting pad
settings reference
Setting pad file
settings reference
Setting base prompt
settings reference
Setting base prompt file
settings reference
Setting covenant
settings reference
Setting covenant file
settings reference
Setting comment
settings reference
Setting comment file
settings reference
Network rules protocol (.rules)
.rules is a separate heartbeat signal, not a Psyche action or rebuild API. Read
the network-rules reference before using it;
its atomic write, consumption, replacement, and verification hazards differ from
ordinary file→rebuild.
1---2name: psyche-manual3description: Compact router for Psyche's four durable domains (pad, lingtai, knowledge, skills), the shared file→rebuild model, redacted settings, and the separate `.rules` heartbeat reference.4---56# Psyche78Psyche is the read-only public root for **pad + lingtai + knowledge + skills**.9Routine schema-sufficient calls may go directly to their action. For unfamiliar10or consequential work, read the matching domain manual first; use this router11only if the domain is unclear. There is no required router-then-domain double read.1213## Routing table1415| Call (strict `input={}`) | Returns / owner |16|---|---|17| `psyche(action="pad", input={}, reasoning="load Pad guidance")` | Pad manual: `system/pad.md`, `system/pad_append.json` |18| `psyche(action="lingtai", input={}, reasoning="load identity guidance")` | LingTai manual: `system/lingtai.md` |19| `psyche(action="knowledge", input={}, reasoning="load knowledge guidance")` | Knowledge manual: `knowledge/<name>/KNOWLEDGE.md` |20| `psyche(action="skills", input={}, reasoning="load skills guidance")` | Skills manual: `.library/{intrinsic,custom}/` and configured paths |21| `psyche(action="settings", input={}, reasoning="inspect Psyche settings")` | redacted settings SHOW |22| `psyche(action="manual", input={}, reasoning="load the routing table")` | this router |2324All six actions require strict empty `input` and are read-only: no authoring,25editing, pinning, installing, migration, catalog rescan, or prompt reload. Keep26root `summarize=false` when exact guidance matters.2728## One mutation model2930Change durable content with `file.write` (full rewrite) or `file.edit` (exact31replacement) on its owning path, then apply one32`context(action="rebuild", input={}, reasoning="apply durable changes")` (or let33refresh/molt reconstruct). File mutation never hot-loads; there is no per-domain34reload, and Skills/Knowledge retain catalog ownership.3536## Lifecycle and settings3738`context` owns `molt`, `summarize`, and `rebuild`; `system` owns lifecycle39controls and mechanical names. LingTai owns self-authored character guidance.40`settings` is SHOW-only, fully redacted, and reports the last successful applied41snapshot. Read [the settings reference](reference/settings/SKILL.md) for grammar,42precedence, timing, rollback, and all eight anchors.4344### Setting pad45[settings reference](reference/settings/SKILL.md#setting-pad)4647### Setting pad file48[settings reference](reference/settings/SKILL.md#setting-pad-file)4950### Setting base prompt51[settings reference](reference/settings/SKILL.md#setting-base-prompt)5253### Setting base prompt file54[settings reference](reference/settings/SKILL.md#setting-base-prompt-file)5556### Setting covenant57[settings reference](reference/settings/SKILL.md#setting-covenant)5859### Setting covenant file60[settings reference](reference/settings/SKILL.md#setting-covenant-file)6162### Setting comment63[settings reference](reference/settings/SKILL.md#setting-comment)6465### Setting comment file66[settings reference](reference/settings/SKILL.md#setting-comment-file)6768## Network rules protocol (`.rules`)6970`.rules` is a separate heartbeat signal, not a Psyche action or rebuild API. Read71the [network-rules reference](reference/network-rules/SKILL.md) before using it;72its atomic write, consumption, replacement, and verification hazards differ from73ordinary file→rebuild.
lingtai-ai