refactor: overhaul workflow prompts with progressive loading

[parsakhaz]

The workflow entrypoints bundled every phase, dispatch command, and diagram recipe into the initial skill load. They also required unnecessary setup and branch-creation pauses. This applies Eric Provencher's guidance while preserving Orchestra's execution and evidence contracts.

What changes

• Turn both /do entrypoints into approximately 90-line routers. Keep execution boundaries, stage procedures, and output formats in linked references loaded when needed.
• Separate Codex dispatch mechanics and diagram publishing/design/rendering guidance from discovery and routing.
• Shorten Claude skill and agent descriptions while preserving role tools, model defaults, and invocation metadata.
• Create isolated work branches as part of authorized work; preflight only relevant dependencies and reuse valid checks on unchanged inputs.
• Keep continuation through review, QA, and wrap-up explicit. Preserve production-action grants, review budgets, detached-dispatch recovery, current-attempt manifests, and tracker/evidence handoff rules.
• Remove mandatory calls to absent arena/hillclimb skills and preserve their optional use with bounded fallback behavior.
• Update contributor guidance, consumer scaffolding, and the browser contract test to follow the new stage locations.

Most reference-file additions are moved instructions. Claude/Codex-specific browser and review-budget behavior remains distinct.

Verification

• Browser publication contract: 2 tests passed.
• Detached dispatch fixture: parent-exit survival, watchdog exit 142, and concurrent marker uniqueness passed.
• Daemon TypeScript check passed. Validation ran on the available Node 24 runtime; deployment remains configured for Node 22.
• Changed frontmatter and relative-reference checks passed.
• Disposable consumer sync: all 122 mirrored files matched canonical sources, and a second sync was identical.
• Disposable combined Orchestra/Parsa user install: routed references, namespace collision handling, reviewer rewrites, personal-file preservation, and repeat idempotence passed.
• Independent local code-review pass found no blockers. Its user-level PR-format path finding was fixed.
• Remote Git tree matches the validated local tree exactly.

Documentation and diagrams

• Refresh the root README, Claude/Codex catalogs, shared-reference guide, Excalidraw README, and WORKFLOW.md to describe stage loading, current installation behavior, and separate harness routing.
• Correct retired role names and smoke-test routing in the Claudex guide; identify the Codex Overseer as its own main session.
• Rebuild the current workflow map and refresh the software-factory story. Keep source and PNG pairs together, and document regeneration in the visual index.
• Follow-up validation: 77 relative Markdown links checked, both diagram sources parsed, and both PNGs rendered with Excalidraw's SVG exporter and inspected. The shared story assets match Skills byte for byte.

The default local Chromium renderer could not launch in this environment. Rendering used the same Excalidraw 0.18 export API with its bundled fonts and native SVG rasterization. No renderer or dependency changes are included.

Limits

No live daemon run, production mutation, or consumer rollout was performed. Existing consumers receive these changes through their normal sync PR flow.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-06T06:33:51.078769Z	7df02bb	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7df02bb4a3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Preserve loaded artifacts when switching worktrees

When /do starts from a local-only ./tmp/<id>/brief.html on the default branch with unrelated edits, Step 0 loads the item into the current checkout before these lines create an isolated worktree. Because tmp/ is ignored and worktree-local, the new worktree will not contain the brief, its refs, or the plan path required by subsequent stages, and a local-only item cannot be fetched again from a tracker. Select the execution worktree before loading the item, or explicitly transfer the complete scratch bundle into the new worktree.

AGENTS.md reference: AGENTS.md:L75-L78

Useful? React with 👍 / 👎.