create-byan-agent 2.41.0 → 2.42.0

package/install/lib/rtk-integration.js

@@ -5,16 +5,20 @@
  *
  * RTK ("Rust Token Killer", Apache-2.0) is a single zero-dependency binary that
  * filters/compresses dev-command output before it reaches the LLM context
- * (-60/90% tokens). It wires into Claude Code through its OWN hook installer.
+ * (-60/90% tokens). It wires into Claude Code through its OWN hook installer;
+ * for Codex installs BYAN can make the native binary available, but does not
+ * claim a transparent hook layer where Codex has no BYAN hook adapter.
  *
  * MAINTAINABILITY by design (the whole point of choosing this shape):
  *  - We do NOT reimplement per-OS download / checksum / version pinning. We
  *    DELEGATE the install to rtk's own canonical installer (brew / the official
  *    install.sh / cargo), and DELEGATE the Claude Code hook wiring to rtk's own
  *    `rtk init -g --auto-patch` (the `--auto-patch` is what makes it non-
- *    interactive — see wireHook). BYAN maintains only "pick the available
- *    installer, run it bounded + visible, locate the binary, ask rtk to wire its
- *    hook" — a tiny surface, bumped via one constant.
+ *    interactive — see wireHook). For Codex, BYAN stops at verified native
+ *    binary availability and reports that honestly. BYAN maintains only "pick
+ *    the available installer, run it bounded + visible, locate the binary, ask
+ *    rtk to wire its hook when Claude is targeted" — a tiny surface, bumped via
+ *    one constant.
  *  - SUPPLY-CHAIN: we pin to a TAG, never a moving branch. cargo builds the
  *    tagged source (`--tag`), and install.sh is fetched from the IMMUTABLE tag ref.
  *    That script verifies a SHA-256 of the downloaded binary against a published
