From 83feb7eb2efc39d6cb5876d9a39a615d2546b2a1 Mon Sep 17 00:00:00 2001
From: Ame <ame@AmedeMacBook-Pro.local>
Date: Mon, 1 Jun 2026 20:52:18 +0800
Subject: [PATCH 1/2] feat(workspaces): tell chat agents to hand finished work
 back via the inbox
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The chat workspace already exposes inbox_push (per-workspace MCP), but nothing
told the agent to use it — so the Inbox stayed empty. Add a line to the chat
instruction: when you finish something the user should see (a shortlist,
thesis, rotation snapshot, a decision), push it to their inbox with the file(s)
+ a short note. Activates the one-way workspace→user collaboration loop with no
new code — a prototype. The inbox renders the docs live, so pushed dossier
files keep updating as the agent CRUDs them.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/workspaces/templates/chat/files/CLAUDE.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/workspaces/templates/chat/files/CLAUDE.md b/src/workspaces/templates/chat/files/CLAUDE.md
index a87c3f73a..d86894133 100644
--- a/src/workspaces/templates/chat/files/CLAUDE.md
+++ b/src/workspaces/templates/chat/files/CLAUDE.md
@@ -14,3 +14,12 @@ To verify the wiring on first attach:
 Otherwise, use this workspace however you like. The CWD is its own git
 repo (commits stay local), and any files you create or edit are scoped
 to this workspace.
+
+## Handing work back to the user
+
+This workspace has an outbound channel to the user's Inbox (`inbox_push`).
+When you finish something the user should see — a shortlist, a thesis, a
+rotation snapshot, a decision you reached — push it to their inbox: the
+file(s) you produced plus a short note on what it is and why it matters.
+Don't make them come looking in the workspace; surface the result. (One-way
+for now — they read the inbox; they don't reply through it.)

From e8067607f908a7a21b6badd492532d85882ac8a0 Mon Sep 17 00:00:00 2001
From: Ame <ame@AmedeMacBook-Pro.local>
Date: Mon, 1 Jun 2026 21:03:11 +0800
Subject: [PATCH 2/2] =?UTF-8?q?refactor(workspaces):=20neutral=20instructi?=
 =?UTF-8?q?on.md=20source=20=E2=86=92=20copied=20to=20CLAUDE.md=20+=20AGEN?=
 =?UTF-8?q?TS.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Claude Code wants CLAUDE.md, Codex wants AGENTS.md — a standards turf war we
