create-byan-agent 2.41.0 → 2.44.0

package/install/lib/yanstaller/index.js

@@ -1,129 +1,26 @@
 /**
- * YANSTALLER - Main Orchestrator
- * 
- * Coordinates all YANSTALLER modules to perform intelligent BYAN installation.
- * 
+ * YANSTALLER - Backup / update / rollback surface
+ *
+ * The programmatic install()/uninstall() orchestrator was removed: it was a
+ * half-implemented stub (phases 4-9 never wired) and the real installer is
+ * install/bin/create-byan-agent-v2.js. What remains here is the live, tested
+ * surface consumed by the CLI (update / rollback / backups / check commands)
+ * and the web UI: update, rollback, listBackups, plus the raw detector /
+ * platformSelector / updater / backuper modules.
+ *
  * @module yanstaller
  */
 
 const path = require('path');
 const detector = require('./detector');
-const recommender = require('./recommender');
-const installer = require('./installer');
-const validator = require('./validator');
-const troubleshooter = require('./troubleshooter');
-const interviewer = require('./interviewer');
 const backuper = require('./backuper');
 const updater = require('./updater');
-const wizard = require('./wizard');
 const platformSelector = require('./platform-selector');
 const logger = require('../utils/logger');
 
-/**
- * @typedef {Object} YanInstallerOptions
- * @property {boolean} [yes] - Skip confirmations (--yes flag)
- * @property {string} [mode] - Installation mode: 'full' | 'minimal' | 'custom'
- * @property {string[]} [platforms] - Target platforms (override detection)
- * @property {boolean} [verbose] - Verbose output
- * @property {boolean} [quiet] - Minimal output
- */
-
-/**
- * Main installation flow
- * 
- * @param {YanInstallerOptions} [options={}] - Installation options
- * @returns {Promise<void>}
- */
-async function install(options = {}) {
-  let backupPath = null;
-  
-  try {
-    // Phase 1: Detect environment
-    logger.info('🔍 Detecting environment...');
-    const detection = await detector.detect();
-    
-    // Phase 2: Validate Node version (FAIL FAST)
-    if (!detector.isNodeVersionValid(detection.nodeVersion, '18.0.0')) {
-      throw new Error(`Node.js >= 18.0.0 required. Found: ${detection.nodeVersion}`);
-    }
-    
-    // Phase 3: Platform Selection
-    let platformSelection;
-    if (options.platforms) {
-      // CLI override
-      platformSelection = {
-        platforms: options.platforms,
-        mode: 'manual'
-      };
-    } else if (options.yes) {
-      // Auto mode
-      platformSelection = {
-        platforms: detection.platforms.filter(p => p.detected).map(p => p.name),
-        mode: 'auto'
-      };
-    } else {
-      // Interactive selection
-      platformSelection = await platformSelector.select(detection);
-    }
-    
-    logger.info(`\n✓ Selected ${platformSelection.platforms.length} platform(s)`);
-    logger.info(`  Mode: ${platformSelection.mode}`);
-    if (platformSelection.specialist) {
-      logger.info(`  Specialist: @bmad-agent-${platformSelection.specialist}`);
-    }
-    
-    // Phase 4: Recommend configuration
-    // TODO: Implement
-    
-    // Phase 5: Run interview (unless --yes)
-    // TODO: Implement
-    
-    // Phase 6: Backup existing installation
-    // backupPath = await backuper.backup('_bmad');
-    
-    // Phase 7: Install agents
-    // TODO: Implement
-    
-    // Phase 8: Validate installation
-    // TODO: Implement
-    
-    // Phase 9: Show post-install wizard
-    // TODO: Implement
-  } catch (error) {
-    // ROLLBACK STRATEGY: Leave partial state + clear message
-    // Rationale (Mantra #37 Ockham's Razor):
-    // - Installation = mostly file copies (low risk)
-    // - User can re-run (idempotent)
-    // - Backup exists for manual restore
-    // - Auto-rollback risks losing working partial install
-    
-    logger.error('Installation failed:', error.message);
-    
-    if (backupPath) {
-      logger.info('\nPartial installation completed.');
-      logger.info(`Backup available at: ${backupPath}`);
-      logger.info('\nOptions:');
-      logger.info('1. Re-run: npx create-byan-agent');
-      logger.info(`2. Restore backup: yanstaller restore ${backupPath}`);
-      logger.info('3. Troubleshoot: yanstaller doctor');
-    }
-    
-    throw error; // Re-throw for exit code handling
-  }
-}
-
-/**
- * Uninstall BYAN
- * 
- * @returns {Promise<void>}
- */
-async function uninstall() {
-  // TODO: Remove _bmad/, .github/agents/ stubs
-}
-
 /**
  * Update existing BYAN installation
- * 
+ *
  * @param {string} projectRoot - Project root directory
  * @param {Object} [options={}] - Update options
  * @param {boolean} [options.force] - Force update even if same version
@@ -163,12 +60,10 @@ async function listBackups(projectRoot) {
 }
 
 module.exports = {
-  install,
-  uninstall,
   update,
   rollback,
   listBackups,
-  // Expose for testing
+  // Raw modules exposed for the CLI, the web UI, and tests
   detector,
   platformSelector,
   updater,

package/install/lib/yanstaller/platform-selector.js

@@ -33,13 +33,13 @@ const PLATFORM_INFO = {
     displayName: 'Claude Code',
     native: true,
     specialist: 'claude',
-    icon: '🎭'
+    icon: ''
   },
   'codex': {
     displayName: 'OpenCode/Codex',
     native: true, // NOW NATIVE!
     specialist: 'codex',
-    icon: '📝'
+    icon: ''
   }
 };
 
@@ -50,7 +50,7 @@ const PLATFORM_INFO = {
  * @returns {Promise<PlatformSelectionResult>}
  */
 async function select(detectionResult) {
-  logger.info('\n🎯 Platform Selection\n');
+  logger.info('\nPlatform Selection\n');
   
   // Build platform choices from detection
   const choices = buildChoices(detectionResult.platforms);
@@ -75,7 +75,7 @@ async function select(detectionResult) {
       {
         type: 'list',
         name: 'primary',
-        message: '🎯 Choose your PRIMARY platform for native agent invocation:',
+        message: 'Choose your PRIMARY platform for native agent invocation:',
         choices: [
           ...nativePlatforms.map(c => ({
             name: `${c.icon} ${c.name} - ${c.agentSpecialist ? `@bmad-agent-${c.agentSpecialist}` : 'No specialist'}`,
@@ -84,11 +84,11 @@ async function select(detectionResult) {
           })),
           new inquirer.Separator(),
           {
-            name: '🔧 Advanced: Install on multiple platforms',
+            name: 'Advanced: Install on multiple platforms',
             value: 'multi'
           },
           {
-            name: '⏭️  Skip native integration (manual install only)',
+            name: 'Skip native integration (manual install only)',
             value: 'skip'
           }
         ]
@@ -125,7 +125,7 @@ async function select(detectionResult) {
       message: 'Choose installation target:',
       choices: [
         {
-          name: `🚀 Auto (detect & install all available) - ${choices.length} platform(s)`,
+          name: `Auto (detect & install all available) - ${choices.length} platform(s)`,
           value: 'auto'
         },
         ...choices.map(c => ({
@@ -133,7 +133,7 @@ async function select(detectionResult) {
           value: `single:${c.id}`
         })),
         {
-          name: '🔧 Custom (select multiple)',
+          name: 'Custom (select multiple)',
           value: 'custom'
         }
       ]
@@ -167,7 +167,7 @@ function buildChoices(detectedPlatforms) {
         displayName: p.name,
         native: false,
         specialist: null,
-        icon: '❓'
+        icon: ''
       };
       
       return {
@@ -189,8 +189,8 @@ function buildChoices(detectedPlatforms) {
  * @returns {string}
  */
 function formatPlatformChoice(choice) {
-  const nativeBadge = choice.native ? '✨ Native' : '💬 Conversational';
-  const statusBadge = choice.detected ? '✓' : '✗';
+  const nativeBadge = choice.native ? 'Native' : 'Conversational';
+  const statusBadge = choice.detected ? '[OK]' : '[x]';
   
   return `${choice.icon} ${choice.name} (${nativeBadge}) ${statusBadge}`;
 }

package/install/src/byan-v2/dispatcher/task-router.js

@@ -1,6 +1,6 @@
 /**
  * TaskRouter - Routes tasks based on complexity
- * Integrates ComplexityScorer + TaskToolInterface
+ * Integrates ComplexityScorer
  * 
  * Thresholds:
  * - < 30: task-tool only

package/install/src/index.js

@@ -59,7 +59,7 @@ class Dashboard {
  * 
  * @example
  * const byan = createByanInstance({ workerCount: 2 });
- * await byan.executeWorkflow('_bmad/workflows/create-prd/workflow.yaml');
+ * await byan.executeWorkflow('_byan/workflows/create-prd/workflow.yaml');
  */
 function createByanInstance(options = {}) {
   const {

package/install/src/webui/api.js

@@ -165,19 +165,6 @@ const routes = {
         await sleep(300);
       }
 
-      if (yanstaller) {
-        try {
-          await yanstaller.install({
-            mode: config.mode || 'full',
-            platforms: config.platforms,
-            yes: true,
-            projectRoot
-          });
-        } catch (err) {
-          server.broadcastLog('warn', `Yanstaller: ${err.message} (continuing with stub install)`);
-        }
-      }
-
       ensureDirectoryStructure(projectRoot);
       writeBaseConfig(projectRoot, config);
 

package/install/src/webui/chat/bridge.js

@@ -26,7 +26,7 @@ class Bridge {
     if (!agentName) return null;
 
     // Layout resolver: Gen3 _byan/agent/<name>/ first, Gen2 flat +
-    // per-module, Gen1 _bmad/ fallback.
+    // per-module.
     const hit = layoutResolver.resolveAgent(agentName, { projectRoot: this.projectRoot });
     return hit ? hit.path : null;
   }

package/install/src/webui/chat/cli-detector.js

@@ -96,7 +96,7 @@ function parseFrontmatter(content) {
 // Map a resolver layout (+ rel) to the legacy source label, so API responses
 // stay stable: Gen2 flat / Gen3 -> 'byan', Gen2 per-module -> 'bmad-<mod>'.
 function sourceForLayout(layout, rel) {
-  if (layout === 'gen2-module' || layout === 'gen1') {
+  if (layout === 'gen2-module') {
     const mod = String(rel).split('/')[1];
     return `bmad-${mod}`;
   }

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/rules/native-workflows.md

@@ -29,14 +29,20 @@ The tiering decision lives in one place — `_byan/mcp/byan-mcp-server/lib/nativ
 (tier vocabulary, leaf classifier, model map). Three tiers:
 
 - **cheap (`model: 'haiku'`)** — a pure EXPLORATION leaf (read/load/parse/detect).
-- **balanced (`model: 'sonnet'`)** — MECHANICAL verification, opt-in ONLY through
-  the `mech-` label prefix (`mech-validate-json`): a binary, judgment-free check
-  (JSON parses, schema matches, lint passes). Semantic/adversarial verification
-  is NOT mechanical and stays deep. The prefix is an authoring declaration the
-  linter holds the script to: a `mech-` leaf without `model: 'sonnet'` is a hard
-  violation (`mechanical-without-model` / `mechanical-below-tier`).
-- **deep (OMIT `opts.model`)** — implementation / verification / analysis leaves
-  inherit the session model (no pin-up to opus).
+- **balanced (`model: 'sonnet'`)** — two classes land here. (1) MECHANICAL
+  verification, opt-in ONLY through the `mech-` label prefix (`mech-validate-json`):
+  a binary, judgment-free check (JSON parses, schema matches, lint passes). (2)
+  ANALYSIS leaves (score/rank/assess/design/nfr/coverage/recommend/synthesize),
+  auto-routed by keyword: judgment-bearing but rarely frontier, so sonnet by
+  default. This deliberately OVERRIDES the session model for analysis even on an
+  Opus / high-effort session (that is the cost lever) — escape a frontier analysis
+  leaf with the `deep-` prefix. A `mech-` leaf without `model: 'sonnet'` is a hard violation; an analysis
+  leaf may carry `model: 'sonnet'` (its tier) but not `haiku` (`analysis-below-tier`).
+  Semantic/adversarial VERIFICATION is NOT analysis and stays deep.
+- **deep (OMIT `opts.model`)** — implementation + verification leaves inherit the
+  session model (no pin-up to opus). A genuinely frontier ANALYSIS leaf opts back to
+  deep with the `deep-` label prefix (`deep-assess-architecture`), the mirror of the
+  `mech-` opt-in.
 
 The linter splits the two directions:
 
@@ -44,12 +50,14 @@ The linter splits the two directions:
   pin-up, or a half-applied `mech-` opt-in is a contract violation
   (`modelRoutingViolations` + `mechanicalLabelViolations`). This is the STRICT-2
   No Downgrade net.
-- **Ceiling (ADVISORY, non-blocking)** — an exploration-labelled leaf that runs
-  deep is *reported* (`byan-lint-workflows.js --advise`), not forced. `classifyLeaf`
-  is permissive: many exploration-labelled leaves legitimately stay deep because
-  they bear a HALT/prerequisite gate, a classification, or an exact conversion
-  consumed verbatim downstream. The human owns that per-leaf call. Forcing haiku
-  on them would be the very downgrade the floor forbids.
+- **Ceiling (ADVISORY, non-blocking)** — an exploration- OR analysis-labelled leaf
+  that runs deep is *reported* (`byan-lint-workflows.js --advise`:
+  `untiered-exploration` -> `model: 'haiku'`, `untiered-analysis` -> `model: 'sonnet'`),
+  not forced. `classifyLeaf` is permissive: many such leaves legitimately stay deep
+  because they bear a HALT/prerequisite gate, a classification, an exact conversion
+  consumed verbatim downstream, or genuinely frontier reasoning (`deep-` prefix). The
+  human owns that per-leaf call. Forcing a downgrade would be the very regression the
+  floor forbids.
 
 ## Ad-hoc scripts — the tier gate hook
 

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/COMPLETION-REPORT.md

@@ -99,7 +99,6 @@ Suite à la migration `_byan` → `_byan`, la structure BYAN v2 a été complét
    - ComplexityScorer: Analyse complexité tâches (0.0-1.0)
    - TaskRouter: Routage intelligent (local vs délégation)
    - LocalExecutor: Exécution locale
-   - TaskToolInterface: Interface avec sous-agents Copilot CLI
 
 3. **Generation Worker** (`generation/`)
    - ProfileTemplate: Templates markdown avec placeholders