@@ -39,8 +43,8 @@
  *
  * Mirrors the ENTRY-POINT shape of byan-web-integration.js / byan-leantime-
  * integration.js (one `setup*Integration`); the return contract is { ok, synced,
- * reason, ... } because persistence is owned by rtk's own `rtk init -g --auto-patch`, not by
- * byan-platform-config.
+ * reason, ... } because persistence is owned by rtk's own `rtk init -g
+ * --auto-patch`, not by byan-platform-config.
  */
 
 const { execSync } = require('child_process');
@@ -128,6 +132,48 @@ function pathHintFor(bin, { env = process.env, platform = process.platform } = {
   return `export PATH="${dir}:$PATH"`;
 }
 
+function normalizeTargetPlatforms(targetPlatforms = ['claude']) {
+  const raw = Array.isArray(targetPlatforms) ? targetPlatforms : [targetPlatforms];
+  const set = new Set();
+  for (const p of raw) {
+    const key = String(p || '').trim().toLowerCase();
+    if (key === 'claude' || key === 'claude-code') set.add('claude');
+    if (key === 'codex') set.add('codex');
+  }
+  if (!set.size) set.add('claude');
+  return set;
+}
+
+function codexReady({
+  log,
+  installedVia,
+  version,
+  bin = 'rtk',
+  env = process.env,
+  platform = process.platform,
+  claudeHook = false,
+} = {}) {
+  const offPath = bin !== 'rtk';
+  log(`rtk: ready for Codex (${installedVia}, v${version || '?'}) — native binary available; no transparent Codex hook is wired.`);
+  const r = {
+    ok: true,
+    synced: true,
+    reason: 'codex-binary-ready',
+    installed: true,
+    installedVia,
+    version,
+    hook: Boolean(claudeHook),
+    claudeHook: Boolean(claudeHook),
+    codexReady: true,
+    bin,
+  };
+  if (offPath) {
+    r.pathHint = pathHintFor(bin, { env, platform });
+    log(`rtk: note — installed at ${bin}, not on your PATH. Add it: ${r.pathHint}`);
+  }
+  return r;
+}
+
 /**
  * rtkStatus() -> { installed, version, bin }. Never throws. Probes `<bin>
  * --version` ("rtk 0.42.4"), default bin "rtk" (on PATH). An installed-but-
@@ -209,7 +255,7 @@ function wireHook({ run, log, installedVia, version, bin = 'rtk', env = process.
   try {
     run(initCmd, { stdio: 'pipe' });
     log(`rtk: ready (${installedVia}, v${version || '?'}) — hook wired via '${initCmd}'. Restart Claude Code to activate.`);
-    const r = { ok: true, synced: true, reason: 'wired', installed: true, installedVia, version, hook: true, bin };
+    const r = { ok: true, synced: true, reason: 'wired', installed: true, installedVia, version, hook: true, claudeHook: true, bin };
     if (offPath) {
       r.pathHint = pathHintFor(bin, { env, platform });
       log(`rtk: note — installed at ${bin}, not on your PATH. Add it: ${r.pathHint}`);
@@ -217,7 +263,7 @@ function wireHook({ run, log, installedVia, version, bin = 'rtk', env = process.
     return r;
   } catch (err) {
     log(`rtk: installed (${installedVia}) but '${initCmd}' failed (${oneLine(err)}) — run it manually, BYAN unaffected.`);
-    const r = { ok: true, synced: false, reason: 'hook-failed', installed: true, installedVia, version, hook: false, bin };
+    const r = { ok: true, synced: false, reason: 'hook-failed', installed: true, installedVia, version, hook: false, claudeHook: false, bin };
     if (offPath) r.pathHint = pathHintFor(bin, { env, platform });
     return r;
   }
@@ -240,6 +286,9 @@ function wireHook({ run, log, installedVia, version, bin = 'rtk', env = process.
  * @param {Function} [o.resolve]  binary resolver (default resolveBinary) — injected in tests
  * @param {Function} [o.log]      one-line breadcrumb sink (default no-op)
  * @param {object}   [o.env]      environment (default process.env) — for the timeout override
+ * @param {string[]|string} [o.targetPlatforms] platforms to prepare:
+ *                    claude wires RTK's Claude Code hook; codex verifies the
+ *                    native binary and reports no transparent hook.
  */
 function setupRtkIntegration({
   run = execSync,
@@ -248,16 +297,33 @@ function setupRtkIntegration({
   log = () => {},
   env = process.env,
   platform = process.platform,
+  targetPlatforms = ['claude'],
 } = {}) {
+  const targets = normalizeTargetPlatforms(targetPlatforms);
+  const wantsClaude = targets.has('claude');
+  const wantsCodex = targets.has('codex');
+  const finishReady = ({ installedVia, version, bin }) => {
+    if (!wantsClaude && wantsCodex) {
+      return codexReady({ log, installedVia, version, bin, env, platform });
+    }
+    const r = wireHook({ run, log, installedVia, version, bin, env, platform });
+    if (wantsCodex && r.installed) {
+      r.codexReady = true;
+      if (r.reason === 'wired') r.reason = 'wired+codex-binary-ready';
+      log('rtk: also ready for Codex — native binary available; no transparent Codex hook is wired.');
+    }
+    return r;
+  };
+
   const before = locateRtk({ run, has, resolve, env });
   if (before.installed) {
-    return wireHook({ run, log, installedVia: 'already-present', version: before.version, bin: before.bin, env, platform });
+    return finishReady({ installedVia: 'already-present', version: before.version, bin: before.bin });
   }
 
   const strat = pickStrategy({ has });
   if (!strat) {
     log('rtk: no installer found (brew / curl / cargo) — skipped. BYAN install unaffected.');
-    return { ok: true, synced: false, reason: 'no-installer', installed: false, hook: false };
+    return { ok: true, synced: false, reason: 'no-installer', installed: false, hook: false, claudeHook: false, codexReady: false };
   }
 
   // Breadcrumb BEFORE the delegated install. stdio is INHERITED so the installer's
@@ -269,10 +335,10 @@ function setupRtkIntegration({
   } catch (err) {
     if (isTimeout(err)) {
       log(`rtk: install via ${strat.id} exceeded ${Math.round(timeoutMs / MIN)}min — stopped (a background build may still continue). Retry with 'npm run setup-rtk' (or widen BYAN_RTK_TIMEOUT_MS). BYAN unaffected.`);
-      return { ok: true, synced: false, reason: `install-timeout:${strat.id}`, installed: false, hook: false };
+      return { ok: true, synced: false, reason: `install-timeout:${strat.id}`, installed: false, hook: false, claudeHook: false, codexReady: false };
     }
     log(`rtk: install via ${strat.id} failed (${oneLine(err)}) — skipped gracefully.`);
-    return { ok: true, synced: false, reason: `install-failed:${strat.id}`, installed: false, hook: false };
+    return { ok: true, synced: false, reason: `install-failed:${strat.id}`, installed: false, hook: false, claudeHook: false, codexReady: false };
   }
 
   // The binary may be installed but OFF PATH (cargo -> ~/.cargo/bin). Resolve it
@@ -280,10 +346,10 @@ function setupRtkIntegration({
   const after = locateRtk({ run, has, resolve, env });
   if (!after.installed) {
     log(`rtk: install via ${strat.id} ran but 'rtk --version' did not confirm — skipped.`);
-    return { ok: true, synced: false, reason: 'install-unverified', installed: false, hook: false };
+    return { ok: true, synced: false, reason: 'install-unverified', installed: false, hook: false, claudeHook: false, codexReady: false };
   }
 
-  return wireHook({ run, log, installedVia: strat.id, version: after.version, bin: after.bin, env, platform });
+  return finishReady({ installedVia: strat.id, version: after.version, bin: after.bin });
 }
 
 /**
@@ -307,6 +373,7 @@ module.exports = {
   timeoutFor,
   isTimeout,
   pathHintFor,
+  normalizeTargetPlatforms,
   doctor,
   shouldOfferRtk,
   RTK_VERSION,

package/install/templates/.claude/CLAUDE.md

@@ -67,6 +67,22 @@ Doctrine d'equipe complete (template role-in-team, analogie orchestre, principes
 - Architecture portable (noyau portable, projection native): voir .claude/rules/portable-core.md (charge a la demande)
 - Systeme API byan_web: voir @.claude/rules/byan-api.md
 
+## Handoff Claude/Codex
+
+Quand l'utilisateur demande `importe depuis claude` ou `importe depuis codex`,
+ne demande pas de precision si un handoff depuis cette source existe. Lance:
+
+```bash
+byan-handoff latest --from <source demandee> --prompt
+```
+
+Utilise le prompt produit comme contexte de reprise, inspecte les fichiers listes,
+puis continue le travail. Si aucun fichier ne correspond, signale simplement
+qu'aucun handoff depuis cette source n'a ete trouve et propose
+`byan-handoff latest --prompt` comme fallback seulement si l'utilisateur accepte
+de reprendre depuis le dernier handoff toutes sources confondues. Ne t'appuie
+pas sur les memoires natives Claude/Codex comme source de verite.
+
 ## API byan_web
 
 BYAN expose une API REST via `$BYAN_API_URL` avec authentification par token (`ApiKey` ou `Bearer`).

package/install/templates/.claude/settings.json

@@ -6,15 +6,15 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/inject-soul.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/inject-soul.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/inject-tao.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/inject-tao.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/soul-memory-check.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/soul-memory-check.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }
@@ -25,27 +25,27 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/inject-voice-anchor.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/inject-voice-anchor.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/inject-delivery-default.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/inject-delivery-default.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/soul-memory-triggers.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/soul-memory-triggers.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/fd-phase-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/fd-phase-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/strict-context-inject.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/strict-context-inject.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/codex-autodelegate.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/codex-autodelegate.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }
@@ -56,35 +56,35 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/mantra-validate.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/mantra-validate.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/fact-check-claims.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/fact-check-claims.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/fd-response-check.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/fd-response-check.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stage-to-byan.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/stage-to-byan.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/strict-stop-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/strict-stop-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/autobench-stop-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/autobench-stop-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/punt-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/punt-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/drain-advisory.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/drain-advisory.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }
@@ -95,15 +95,15 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/tool-transparency.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/tool-transparency.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/fact-check-absolutes.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/fact-check-absolutes.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/strict-scope-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/strict-scope-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       },
@@ -112,7 +112,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/tier-script-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/tier-script-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }
@@ -123,11 +123,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/tool-failure-guard.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/tool-failure-guard.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           },
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/leantime-fd-sync.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/leantime-fd-sync.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }
@@ -138,7 +138,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-compact-save.js"
+            "command": "p=\"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-compact-save.js\"; [ -f \"$p\" ] || exit 0; exec node \"$p\""
           }
         ]
       }

package/install/templates/.claude/skills/byan-byan/SKILL.md

@@ -18,6 +18,20 @@ Invoke this protocol when the user :
 
 If the user request is a simple question or chat, stay out of FD — respond normally.
 
+## 1.25. Claude/Codex handoff import trigger
+
+When the user says `importe depuis claude` or `importe depuis codex`, handle it
+before starting a new FD cycle:
+
+1. Run `byan-handoff latest --from <requested source> --prompt`.
+2. Use the generated prompt as resume context, inspect the listed files, then
+   continue the current work.
+
+If no matching handoff exists, say that no handoff from that source was found and
+offer `byan-handoff latest --prompt` as the fallback only if the user accepts
+resuming from the newest handoff across all sources. Do not rely on native
+Claude/Codex memory as the source of truth.
+
 ## 1.5. Freshness check (silent, once per session)
 
 Before responding to the user's first activation message in a session, call the MCP tool `byan_update_check` once. It is read-only and cheap (single npm registry lookup, 5s timeout, no side effects).

package/install/templates/.claude/skills/byan-codex/SKILL.md

@@ -19,3 +19,10 @@ description: "OpenCode/Codex integration specialist for BYAN skills Role: OpenCo
 - Validate .codex/prompts/ structure
 - Test skill detection before deployment
 - Handle Codex-specific terminology (skills not agents)
+- When the user says `importe depuis claude` or `importe depuis codex`, run
+  `byan-handoff latest --from <requested source> --prompt`, then resume from
+  the generated prompt after inspecting the listed files. If none matches,
+  report that no handoff from that source exists and offer
+  `byan-handoff latest --prompt` as fallback only if the user accepts resuming
+  from the newest handoff across all sources. Native Claude/Codex memory is not
+  the source of truth.

package/install/templates/.codex/skills/byan/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: byan
+description: BYAN local project skill. Use when working in the BYAN repo, invoking BYAN agents/workflows/commands, enforcing BYAN Strict Mode, or needing the portable BYAN filesystem map.
+---
+
+# BYAN Local Skill
+
+Use this skill when the user asks for BYAN behavior, mentions BYAN/BMAD, asks to
+run an agent or workflow from this repo, or works on the BYAN platform itself.
+
+## Source Of Truth
+
+BYAN's portable core lives in this repository. Do not treat native assistant
+memory, generated caches, or platform-specific projections as authoritative.
+
+Read `_byan/INDEX.md` first to find agents, workflows, commands, and project
+artefacts. Avoid broad filesystem scans unless the index is missing, stale, or
+insufficient for the requested task.
+
+Core references:
+
+- `_byan/INDEX.md` — filesystem map for BYAN agents, workflows, commands, and projects.
+- `AGENTS.md` — Codex adapter for BYAN Strict Mode and delivery defaults.
+- `.claude/rules/portable-core.md` — portable-core doctrine: `_byan/` and
+  `_byan-output/` are the source of truth; native platform features are
+  write-through accelerators.
+- `_byan/agent/byan/byan.md` — BYAN core meta-agent when the task requires the
+  full BYAN persona and FD workflow.
+
+## Strict Mode
+
+When BYAN Strict Mode is active, follow the audit protocol before delivery:
+
+1. Lock scope with `byan_strict_lock_scope` before building.
+2. Build the locked scope without silent downgrade.
+3. Run at least three `byan_strict_self_verify` passes against the original
+   request and acceptance criteria.
+4. Call `byan_strict_complete` only after the final pass is `ok`.
+
+Surface gaps explicitly. Do not round skipped tests, blocked tools, or partial
+work up to done.
+
+## Working Rules
+
+- Prefer BYAN's local manifests and `_byan/INDEX.md` over filesystem wandering.
+- Keep Codex-specific material under `.codex/` or installed Codex skills under
+  `$CODEX_HOME/skills` / `~/.codex/skills`.
+- Use existing BYAN agents and workflows instead of inventing parallel
+  conventions.
+- If a public surface changes, update the matching doc, manifest, template, or
+  generated projection when applicable.
+- Preserve BYAN's no-emoji convention in code, commits, docs, and prompts.
+
+## Claude/Codex Handoff Import
+
+When the user says `importe depuis claude` or `importe depuis codex`, handle it
+without asking for more context if a matching handoff exists:
+
+1. Run `byan-handoff latest --from <requested source> --prompt`.
+2. Treat the generated prompt as the resume context, inspect the listed files,
+   then continue the work.
+
+If no matching handoff exists, say that no handoff from that source was found and
+offer `byan-handoff latest --prompt` as the fallback only if the user accepts
+resuming from the newest handoff across all sources. Do not rely on native
+Claude/Codex memory as the source of truth.
+
+## Installed Bundles In This Repo
+
+Prebuilt Codex skill bundles are available under `dist/skill-bundles/`, including:
+
+- `byan-byan.zip` — full BYAN FD/meta-agent skill.
+- `byan-strict.zip` — strict scope-lock and audit protocol.
+- `byan-codex.zip` — Codex/OpenCode integration specialist.
+
+Use those bundles when the user asks for a specific packaged BYAN skill. Use this
+local `byan` skill as the general repo-aware entrypoint.

package/install/templates/_byan/INDEX.md

@@ -3,7 +3,7 @@
 > Carte du systeme de fichiers BYAN. Genere automatiquement — ne pas editer a la main.
 > Source : `_byan/_config/*-manifest.csv` + scan `_byan/projet/`. Regenerer : `byan-build-index`.
 
-## Agents (26)
+## Agents (28)
 
 ### bmb
 - `agent-builder` — Agent Building Expert — `_byan/agent/agent-builder/agent-builder.md`
@@ -18,6 +18,8 @@
 - `architect` — Architect — `_byan/agent/architect/architect.md`
 - `dev` — Developer Agent — `_byan/agent/dev/dev.md`
 - `expert-merise-agile` — Expert Merise Agile - Assistant de Conception & Rédaction — `_byan/agent/expert-merise-agile/expert-merise-agile.md`
+- `jimmy` — Spécialiste Documentation Technique & Processus Internes — `_byan/agent/jimmy/jimmy.md`
+- `mike` — Gestionnaire de Projet — Spécialiste Leantime — `_byan/agent/mike/mike.md`
 - `pm` — Product Manager — `_byan/agent/pm/pm.md`
 - `quick-flow-solo-dev` — Quick Flow Solo Dev — `_byan/agent/quick-flow-solo-dev/quick-flow-solo-dev.md`
 - `quinn` — QA Engineer — `_byan/agent/quinn/quinn.md`
@@ -41,10 +43,11 @@
 ### tea
 - `tea` — Master Test Architect and Quality Advisor — `_byan/agent/tea/tea.md`
 
-## Workflows (45)
+## Workflows (47)
 
 ### bmb
 - `agent` — Tri-modal workflow for creating, editing, and validating BMAD Core compliant agents — `_byan/workflow/simple/agent/workflow.md`
+- `byan-benchmark` — DATA-only benchmark engine for any decision fork: options x weighted-criteria matrix + best-first reco + dissent — `_byan/workflow/simple/bmb/byan-benchmark/workflow.md`
 - `module` — Quad-modal workflow for creating BMAD modules (Brief + Create + Edit + Validate) — `_byan/workflow/simple/module/workflow.md`
 - `turbo-whisper-configure` — Configure Turbo Whisper API, hotkeys, and preferences — `_byan/workflow/simple/turbo-whisper/configure-workflow.md`
 - `turbo-whisper-docker-setup` — Setup self-hosted faster-whisper-server with Docker for privacy and cost-free transcription — `_byan/workflow/simple/turbo-whisper/docker-setup-workflow.md`
@@ -86,6 +89,7 @@
 ### core
 - `brainstorming` — Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods — `_byan/workflow/simple/brainstorming/workflow.md`
 - `party-mode` — Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations — `_byan/workflow/simple/party-mode/workflow.md`
+- `project-handoff` — Export/import portable Markdown project state between Claude Code and Codex — `_byan/workflow/simple/byan/project-handoff-workflow.md`
 
 ### tea
 - `teach-me-testing` — Multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence — `_byan/workflow/simple/testarch/teach-me-testing/workflow.md`

package/install/templates/_byan/_config/workflow-manifest.csv

@@ -45,4 +45,4 @@ name,description,module,path
 "turbo-whisper-docker-setup","Setup self-hosted faster-whisper-server with Docker for privacy and cost-free transcription","bmb","_byan/workflow/simple/turbo-whisper/docker-setup-workflow.md"
 "turbo-whisper-integrate","Integrate Turbo Whisper with GitHub Copilot CLI, Claude Code, and Codex platforms","bmb","_byan/workflow/simple/turbo-whisper/integrate-workflow.md"
 "byan-benchmark","DATA-only benchmark engine for any decision fork: options x weighted-criteria matrix + best-first reco + dissent","bmb","_byan/workflow/simple/bmb/byan-benchmark/workflow.md"
-
+"project-handoff","Export/import portable Markdown project state between Claude Code and Codex","core","_byan/workflow/simple/byan/project-handoff-workflow.md"

package/install/templates/_byan/mcp/byan-mcp-server/skill-bundles-manifest.json

@@ -94,7 +94,7 @@
       "name": "byan-byan",
       "module": "core",
       "tier": "connector-bound",
-      "sourceHash": "a0d73cf82fcf228965de722e7d01c785ae79a6382975e3045b4eeb902633062a"
+      "sourceHash": "6798beb68df9831e0b9bf3ca17100174316c51b2671d96b2ef5bff6def4eabc7"
     },
     "byan-byan-v2": {
       "name": "byan-byan-v2",
@@ -154,7 +154,7 @@
       "name": "byan-codex",
       "module": "core",
       "tier": "standalone",
-      "sourceHash": "0f0d7a1108a43a0c0c8093cc5600bc2649d6766c6ae94c2a2a9dafa315180627"
+      "sourceHash": "32f2ae4a9bfe7a0f90f2ca9787e472c57b847bc36ac9bc6fa0050af70c0af27c"
     },
     "byan-drawio": {
       "name": "byan-drawio",

package/install/templates/_byan/workflow/simple/byan/project-handoff-workflow.md

@@ -0,0 +1,90 @@
+---
+name: project-handoff
+description: "Export/import portable Markdown project state between Claude Code and Codex"
+version: "1.0.0"
+module: byan
+phases: 4
+---
+
+# BYAN Project Handoff Workflow
+
+## Purpose
+
+Use this workflow when a BYAN session must move between Claude Code and Codex,
+usually because one assistant is close to a usage limit. The handoff artifact is
+a Markdown file under `_byan-output/handoffs/`; it is portable repo state, not
+native assistant memory.
+
+## Contract
+
+- Source of truth: repository files plus `_byan/` and `_byan-output/`.
+- Artifact: `_byan-output/handoffs/<timestamp>-<from>-to-<to>-<task>.md`.
+- Format: human-readable Markdown with a parseable `json byan-handoff` block.
+- Direction: Claude -> Codex and Codex -> Claude use the same format.
+- Native memories (`~/.claude`, `~/.codex`) may help locally but are not needed
+  to resume.
+
+## Commands
+
+Export from the current assistant:
+
+```bash
+byan-handoff export --from claude --to codex \
+  --task "current feature" \
+  --summary "what happened so far" \
+  --next "first action for the next assistant"
+```
+
+Import on the next assistant:
+
+```bash
+byan-handoff latest --from claude --prompt
+```
+
+Or import a specific file:
+
+```bash
+byan-handoff import _byan-output/handoffs/<file>.md --prompt
+```
+
+## Phase 1: Export
+
+1. Re-read the active request and any locked BYAN strict scope.
+2. Run `byan-handoff export` with explicit `--from`, `--to`, `--task`,
+   `--summary`, and at least one `--next`.
+3. Add useful optional details:
+   - `--decision "..."` for architectural or product decisions.
+   - `--command "..."` for tests or checks already run.
+   - `--blocker "..."` for gaps, failures, or risks.
+   - `--note "..."` for context the next assistant should not rediscover.
+4. Report the generated file path to the user.
+
+## Phase 2: Transfer
+
+The user opens the same repository with the other assistant. No hidden copy step
+is required when both assistants share the same working tree. If the handoff is
+moving to another machine, copy the Markdown file with the repo or paste its
+`Resume Prompt` section.
+
+## Phase 3: Import
+
+1. Run `byan-handoff latest --from <source> --prompt` or
+   `byan-handoff import <file> --prompt`.
+2. Treat the printed prompt as the starting context.
+3. Inspect the listed files before editing.
+4. Check `_byan-output/fd-state.json` and strict status if the handoff names an
+   active FD.
+
+## Phase 4: Continue
+
+1. Continue from the `Next Actions` section.
+2. Update the same FD rather than starting a parallel one unless the handoff says
+   the old FD is complete or aborted.
+3. Before switching back, create a new handoff in the opposite direction.
+
+## Validation Checklist
+
+- [ ] Handoff file exists under `_byan-output/handoffs/`.
+- [ ] `byan-handoff latest --from <source> --prompt` prints a usable resume prompt.
+- [ ] The next assistant inspected files listed in `Files Touched`.
+- [ ] Any strict-mode gaps are surfaced, not hidden.