create-egregore 0.19.5 → 0.19.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/assets/egregore-launcher.js +411 -25
  2. package/bin/cli.js +34 -20
  3. package/lib/local.js +21 -5
  4. package/lib/pi-runtime.js +186 -0
  5. package/lib/setup.js +56 -11
  6. package/lib/ui.js +1 -1
  7. package/package.json +7 -5
  8. package/runtime/codex/.codex/spec-manifest.json +1 -1
  9. package/runtime/codex/AGENTS.md +7 -2
  10. package/runtime/codex/bin/codex-render-spec.mjs +6 -1
  11. package/runtime/codex/bin/codex-session-start.sh +5 -59
  12. package/runtime/codex/bin/codex-skill-render.mjs +7 -5
  13. package/runtime/codex/bin/lib/context.sh +8 -1
  14. package/runtime/codex/bin/lib/greeting.sh +12 -108
  15. package/runtime/codex/bin/lib/metrics.sh +374 -0
  16. package/runtime/codex/bin/publish-artifact.sh +14 -0
  17. package/runtime/codex/bin/settings.sh +274 -0
  18. package/runtime/codex/manifest.json +2 -0
  19. package/runtime/pi/.codex/config.toml +15 -0
  20. package/runtime/pi/.codex/hooks/branch-guard.js +242 -0
  21. package/runtime/pi/.codex/hooks/search-hint.js +65 -0
  22. package/runtime/pi/.codex/hooks.json +30 -0
  23. package/runtime/pi/.codex/skills/activity/SKILL.md +70 -0
  24. package/runtime/pi/.codex/skills/add/SKILL.md +25 -0
  25. package/runtime/pi/.codex/skills/announce/SKILL.md +54 -0
  26. package/runtime/pi/.codex/skills/answer/SKILL.md +25 -0
  27. package/runtime/pi/.codex/skills/archive/SKILL.md +41 -0
  28. package/runtime/pi/.codex/skills/ask/SKILL.md +59 -0
  29. package/runtime/pi/.codex/skills/branch/SKILL.md +25 -0
  30. package/runtime/pi/.codex/skills/checkup/SKILL.md +41 -0
  31. package/runtime/pi/.codex/skills/commit/SKILL.md +25 -0
  32. package/runtime/pi/.codex/skills/contribute/SKILL.md +25 -0
  33. package/runtime/pi/.codex/skills/dark-mode/SKILL.md +25 -0
  34. package/runtime/pi/.codex/skills/dashboard/SKILL.md +59 -0
  35. package/runtime/pi/.codex/skills/deep-reflect/SKILL.md +74 -0
  36. package/runtime/pi/.codex/skills/delete-user/SKILL.md +25 -0
  37. package/runtime/pi/.codex/skills/egregore-voice/SKILL.md +25 -0
  38. package/runtime/pi/.codex/skills/emissary/SKILL.md +41 -0
  39. package/runtime/pi/.codex/skills/env/SKILL.md +25 -0
  40. package/runtime/pi/.codex/skills/handoff/SKILL.md +67 -0
  41. package/runtime/pi/.codex/skills/harvest/SKILL.md +107 -0
  42. package/runtime/pi/.codex/skills/ingest/SKILL.md +25 -0
  43. package/runtime/pi/.codex/skills/ingest-google/SKILL.md +25 -0
  44. package/runtime/pi/.codex/skills/ingest-user-interview/SKILL.md +41 -0
  45. package/runtime/pi/.codex/skills/invite/SKILL.md +40 -0
  46. package/runtime/pi/.codex/skills/issue/SKILL.md +41 -0
  47. package/runtime/pi/.codex/skills/me/SKILL.md +25 -0
  48. package/runtime/pi/.codex/skills/meeting/SKILL.md +41 -0
  49. package/runtime/pi/.codex/skills/minion/SKILL.md +25 -0
  50. package/runtime/pi/.codex/skills/note/SKILL.md +25 -0
  51. package/runtime/pi/.codex/skills/onboarding/SKILL.md +41 -0
  52. package/runtime/pi/.codex/skills/pr/SKILL.md +25 -0
  53. package/runtime/pi/.codex/skills/project/SKILL.md +41 -0
  54. package/runtime/pi/.codex/skills/pull/SKILL.md +25 -0
  55. package/runtime/pi/.codex/skills/push/SKILL.md +25 -0
  56. package/runtime/pi/.codex/skills/quest/SKILL.md +77 -0
  57. package/runtime/pi/.codex/skills/quest-suggest/SKILL.md +25 -0
  58. package/runtime/pi/.codex/skills/reflect/SKILL.md +41 -0
  59. package/runtime/pi/.codex/skills/review-pr/SKILL.md +41 -0
  60. package/runtime/pi/.codex/skills/save/SKILL.md +62 -0
  61. package/runtime/pi/.codex/skills/scroll/SKILL.md +168 -0
  62. package/runtime/pi/.codex/skills/scroll/agents/openai.yaml +4 -0
  63. package/runtime/pi/.codex/skills/scroll/assets/shell.html +542 -0
  64. package/runtime/pi/.codex/skills/search/SKILL.md +56 -0
  65. package/runtime/pi/.codex/skills/session-view/SKILL.md +25 -0
  66. package/runtime/pi/.codex/skills/setup/SKILL.md +25 -0
  67. package/runtime/pi/.codex/skills/summon/SKILL.md +41 -0
  68. package/runtime/pi/.codex/skills/sync-repos/SKILL.md +25 -0
  69. package/runtime/pi/.codex/skills/telegram-connect/SKILL.md +25 -0
  70. package/runtime/pi/.codex/skills/telemetry/SKILL.md +25 -0
  71. package/runtime/pi/.codex/skills/test/SKILL.md +41 -0
  72. package/runtime/pi/.codex/skills/the-spiral/SKILL.md +84 -0
  73. package/runtime/pi/.codex/skills/thread/SKILL.md +25 -0
  74. package/runtime/pi/.codex/skills/todo/SKILL.md +41 -0
  75. package/runtime/pi/.codex/skills/tui-design/SKILL.md +41 -0
  76. package/runtime/pi/.codex/skills/tutorial/SKILL.md +41 -0
  77. package/runtime/pi/.codex/skills/update/SKILL.md +25 -0
  78. package/runtime/pi/.codex/skills/view/SKILL.md +156 -0
  79. package/runtime/pi/.codex/skills/view/agents/openai.yaml +4 -0
  80. package/runtime/pi/.codex/skills/view/assets/compose-scaffold.html +221 -0
  81. package/runtime/pi/.codex/skills/visual-explain/SKILL.md +41 -0
  82. package/runtime/pi/.codex/skills/wrap/SKILL.md +55 -0
  83. package/runtime/pi/.codex/spec-manifest.json +114 -0
  84. package/runtime/pi/.pi/APPEND_SYSTEM.md +255 -0
  85. package/runtime/pi/.pi/extensions/egregore.ts +324 -0
  86. package/runtime/pi/.pi/settings.json +6 -0
  87. package/runtime/pi/.pi/spec-manifest.json +12 -0
  88. package/runtime/pi/AGENTS.md +350 -0
  89. package/runtime/pi/bin/activity-data.sh +242 -0
  90. package/runtime/pi/bin/agent.sh +677 -0
  91. package/runtime/pi/bin/codex-install-skills.sh +78 -0
  92. package/runtime/pi/bin/codex-render-spec.mjs +394 -0
  93. package/runtime/pi/bin/codex-session-start.sh +188 -0
  94. package/runtime/pi/bin/codex-skill-render.mjs +323 -0
  95. package/runtime/pi/bin/codex-sync-skills.sh +227 -0
  96. package/runtime/pi/bin/dashboard-data.sh +178 -0
  97. package/runtime/pi/bin/graph-batch.sh +60 -0
  98. package/runtime/pi/bin/graph-op.sh +431 -0
  99. package/runtime/pi/bin/graph-wal.sh +228 -0
  100. package/runtime/pi/bin/graph.sh +177 -0
  101. package/runtime/pi/bin/handoff-pr-backfill.sh +86 -0
  102. package/runtime/pi/bin/handoff-run.sh +581 -0
  103. package/runtime/pi/bin/handoff-save-egregore.sh +136 -0
  104. package/runtime/pi/bin/index-handoff.sh +312 -0
  105. package/runtime/pi/bin/lib/artifact-id.sh +46 -0
  106. package/runtime/pi/bin/lib/config.sh +71 -0
  107. package/runtime/pi/bin/lib/context.sh +542 -0
  108. package/runtime/pi/bin/lib/dashboard-artifact.sh +142 -0
  109. package/runtime/pi/bin/lib/ensure-develop.sh +183 -0
  110. package/runtime/pi/bin/lib/git-sync.sh +288 -0
  111. package/runtime/pi/bin/lib/greeting.sh +340 -0
  112. package/runtime/pi/bin/lib/hash.sh +13 -0
  113. package/runtime/pi/bin/lib/identity.sh +174 -0
  114. package/runtime/pi/bin/lib/metrics.sh +374 -0
  115. package/runtime/pi/bin/lib/permissions.sh +106 -0
  116. package/runtime/pi/bin/lib/time.sh +56 -0
  117. package/runtime/pi/bin/lib/worktree-links.sh +54 -0
  118. package/runtime/pi/bin/notify.sh +207 -0
  119. package/runtime/pi/bin/pi-branch-policy.mjs +15 -0
  120. package/runtime/pi/bin/pi-product-workflows.mjs +324 -0
  121. package/runtime/pi/bin/pi-render-spec.mjs +114 -0
  122. package/runtime/pi/bin/pi-session-start.sh +24 -0
  123. package/runtime/pi/bin/publish-artifact.sh +201 -0
  124. package/runtime/pi/bin/publish-references.sh +144 -0
  125. package/runtime/pi/bin/repo-state.sh +99 -0
  126. package/runtime/pi/bin/telemetry.sh +391 -0
  127. package/runtime/pi/bin/worktree-create.sh +118 -0
  128. package/runtime/pi/bin/worktree-remove.sh +50 -0
  129. package/runtime/pi/bin/worktree.sh +198 -0
  130. package/runtime/pi/manifest.json +176 -0
