create-egregore 0.19.25 → 0.19.27

package/assets/egregore-launcher.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// egregore-launcher-version: 0.19.25
+// egregore-launcher-version: 0.19.27
 //
 // egregore — launch and browse Egregore instances from your terminal.
 // Installed by create-egregore. Reads ~/.egregore/instances.json.
@@ -33,7 +33,7 @@ const crypto = require("node:crypto");
 const { spawnSync, spawn } = require("node:child_process");
 const readline = require("node:readline");
 
-const VERSION = "0.19.25";
+const VERSION = "0.19.27";
 const REGISTRY = path.join(os.homedir(), ".egregore", "instances.json");
 const DEFAULT_FILE = path.join(os.homedir(), ".egregore", "default");
 const UPDATE_CACHE_FILE = path.join(os.homedir(), ".egregore", "update-check.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-egregore",
-  "version": "0.19.25",
+  "version": "0.19.27",
   "description": "Set up Egregore for your team in one command — installs the egregore launcher and your choice of Claude Code, Codex, or Pi.",
   "license": "MIT",
   "bin": {

package/runtime/codex/.codex/skills/branch/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: branch
+description: 'Fallback Codex adapter for the Egregore branch workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore branch Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/branch/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/commit/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: commit
+description: 'Fallback Codex adapter for the Egregore commit workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore commit Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/commit/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/pr/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: pr
+description: 'Fallback Codex adapter for the Egregore pr workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore pr Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/pr/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/pull/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: pull
+description: 'Fallback Codex adapter for the Egregore pull workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore pull Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/pull/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/push/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: push
+description: 'Fallback Codex adapter for the Egregore push workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore push Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/push/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/review-pr/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: review-pr
+description: 'Fallback Codex adapter for the Egregore review-pr workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore review-pr Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading `.claude/skills/review-pr/SKILL.md`, reproduce the same visible UX in Codex:
+
+- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
+  exact confirmation blocks, and "no preamble" rules from the source skill.
+- Use the source skill's frame width, section order, labels, status footer,
+  and examples as the contract for the final response.
+- Never replace a required box/table/card/artifact view with a prose summary
+  unless the user explicitly asks for a summary.
+- When the source says to output a TUI box directly, paste that box as the
+  visible response, preferably in a `text` fenced block.
+- Never show raw JSON, raw command output, or unformatted script output when
+  the source skill requires formatted status or rendered output.
+
+1. Read `.claude/skills/review-pr/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/codex/.codex/skills/the-spiral/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: the-spiral
+description: Run a Codex-native structured Socratic dialogue when the user invokes /the-spiral or $the-spiral to turn an intuition into rigorous, communicable output.
+---
+
+# The Spiral
+
+Native Codex Egregore skill. The Spiral is a stateful Socratic process for
+developing, pressure-testing, and compressing a complex thesis.
+
+## Setup
+
+Gather three inputs, using structured Codex question tooling when available and
+plain one-at-a-time questions otherwise:
+
+1. Domain: what are we spiraling on?
+2. Purpose: what should the process produce?
+3. Known areas: what domains must be covered, if any?
+
+Create state files:
+
+```text
+spiral_state.json
+spiral_artifacts/ring1
+spiral_artifacts/ring2
+spiral_artifacts/ring3
+spiral_artifacts/ring4
+spiral_artifacts/ring5
+```
+
+State includes domain, purpose, addressable space, current ring, current loop,
+artifacts, emerged domains, parked threads, descents, and ring history.
+
+## Rings
+
+1. Seed: find the irreducible claim. Artifact:
+   `spiral_artifacts/ring1/seed.md`.
+2. Territory: map implications, tensions, contradictions, and open questions.
+   Artifact: `spiral_artifacts/ring2/territory.md`.
+3. Encounter: ground claims in reality. Research facts when needed and write
+   domain artifacts under `spiral_artifacts/ring3/`.
+4. Crucible: test objections and disconfirming evidence. Artifact:
+   `spiral_artifacts/ring4/crucible.md`.
+5. Compression: produce the final deliverables under
+   `spiral_artifacts/ring5/`.
+
+Ask one question at a time. After each alignment check, update
+`spiral_state.json`. Render a compact text progress view only at setup,
+alignment checks, ring transitions, descents, resume, and completion.
+
+## TUI Rendering
+
+Structured UX parity is required. The Spiral must present state as a structured
+terminal view at phase boundaries, not as loose paragraphs:
+
+- Show rings 1-5 with current/completed/parked status.
+- Show current thesis, emerged domains, parked threads, descents, and next
+  question or alignment check.
+- Render only at setup, alignment checks, ring transitions, descents, resume,
+  and completion.
+- On completion, render a final structured view with rings completed, loop
+  count, deliverable paths, emerged domains, and parked threads.
+- Do not render mid-flow while asking a Socratic question.
+
+## Flow Rules
+
+- If the user gives a marketing-like answer in Ring 1, push toward the real
+  conviction.
+- If an objection breaks an earlier assumption, offer a descent to the right
+  ring and record the reason.
+- Research is active only when factual claims need grounding or pressure.
+- Never force a domain that has not emerged from the user's answers.
+- If the user is tired or wants to pause, crystallize the current state and
+  stop at an alignment boundary.
+
+## Resume
+
+If `spiral_state.json` exists, summarize domain, ring, loop, and current
+artifacts, then ask whether to continue or start fresh.
+
+## Completion
+
+The process ends when Ring 5 deliverables satisfy the user. Report artifact
+paths, rings completed, loop count, emerged domains, and any parked threads.

package/runtime/codex/manifest.json

@@ -1,12 +1,14 @@
 {
   "source": "egregore-runtime",
   "policy": "available OSS components selected by capability-distribution.json; Connect is an authenticated additive overlay",
-  "skillCount": 31,
+  "skillCount": 38,
   "skills": [
     "activity",
     "announce",
     "archive",
+    "branch",
     "checkup",
+    "commit",
     "contribute",
     "dark-mode",
     "dashboard",
@@ -22,12 +24,17 @@
     "meeting",
     "note",
     "onboarding",
+    "pr",
+    "pull",
+    "push",
     "quest",
     "reflect",
+    "review-pr",
     "save",
     "sync-repos",
     "telemetry",
     "test",
+    "the-spiral",
     "tui-design",
     "tutorial",
     "update",
@@ -46,7 +53,9 @@
     ".codex/skills/activity/SKILL.md",
     ".codex/skills/announce/SKILL.md",
     ".codex/skills/archive/SKILL.md",
+    ".codex/skills/branch/SKILL.md",
     ".codex/skills/checkup/SKILL.md",
+    ".codex/skills/commit/SKILL.md",
     ".codex/skills/contribute/SKILL.md",
     ".codex/skills/dark-mode/SKILL.md",
     ".codex/skills/dashboard/SKILL.md",
@@ -63,12 +72,17 @@
     ".codex/skills/meeting/SKILL.md",
     ".codex/skills/note/SKILL.md",
     ".codex/skills/onboarding/SKILL.md",
+    ".codex/skills/pr/SKILL.md",
+    ".codex/skills/pull/SKILL.md",
+    ".codex/skills/push/SKILL.md",
     ".codex/skills/quest/SKILL.md",
     ".codex/skills/reflect/SKILL.md",
+    ".codex/skills/review-pr/SKILL.md",
     ".codex/skills/save/SKILL.md",
     ".codex/skills/sync-repos/SKILL.md",
     ".codex/skills/telemetry/SKILL.md",
     ".codex/skills/test/SKILL.md",
+    ".codex/skills/the-spiral/SKILL.md",
     ".codex/skills/tui-design/SKILL.md",
     ".codex/skills/tutorial/SKILL.md",
     ".codex/skills/update/SKILL.md",

package/runtime/pi/.codex/skills/branch/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: branch
+description: 'Fallback Codex adapter for the Egregore branch workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore branch Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/branch/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/commit/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: commit
+description: 'Fallback Codex adapter for the Egregore commit workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore commit Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/commit/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/pr/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: pr
+description: 'Fallback Codex adapter for the Egregore pr workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore pr Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/pr/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/pull/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: pull
+description: 'Fallback Codex adapter for the Egregore pull workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore pull Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/pull/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/push/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: push
+description: 'Fallback Codex adapter for the Egregore push workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore push Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+1. Read `.claude/skills/push/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/review-pr/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: review-pr
+description: 'Fallback Codex adapter for the Egregore review-pr workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore review-pr Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+`Other:` option and wait for the user.
+
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading `.claude/skills/review-pr/SKILL.md`, reproduce the same visible UX in Codex:
+
+- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
+  exact confirmation blocks, and "no preamble" rules from the source skill.
+- Use the source skill's frame width, section order, labels, status footer,
+  and examples as the contract for the final response.
+- Never replace a required box/table/card/artifact view with a prose summary
+  unless the user explicitly asks for a summary.
+- When the source says to output a TUI box directly, paste that box as the
+  visible response, preferably in a `text` fenced block.
+- Never show raw JSON, raw command output, or unformatted script output when
+  the source skill requires formatted status or rendered output.
+
+1. Read `.claude/skills/review-pr/SKILL.md` for the workflow details.
+2. Run the referenced `bin/` scripts directly from Codex.
+3. Treat graph and publish steps as best-effort unless that workflow explicitly
+   says they are required.
+4. For every external notification, follow
+   `.claude/context/notification-consent.md`: plan without sending, then show
+   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
+   consent from the workflow request or a batch approval.
+5. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when `egregore.json` declares `"mode": "local"`.
+6. Never call the deprecated `egregore-handoff` CLI for Egregore project
+   handoffs.

package/runtime/pi/.codex/skills/the-spiral/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: the-spiral
+description: Run a Codex-native structured Socratic dialogue when the user invokes /the-spiral or $the-spiral to turn an intuition into rigorous, communicable output.
+---
+
+# The Spiral
+
+Native Codex Egregore skill. The Spiral is a stateful Socratic process for
+developing, pressure-testing, and compressing a complex thesis.
+
+## Setup
+
+Gather three inputs, using structured Codex question tooling when available and
+plain one-at-a-time questions otherwise:
+
+1. Domain: what are we spiraling on?
+2. Purpose: what should the process produce?
+3. Known areas: what domains must be covered, if any?
+
+Create state files:
+
+```text
+spiral_state.json
+spiral_artifacts/ring1
+spiral_artifacts/ring2
+spiral_artifacts/ring3
+spiral_artifacts/ring4
+spiral_artifacts/ring5
+```
+
+State includes domain, purpose, addressable space, current ring, current loop,
+artifacts, emerged domains, parked threads, descents, and ring history.
+
+## Rings
+
+1. Seed: find the irreducible claim. Artifact:
+   `spiral_artifacts/ring1/seed.md`.
+2. Territory: map implications, tensions, contradictions, and open questions.
+   Artifact: `spiral_artifacts/ring2/territory.md`.
+3. Encounter: ground claims in reality. Research facts when needed and write
+   domain artifacts under `spiral_artifacts/ring3/`.
+4. Crucible: test objections and disconfirming evidence. Artifact:
+   `spiral_artifacts/ring4/crucible.md`.
+5. Compression: produce the final deliverables under
+   `spiral_artifacts/ring5/`.
+
+Ask one question at a time. After each alignment check, update
+`spiral_state.json`. Render a compact text progress view only at setup,
+alignment checks, ring transitions, descents, resume, and completion.
+
+## TUI Rendering
+
+Structured UX parity is required. The Spiral must present state as a structured
+terminal view at phase boundaries, not as loose paragraphs:
+
+- Show rings 1-5 with current/completed/parked status.
+- Show current thesis, emerged domains, parked threads, descents, and next
+  question or alignment check.
+- Render only at setup, alignment checks, ring transitions, descents, resume,
+  and completion.
+- On completion, render a final structured view with rings completed, loop
+  count, deliverable paths, emerged domains, and parked threads.
+- Do not render mid-flow while asking a Socratic question.
+
+## Flow Rules
+
+- If the user gives a marketing-like answer in Ring 1, push toward the real
+  conviction.
+- If an objection breaks an earlier assumption, offer a descent to the right
+  ring and record the reason.
+- Research is active only when factual claims need grounding or pressure.
+- Never force a domain that has not emerged from the user's answers.
+- If the user is tired or wants to pause, crystallize the current state and
+  stop at an alignment boundary.
+
+## Resume
+
+If `spiral_state.json` exists, summarize domain, ring, loop, and current
+artifacts, then ask whether to continue or start fresh.
+
+## Completion
+
+The process ends when Ring 5 deliverables satisfy the user. Report artifact
+paths, rings completed, loop count, emerged domains, and any parked threads.

package/runtime/pi/manifest.json

@@ -1,12 +1,14 @@
 {
   "source": "egregore-pi-meta-harness",
   "policy": "Pi-native lifecycle layer over the available OSS Codex skill corpus",
-  "skillCount": 31,
+  "skillCount": 38,
   "skills": [
     "activity",
     "announce",
     "archive",
+    "branch",
     "checkup",
+    "commit",
     "contribute",
     "dark-mode",
     "dashboard",
@@ -22,12 +24,17 @@
     "meeting",
     "note",
     "onboarding",
+    "pr",
+    "pull",
+    "push",
     "quest",
     "reflect",
+    "review-pr",
     "save",
     "sync-repos",
     "telemetry",
     "test",
+    "the-spiral",
     "tui-design",
     "tutorial",
     "update",
@@ -45,7 +52,9 @@
     ".codex/skills/activity/SKILL.md",
     ".codex/skills/announce/SKILL.md",
     ".codex/skills/archive/SKILL.md",
+    ".codex/skills/branch/SKILL.md",
     ".codex/skills/checkup/SKILL.md",
+    ".codex/skills/commit/SKILL.md",
     ".codex/skills/contribute/SKILL.md",
     ".codex/skills/dark-mode/SKILL.md",
     ".codex/skills/dashboard/SKILL.md",
@@ -62,12 +71,17 @@
     ".codex/skills/meeting/SKILL.md",
     ".codex/skills/note/SKILL.md",
     ".codex/skills/onboarding/SKILL.md",
+    ".codex/skills/pr/SKILL.md",
+    ".codex/skills/pull/SKILL.md",
+    ".codex/skills/push/SKILL.md",
     ".codex/skills/quest/SKILL.md",
     ".codex/skills/reflect/SKILL.md",
+    ".codex/skills/review-pr/SKILL.md",
     ".codex/skills/save/SKILL.md",
     ".codex/skills/sync-repos/SKILL.md",
     ".codex/skills/telemetry/SKILL.md",
     ".codex/skills/test/SKILL.md",
+    ".codex/skills/the-spiral/SKILL.md",
     ".codex/skills/tui-design/SKILL.md",
     ".codex/skills/tutorial/SKILL.md",
     ".codex/skills/update/SKILL.md",