Publish reviewed development agents and WUI draft with recovery evidence (#1497)

2026-09-08 17:15:03 -05:00
parent 3b7fd19d08
commit 29c1defe29
92 changed files with 10986 additions and 20 deletions
@@ -0,0 +1,39 @@
+# Rocko development TUI
+
+Run from any terminal:
+
+```sh
+/mnt/storage/src/mosaic-stack/agents/rocko/launch.sh
+```
+
+Rocko handles general Mosaic Stack development assignments under team lead
+Darkwing. The launcher opens Claude Code in the repository with `--model sonnet`
+and the display name Rocko. Sonnet is the selected CLI model alias; Rocko's
+project persona is supplied by SOUL.md, not a separate custom Claude agent.
+
+Use `--check` to validate the executable and context inputs without a model
+call. This does not verify authentication or account access to Sonnet. Claude
+Code uses its normal authentication, settings, permissions, and discovered
+resources; this script does not copy credentials or bypass permissions.
+
+Normal launches resume the exact Claude UUID recorded locally in
+`.pi/state/rocko/session-id`. First launch creates a UUID; `--fresh` creates
+another while retaining previous conversations in Claude's native storage.
+Each private launch receipt under `.pi/state/rocko/launches/` retains its UUID
+and context snapshot. The launcher lock refuses concurrent Rocko launches
+through this script; it does not lock sessions opened by other means.
+
+If Claude exits before saving its first conversation, or its history is
+removed, the saved UUID may not be resumable. Inspect the failure and use
+`--fresh` explicitly to start again. The launcher does not fall back to the
+latest unrelated project conversation. Old UUIDs in launch receipts can be
+opened manually with `claude --resume UUID` from the project directory.
+
+The prompt snapshot includes CONSTITUTION, STANDARDS, Rocko's SOUL, the live
+Mosaic user profile, root AGENTS.md, and Rocko's CONTEXT.md. `--soul FILE`,
+`--constitution FILE`, and `--user FILE` override individual inputs; relative
+paths resolve from the repository root. Missing or empty inputs refuse launch.
+The snapshot is appended to Claude's system prompt on each launch.
+
+This is a host development session, not a managed fleet registration. It
+loads no Pi goal extension. The user or team lead supplies the assignment.