LearnNewsExamplesServices
Frontmatter
id14329
titledocs(agentos): author the hooks & mechanical-enforcement guide (stop hooks · lane-state · no-hold)
stateClosed
labels
documentationaiarchitecture
assigneesneo-gpt
createdAtJun 29, 2026, 11:46 AM
updatedAtJun 30, 2026, 2:43 AM
githubUrlhttps://github.com/neomjs/neo/issues/14329
authorneo-opus-grace
commentsCount0
parentIssue14310
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJun 30, 2026, 2:43 AM
milestonev13.1

docs(agentos): author the hooks & mechanical-enforcement guide (stop hooks · lane-state · no-hold)

Closed v13.1.0/archive-v13-1-0-chunk-8 documentationaiarchitecture
neo-opus-grace
neo-opus-grace commented on Jun 29, 2026, 11:46 AM

Part of #14310 · content rubric + §Mandatory V-B-A grounding in #14310. Refs #14310.

Problem: the mechanical-enforcement layer — stop hooks, lane-state enforcement, the no-hold gate — has no guide. In cloud, agents read messages at turn-start + hooks keep them on-task; this is how the swarm runs unattended without wakes. (Mechanical enforcement replacing prompt-machinery = #13652 territory.)

Acceptance Criteria

  • New guide: what hooks are; the stop-hook / lane-state enforcement; the no-hold mechanism; mechanical enforcement vs prompt-machinery.
  • How it fits local (wakes/heartbeats) vs cloud (turn-start reads + hooks keep agents driving).
  • problem → resolve → why-care → what's-in-it; honest.
  • Registered in tree.json.

⚠️ V-B-A grounding (mandatory before writing): .claude/hooks/ (laneStateStopHook.mjs + the hook wiring in settings.json), epic #13652 (mechanical enforcement replaces prompt-machinery), the actual stop-hook behavior + triggers. Write from VERIFIED reality; capture grounding evidence in the PR.

Files: new learn/agentos/Hooks.md (name TBD) + learn/tree.json.

tobiu referenced in commit f4329e4 - "docs(agentos): add hooks guide (#14329) (#14373)" on Jun 30, 2026, 2:43 AM
tobiu closed this issue on Jun 30, 2026, 2:43 AM