@@ -0,0 +1,41 @@
1
+ ---
2
+ name: checkup
3
+ description: 'Fallback Codex adapter for the Egregore checkup workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore checkup Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ ## Structured UX parity
19
+
20
+ This workflow has a Claude skill with user-visible structured output. After
21
+ reading `.claude/skills/checkup/SKILL.md`, reproduce the same visible UX in Codex:
22
+
23
+ - Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
24
+ exact confirmation blocks, and "no preamble" rules from the source skill.
25
+ - Use the source skill's frame width, section order, labels, status footer,
26
+ and examples as the contract for the final response.
27
+ - Never replace a required box/table/card/artifact view with a prose summary
28
+ unless the user explicitly asks for a summary.
29
+ - When the source says to output a TUI box directly, paste that box as the
30
+ visible response, preferably in a `text` fenced block.
31
+ - Never show raw JSON, raw command output, or unformatted script output when
32
+ the source skill requires formatted status or rendered output.
33
+
34
+ 1. Read `.claude/skills/checkup/SKILL.md` for the workflow details.
35
+ 2. Run the referenced `bin/` scripts directly from Codex.
36
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
37
+ explicitly says they are required.
38
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
39
+ calls when `egregore.json` declares `"mode": "local"`.
40
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
41
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: commit
3
+ description: 'Fallback Codex adapter for the Egregore commit workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore commit Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/commit/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: contribute
3
+ description: 'Fallback Codex adapter for the Egregore contribute workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore contribute Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/contribute/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: dark-mode
3
+ description: 'Use when generating or modifying any visual output that renders in a browser or artifact viewer: HTML pages, CSS, React SSR components, Egregore artifacts, markdown renderers, web components, design-system tokens, Tailwind themes, or standalone demos. Triggers on requests involving dark mode, theme toggles, color systems, card surfaces, browser rendering, or visual polish. The load-bearing lesson: if React SSR emits an inline hex color through `style={}`, CSS dark-mode overrides cannot reach it, so every theme-sensitive color must be emitted as `var(--token)` rather than a resolved hex. Do not use for TUI output, plain markdown files, or non-visual code.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore dark-mode Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/dark-mode/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,59 @@
1
+ ---
2
+ name: dashboard
3
+ description: Show the current user's Egregore dashboard, recent sessions, open threads, and current work from Codex when the user invokes /dashboard or $dashboard, or asks for their dashboard.
4
+ ---
5
+
6
+ # Egregore Dashboard
7
+
8
+ Native Codex Egregore skill. Render the personal dashboard immediately from
9
+ `bin/dashboard-data.sh` and the shared renderer.
10
+
11
+ ## Flow
12
+
13
+ 1. Map user range words to ISO-ish ranges:
14
+ - empty or `week` -> `P7D`
15
+ - `today` -> `P1D`
16
+ - `month` -> `P30D`
17
+ - `all` -> `P365D`
18
+ 2. Run `bash bin/dashboard-data.sh "" "$TIME_RANGE"` with network escalation
19
+ and capture stdout as JSON. This command performs the graph API call
20
+ internally; a normal sandboxed Codex shell can make a healthy graph look
21
+ unreachable.
22
+ 3. Classify graph status:
23
+
24
+ ```bash
25
+ node bin/codex-skill-render.mjs classify-graph --mode connected
26
+ ```
27
+
28
+ If the network-enabled command still returns `retry` because the reason is
29
+ `unreachable`, render the filesystem fallback and mention that the graph service
30
+ was unreachable after a network-enabled attempt. If network escalation is denied
31
+ or unavailable, run the command without escalation, render the fallback, and
32
+ say Codex graph network access was not granted; do not claim the graph itself
33
+ was unreachable.
34
+
35
+ 4. Render:
36
+
37
+ ```bash
38
+ node bin/codex-skill-render.mjs dashboard-card <json-file>
39
+ ```
40
+
41
+ Paste the rendered card exactly in the visible response, preferably in a
42
+ `text` fenced block. Do not paraphrase the card into bullets unless the user
43
+ asks for a summary.
44
+
45
+ 5. End with a compact next-action prompt. Use structured Codex question
46
+ tooling when available; otherwise render numbered choices plus `Other:`.
47
+
48
+ ## Rules
49
+
50
+ - Never show raw JSON.
51
+ - Do not narrate each command step unless something blocks the workflow; the
52
+ final visible response should lead with the rendered card.
53
+ - Structured UX parity is required: preserve the rendered dashboard TUI card,
54
+ no preamble, no prose-only replacement, and no raw collector output.
55
+ - Do not call `bin/graph.sh` directly; `bin/dashboard-data.sh` is the data
56
+ boundary.
57
+ - In local mode, do not mention graph setup; memory files are the source of
58
+ truth.
59
+ - Do not use Claude Code commands.
@@ -0,0 +1,74 @@
1
+ ---
2
+ name: deep-reflect
3
+ description: Cross-reference an insight against the Egregore knowledge base using Codex-native staged analysis when the user invokes /deep-reflect or $deep-reflect.
4
+ ---
5
+
6
+ # Egregore Deep Reflect
7
+
8
+ Native Codex Egregore skill. Use this for evidence-based analysis of how a new
9
+ insight relates to the existing knowledge base.
10
+
11
+ ## Modes
12
+
13
+ - empty request: deep mode.
14
+ - `focused ...`: focused topic mode.
15
+ - `quick ...` or `category: content`: quick mode.
16
+
17
+ Detect directed questions when the user asks how, why, what something means, or
18
+ about a relationship. Preserve the user's lens while still surfacing important
19
+ signals outside the lens.
20
+
21
+ ## Flow
22
+
23
+ 1. Check `egregore.json` mode first. In local mode, do a lightweight reflection
24
+ from memory files and do not call graph, batch graph, or notification
25
+ scripts.
26
+ 2. In all modes, run `bin/agent.sh search "$TOPIC" -n 6` — hybrid content
27
+ recall over the whole memory repo. Feed strong hits into the candidate
28
+ set; in local mode this is the primary context source.
29
+ 3. In connected mode, additionally gather graph context with `bin/graph.sh`
30
+ and suppress raw JSON. Query recent sessions, active quests, recent
31
+ artifacts, decisions, the topic landscape, and the full artifact
32
+ landscape.
33
+ 4. If the graph is unavailable or has fewer than about ten artifacts, fall back
34
+ to lightweight reflection and say why in one line.
35
+ 5. Select candidate artifacts. Prefer title, type, topics, quest, author, and
36
+ date metadata first; fetch file contents only for the selected subset.
37
+ 6. Use Codex multi-agent or subagent tooling only if it is available in the
38
+ current session. If not, run a single-model staged analysis:
39
+ - candidate selection summary
40
+ - evidence extraction summary
41
+ - signal analysis
42
+ - final synthesis
43
+ 7. Classify signals as tension, convergence, gap, dependency, phase shift,
44
+ redundancy, emergence, reinforcement, or a named custom type.
45
+ 8. Write a markdown artifact under `memory/knowledge/deep-reflect/` with
46
+ frontmatter for run id, mode, lens, author, created time, and selected
47
+ evidence paths.
48
+ 9. In connected mode, write best-effort graph edges with `bin/graph.sh` or
49
+ `bin/graph-batch.sh`. Use `TENSION_WITH` for conflict signals and
50
+ `RELATES_TO` for other signals.
51
+ 10. Save memory and repo changes with `bin/agent.sh save --message "Deep reflect: $TOPIC" --topic "$TOPIC"`.
52
+
53
+ ## Output
54
+
55
+ Lead with the strongest finding, then list primary signals, evidence paths, and
56
+ recommended next action. Keep secondary and ambient signals short.
57
+
58
+ Structured UX parity is required. Then render the Egregore deep-reflect
59
+ confirmation TUI:
60
+
61
+ - Use a 72-column outer box with standard top/separator/content/bottom lines.
62
+ - Header: `DEEP REFLECT`, author, and date.
63
+ - Body: lens/topic, strongest finding, signal counts by type, selected evidence
64
+ count, artifact path, and recommended next action.
65
+ - Footer: saved/pushed state. In connected mode include graph-link state when
66
+ available; in local mode omit graph language.
67
+ - Do not show raw graph JSON or replace the confirmation box with plain prose.
68
+
69
+ ## Rules
70
+
71
+ - Never show raw graph JSON.
72
+ - Do not claim evidence you did not inspect.
73
+ - Keep intermediate summaries explicit so the user can audit the reasoning.
74
+ - Do not use Claude Code commands.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: delete-user
3
+ description: 'Fallback Codex adapter for the Egregore delete-user workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore delete-user Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/delete-user/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: egregore-voice
3
+ description: 'Use when writing any external communication for Egregore — essays, launch posts, website copy, announcements, README prose, social content, or any text that represents Egregore to the world. Triggers on: ''write this for the site'', ''draft the announcement'', ''help me write this essay'', ''landing page copy'', ''external post'', ''blog post'', ''Archive Fever'', ''write in my voice'', or any task producing text that an outside reader will see. Do NOT use for internal docs, CLAUDE.md files, handoffs, code comments, or technical specs — those have their own conventions. This skill prevents vanilla AI slop and ensures all external output reflects the manuscriptic, architecturally precise, philosophically grounded voice of Egregore.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore egregore-voice Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/egregore-voice/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,41 @@
1
+ ---
2
+ name: emissary
3
+ description: 'Compose, send, or run an Egregore emissary — portable handoff v1 artifacts with server-rendered HTML at egregore.xyz. Use for `/emissary`, "make/send/run an emissary", or when a user pastes an `egregore.xyz/emissary/e/<id>` link.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore emissary Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ ## Structured UX parity
19
+
20
+ This workflow has a Claude skill with user-visible structured output. After
21
+ reading `.claude/skills/emissary/SKILL.md`, reproduce the same visible UX in Codex:
22
+
23
+ - Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
24
+ exact confirmation blocks, and "no preamble" rules from the source skill.
25
+ - Use the source skill's frame width, section order, labels, status footer,
26
+ and examples as the contract for the final response.
27
+ - Never replace a required box/table/card/artifact view with a prose summary
28
+ unless the user explicitly asks for a summary.
29
+ - When the source says to output a TUI box directly, paste that box as the
30
+ visible response, preferably in a `text` fenced block.
31
+ - Never show raw JSON, raw command output, or unformatted script output when
32
+ the source skill requires formatted status or rendered output.
33
+
34
+ 1. Read `.claude/skills/emissary/SKILL.md` for the workflow details.
35
+ 2. Run the referenced `bin/` scripts directly from Codex.
36
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
37
+ explicitly says they are required.
38
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
39
+ calls when `egregore.json` declares `"mode": "local"`.
40
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
41
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: env
3
+ description: 'Fallback Codex adapter for the Egregore env workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore env Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/env/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,67 @@
1
+ ---
2
+ name: handoff
3
+ description: Create an internal Egregore team handoff when the user invokes /handoff or $handoff, says they are done, asks to hand off work, or wants to pass context to a teammate or future self.
4
+ ---
5
+
6
+ # Egregore Handoff
7
+
8
+ Native Codex Egregore skill. This creates an internal team handoff in
9
+ `memory/handoffs/`, indexes it, publishes it when possible, and notifies through
10
+ the Egregore scripts. External runnable packets are emissaries; if the user
11
+ asks for one or provides an `egregore.xyz/emissary/e/` link, use the emissary
12
+ tooling instead.
13
+
14
+ ## Flow
15
+
16
+ 1. Run `bin/agent.sh sync`.
17
+ 2. Resolve the author from `.egregore-state.json` `github_username`, then
18
+ `name`, then git config.
19
+ 3. Parse a short topic and optional recipient from the user request. Match the
20
+ recipient against `memory/people/*.md`; omit the recipient when uncertain.
21
+ 4. Draft the markdown body with these sections:
22
+ - `## Briefing`
23
+ - `## Key Decisions`
24
+ - `## Current State`
25
+ - `## Open Threads`
26
+ - `## Next Steps`
27
+ - `## Entry Points`
28
+ 5. Write the body to a temp file, then run one orchestration command:
29
+
30
+ ```bash
31
+ TMPDIR="$(mktemp -d -t codex-handoff-XXXXXX)"
32
+ TMPDIR="$TMPDIR" bash bin/handoff-run.sh --author "$AUTHOR" --topic "$TOPIC" ${RECIPIENT_ARG} < "$BODY_FILE"
33
+ ```
34
+
35
+ Use `--recipient "$RECIPIENT"` only when a clear teammate or future-self
36
+ recipient is known. Do not pass `--no-publish` or `--no-notify` unless the user
37
+ explicitly asked for a dry run.
38
+
39
+ 6. Read `$TMPDIR/handoff-run-result.json` and render:
40
+
41
+ ```bash
42
+ node bin/codex-skill-render.mjs handoff-card "$TMPDIR/handoff-run-result.json"
43
+ ```
44
+
45
+ Paste the rendered card exactly in the visible response, preferably in a
46
+ `text` fenced block. Do not paraphrase the card into bullets unless the user
47
+ asks for a summary.
48
+
49
+ 7. Fire the detached save helper when appropriate:
50
+
51
+ ```bash
52
+ ( bash bin/handoff-save-egregore.sh "$AUTHOR" "$TOPIC" >/dev/null 2>&1 & ) >/dev/null 2>&1
53
+ ```
54
+
55
+ 8. Report the `memory/...` path and hosted link from the result JSON when a
56
+ link exists.
57
+
58
+ ## Rules
59
+
60
+ - Do not call `egregore-handoff` for project handoffs.
61
+ - Do not use Claude Code commands.
62
+ - Keep the briefing concise and operational; include exact files, branches,
63
+ commands, open questions, and verification state when relevant.
64
+ - Structured UX parity is required: the rendered card is the acknowledgment.
65
+ Do not add a preamble such as "Handoff created successfully." Preserve the
66
+ 72-column TUI/card shape, status footer, links below the box, and warning
67
+ placement used by the Egregore handoff workflow.
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: harvest
3
+ description: Run an adaptive Egregore harvest from Codex when the user invokes /harvest or $harvest to elicit tacit context, preferences, positions, and team judgment.
4
+ ---
5
+
6
+ # Egregore Harvest
7
+
8
+ Native Codex Egregore skill. A harvest is a structured elicitation process that
9
+ turns tacit context into durable organizational memory.
10
+
11
+ ## Parse
12
+
13
+ Accept a topic plus optional flags:
14
+
15
+ - `--respondents a,b`
16
+ - `--seed path`
17
+ - `--resume id`
18
+ - `--mode blind|disclosed|comparative`
19
+
20
+ Resolve the initiator from `.egregore-state.json`, then git config. Mint IDs as
21
+ `harvest-YYYY-MM-DD-topic-slug` and
22
+ `harvest-YYYY-MM-DD-topic-slug-respondent`.
23
+
24
+ ## State
25
+
26
+ Markdown is canonical. Persist under:
27
+
28
+ ```text
29
+ memory/knowledge/harvests/{date}-{slug}/
30
+ manifest.md
31
+ sessions/{handle}.md
32
+ synthesis.md
33
+ ```
34
+
35
+ Single-respondent harvests may use one flat markdown file when that is simpler.
36
+ Every manifest records topic, intent, initiator, respondents, disclosure mode,
37
+ status, seed paths, and role-sheet assumptions.
38
+
39
+ Connected mode may also call `bin/graph-op.sh` helpers, but graph writes are
40
+ best-effort and must never block markdown state.
41
+
42
+ ## Process
43
+
44
+ 1. Sync memory with `bin/agent.sh sync`.
45
+ 2. If `--resume` is present, reload the manifest, sessions, and prior
46
+ evaluations before asking anything new.
47
+ 3. Build a role sheet for each respondent from `memory/people/*.md`, recent
48
+ handoffs, wraps, quests, and optionally graph context.
49
+ 4. Clarify the harvest intent when topic, respondents, dimensions, or
50
+ disclosure mode are under-specified. Use structured Codex question tooling
51
+ when available; otherwise ask one numbered question at a time with `Other:`.
52
+ 5. Ask situated questions. Each question must have an explicit
53
+ `question_intent` and must be grounded in the role sheet, seed, or prior
54
+ answers.
55
+ 6. Persist every turn immediately with turn number, question, intent, answer,
56
+ and evaluation. For absent respondents, create async questions with:
57
+
58
+ ```bash
59
+ bin/agent.sh ask --from "$INITIATOR" --to "$RESPONDENT" --topic "$TOPIC" --question "$QUESTION" --harvest-id "$HARVEST_ID" --harvest-session-id "$HARVEST_SESSION_ID" --turn "$TURN" --question-intent "$QUESTION_INTENT" --context-mode "$DISCLOSURE_MODE"
60
+ ```
61
+
62
+ 7. In connected mode, notify async respondents best-effort with
63
+ `bin/notify.sh send`.
64
+ 8. Continue until present respondents reach diminishing returns and async
65
+ respondents are either answered, pending, or explicitly skipped.
66
+
67
+ ## Synthesis
68
+
69
+ Write `synthesis.md` with:
70
+
71
+ - L0: compact portrait of the harvest.
72
+ - L1: useful patterns, preferences, constraints, and positions.
73
+ - L2: respondent or theme slices, chosen based on the material.
74
+ - L3: decisions, open questions, follow-ups, and reusable context.
75
+
76
+ Evidence should be attributed. Quotes support synthesized positions; they do
77
+ not replace them.
78
+
79
+ After synthesis, mark the manifest complete, commit and push memory:
80
+
81
+ ```bash
82
+ git -C memory add knowledge/harvests
83
+ git -C memory commit -m "harvest: $TOPIC" --quiet
84
+ git -C memory push origin main --quiet
85
+ ```
86
+
87
+ Emit telemetry best-effort in the background.
88
+
89
+ ## Output
90
+
91
+ Structured UX parity is required. When a harvest completes or checkpoints,
92
+ render the Egregore harvest TUI instead of a prose-only recap:
93
+
94
+ - Use a 72-column outer box with standard top/separator/content/bottom lines.
95
+ - Header: `HARVEST`, initiator, and date.
96
+ - Body: topic, respondents, disclosure mode, synthesis path, and a one-line
97
+ layer summary when available.
98
+ - Footer: harvested/synthesized/saved/pushed state and `Visible in /activity.`
99
+ - If graph writes are skipped or unavailable, reflect that in the footer
100
+ without saying the harvest failed when markdown was saved.
101
+
102
+ ## Rules
103
+
104
+ - Ask one question at a time for present respondents.
105
+ - Make low-confidence role assumptions visible when they shape questions.
106
+ - Local mode skips graph and notification calls.
107
+ - Do not use Claude Code commands.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: ingest
3
+ description: 'Fallback Codex adapter for the Egregore ingest workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore ingest Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/ingest/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: ingest-google
3
+ description: 'Fallback Codex adapter for the Egregore ingest-google workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore ingest-google Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ 1. Read `.claude/skills/ingest-google/SKILL.md` for the workflow details.
19
+ 2. Run the referenced `bin/` scripts directly from Codex.
20
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
21
+ explicitly says they are required.
22
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
23
+ calls when `egregore.json` declares `"mode": "local"`.
24
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
25
+ handoffs.
@@ -0,0 +1,41 @@
1
+ ---
2
+ name: ingest-user-interview
3
+ description: 'Fallback Codex adapter for the Egregore ingest-user-interview workflow.'
4
+ ---
5
+
6
+ <!-- generated-by: bin/codex-sync-skills.sh -->
7
+
8
+ # Egregore ingest-user-interview Adapter
9
+
10
+ This is fallback coverage for a long-tail Egregore workflow that has not been
11
+ ported to a hand-written Codex-native skill yet.
12
+
13
+ Use the project shell and filesystem directly. Do not invoke Claude Code
14
+ commands. Translate interactive choices to structured Codex question tooling
15
+ when it is available; otherwise render compact numbered choices with an
16
+ `Other:` option and wait for the user.
17
+
18
+ ## Structured UX parity
19
+
20
+ This workflow has a Claude skill with user-visible structured output. After
21
+ reading `.claude/skills/ingest-user-interview/SKILL.md`, reproduce the same visible UX in Codex:
22
+
23
+ - Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
24
+ exact confirmation blocks, and "no preamble" rules from the source skill.
25
+ - Use the source skill's frame width, section order, labels, status footer,
26
+ and examples as the contract for the final response.
27
+ - Never replace a required box/table/card/artifact view with a prose summary
28
+ unless the user explicitly asks for a summary.
29
+ - When the source says to output a TUI box directly, paste that box as the
30
+ visible response, preferably in a `text` fenced block.
31
+ - Never show raw JSON, raw command output, or unformatted script output when
32
+ the source skill requires formatted status or rendered output.
33
+
34
+ 1. Read `.claude/skills/ingest-user-interview/SKILL.md` for the workflow details.
35
+ 2. Run the referenced `bin/` scripts directly from Codex.
36
+ 3. Treat graph, publish, and notify steps as best-effort unless that workflow
37
+ explicitly says they are required.
38
+ 4. Keep local-mode behavior filesystem-first and avoid graph or notification
39
+ calls when `egregore.json` declares `"mode": "local"`.
40
+ 5. Never call the deprecated `egregore-handoff` CLI for Egregore project
41
+ handoffs.