don't need to pick a side in. The launcher already wrote one composed result to
both filenames; this renames the single template SOURCE from CLAUDE.md to the
neutral instruction.md, so the source isn't named after either CLI. The
injector reads <template>/instruction.md and writes the composed (persona +
instruction) bytes to both CLAUDE.md and AGENTS.md. A third CLI = one more copy
target, no new source, no sync risk (there's still only one source).

Also hardened the injector golden to mirror the persona precedence
(data/brain/persona.md override → shipped default) so a live persona override
doesn't break the byte assertion.

tsc clean; full suite 1718; creation e2e green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/workspaces/context-injector.spec.ts           | 15 ++++++++++-----
 src/workspaces/context-injector.ts                | 15 +++++++++------
 src/workspaces/template-registry.ts               |  2 +-
 .../chat/files/{CLAUDE.md => instruction.md}      |  0
 .../files/{CLAUDE.md => instruction.md}           |  0
 5 files changed, 20 insertions(+), 12 deletions(-)
 rename src/workspaces/templates/chat/files/{CLAUDE.md => instruction.md} (100%)
 rename src/workspaces/templates/finance-research/files/{CLAUDE.md => instruction.md} (100%)

diff --git a/src/workspaces/context-injector.spec.ts b/src/workspaces/context-injector.spec.ts
index 52e42f118..f86578f49 100644
--- a/src/workspaces/context-injector.spec.ts
+++ b/src/workspaces/context-injector.spec.ts
@@ -14,7 +14,7 @@ import { fileURLToPath } from 'node:url';
 
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
-import { defaultPath } from '@/core/paths.js';
+import { dataPath, defaultPath } from '@/core/paths.js';
 
 import { injectWorkspaceContext } from './context-injector.js';
 import type { TemplateMeta } from './template-registry.js';
@@ -74,10 +74,15 @@ describe('injectWorkspaceContext — MCP', () => {
 });
 
 describe('injectWorkspaceContext — persona', () => {
-  it('composes persona + separator + template CLAUDE.md into CLAUDE.md and AGENTS.md', async () => {
-    const persona = await readFile(defaultPath('persona.default.md'), 'utf8');
-    const templateMd = await readFile(join(CHAT_FILES, 'CLAUDE.md'), 'utf8');
-    const expected = `${persona}\n\n---\n\n${templateMd}`;
+  it('composes persona + separator + template instruction into CLAUDE.md and AGENTS.md', async () => {
+    // Mirror the injector's persona precedence: a live data/brain/persona.md
+    // override wins over the shipped default.
+    const personaPath = existsSync(dataPath('brain', 'persona.md'))
+      ? dataPath('brain', 'persona.md')
+      : defaultPath('persona.default.md');
+    const persona = await readFile(personaPath, 'utf8');
+    const instruction = await readFile(join(CHAT_FILES, 'instruction.md'), 'utf8');
+    const expected = `${persona}\n\n---\n\n${instruction}`;
 
     await injectWorkspaceContext({
       template: makeTemplate({ injectPersona: true, filesDir: CHAT_FILES }),
diff --git a/src/workspaces/context-injector.ts b/src/workspaces/context-injector.ts
index 23138732f..de7f55778 100644
--- a/src/workspaces/context-injector.ts
+++ b/src/workspaces/context-injector.ts
@@ -52,13 +52,16 @@ export async function injectWorkspaceContext(opts: {
   }
 
   if (template.injectPersona) {
-    // Compose `persona + "\n\n---\n\n" + <template>/CLAUDE.md`, byte-identical
-    // to the old `compose_persona_claude_md`. A template that asks for persona
-    // injection but ships no CLAUDE.md is a misconfiguration — let the readFile
-    // throw so the create fails loudly (matches the old `exit 4`).
+    // One neutral instruction source (`<template>/instruction.md`), composed
+    // with the persona, then written byte-identically to BOTH CLAUDE.md (Claude
+    // Code's filename) and AGENTS.md (Codex's). The CLIs disagree on the
+    // filename; we don't pick a side — we copy to each at injection. A template
+    // that asks for persona injection but ships no instruction.md is a
+    // misconfiguration — let the readFile throw so the create fails loudly
+    // (matches the old `compose_persona_claude_md` exit 4).
     const persona = await resolvePersona();
-    const templateMd = await readFile(join(template.filesDir, 'CLAUDE.md'), 'utf8');
-    const composed = persona !== null ? `${persona}\n\n---\n\n${templateMd}` : templateMd;
+    const instruction = await readFile(join(template.filesDir, 'instruction.md'), 'utf8');
+    const composed = persona !== null ? `${persona}\n\n---\n\n${instruction}` : instruction;
     await writeWorkspaceFile(dir, 'CLAUDE.md', composed);
     await writeWorkspaceFile(dir, 'AGENTS.md', composed);
   }
diff --git a/src/workspaces/template-registry.ts b/src/workspaces/template-registry.ts
index 2592588f2..81db2ec18 100644
--- a/src/workspaces/template-registry.ts
+++ b/src/workspaces/template-registry.ts
@@ -51,7 +51,7 @@ export interface TemplateMeta {
    * Launcher-owned context injection, post-bootstrap, gated per template
    * (defaults preserve each template's pre-standardization behavior):
    *   injectMcp     — write the standard OpenAlice `.mcp.json`
-   *   injectPersona — compose Alice persona + this template's CLAUDE.md
+   *   injectPersona — compose Alice persona + this template's instruction.md
    *                   into CLAUDE.md / AGENTS.md
    *   bundledSkills — names under `default/skills/` to copy into the
    *                   workspace's `.claude/skills` + `.agents/skills`
diff --git a/src/workspaces/templates/chat/files/CLAUDE.md b/src/workspaces/templates/chat/files/instruction.md
similarity index 100%
rename from src/workspaces/templates/chat/files/CLAUDE.md
rename to src/workspaces/templates/chat/files/instruction.md
diff --git a/src/workspaces/templates/finance-research/files/CLAUDE.md b/src/workspaces/templates/finance-research/files/instruction.md
similarity index 100%
rename from src/workspaces/templates/finance-research/files/CLAUDE.md
rename to src/workspaces/templates/finance-research/files/instruction.md