create-byan-agent 2.19.0 → 2.19.1

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.19.1] - 2026-06-02
+
+### Fixed - Agent stubs repointed to the by-type (Gen3) layout
+
+2.19.0 shipped the platform on the Gen3 by-type layout (`_byan/agent/<name>/`),
+but the Copilot CLI stubs (`.github/agents/*.md`) and the `byan-byan-test`
+Claude skill still loaded agents from the old Gen2 module paths
+(`_byan/bmb/agents/<name>.md`) with no fallback. On a fresh AUTO-mode install,
+or after `update-byan-agent` refreshed the stubs, those loaders pointed at files
+that no longer exist at that path, so the agent failed to load.
+
+- Every shipped stub now loads agents Gen3-first with a legacy fallback:
+  `_byan/agent/<name>/<name>.md (new layout); if absent, _byan/*/agents/<name>.md (legacy layout)`.
+  Both loader forms are covered (`LOAD the FULL agent file from ...` and the
+  `<step>Load persona from ...` activation form), in the template and at the
+  repo root.
+- The `byan-byan-test` Claude skill stub points Gen3-first as well.
+- A regression guard (`install/__tests__/template-gen3-layout.test.js`) asserts
+  no shipped stub references a Gen2-only agent path, so this cannot drift back.
+
+The repoint is layout-agnostic: a project still on Gen2 keeps resolving via the
+legacy fallback, a Gen3 project resolves the new home first. This makes both the
+fresh install and the update path non-breaking regardless of which layout the
+target project is on.
+
+---
+
 ## [2.19.0] - 2026-06-01
 
 ### Added - Platform migrated to the by-type (Gen3) layout

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

@@ -8,5 +8,5 @@ description: BYAN Test - Token Optimized Version (-46%)
 ## Rules
 
 - This is a TEST version of BYAN optimized for token reduction (-46%)
-- Full agent: _byan/bmb/agents/byan-test.md (116 lines vs 215 original)
+- Full agent: _byan/agent/byan-test/byan-test.md (new layout); if absent, _byan/*/agents/byan-test.md (legacy layout). 116 lines vs 215 original
 - Original BYAN still available via bmad-agent-byan

package/install/templates/.github/agents/bmad-agent-bmad-master.md

@@ -6,7 +6,7 @@ description: 'bmad-master agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/core/agents/bmad-master.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/bmad-master/bmad-master.md (new layout); if absent, {project-root}/_byan/*/agents/bmad-master.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmb-agent-builder.md

@@ -6,7 +6,7 @@ description: 'agent-builder agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/agent-builder.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/agent-builder/agent-builder.md (new layout); if absent, {project-root}/_byan/*/agents/agent-builder.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmb-module-builder.md

@@ -6,7 +6,7 @@ description: 'module-builder agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/module-builder.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/module-builder/module-builder.md (new layout); if absent, {project-root}/_byan/*/agents/module-builder.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmb-workflow-builder.md

@@ -6,7 +6,7 @@ description: 'workflow-builder agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/workflow-builder.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/workflow-builder/workflow-builder.md (new layout); if absent, {project-root}/_byan/*/agents/workflow-builder.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-analyst.md

@@ -6,7 +6,7 @@ description: 'analyst agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/analyst.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/analyst/analyst.md (new layout); if absent, {project-root}/_byan/*/agents/analyst.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-architect.md

@@ -6,7 +6,7 @@ description: 'architect agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/architect.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/architect/architect.md (new layout); if absent, {project-root}/_byan/*/agents/architect.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-dev.md

@@ -6,7 +6,7 @@ description: 'dev agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/dev.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/dev/dev.md (new layout); if absent, {project-root}/_byan/*/agents/dev.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-pm.md

@@ -6,7 +6,7 @@ description: 'pm agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/pm.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/pm/pm.md (new layout); if absent, {project-root}/_byan/*/agents/pm.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-quick-flow-solo-dev.md

@@ -6,7 +6,7 @@ description: 'quick-flow-solo-dev agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/quick-flow-solo-dev.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/quick-flow-solo-dev/quick-flow-solo-dev.md (new layout); if absent, {project-root}/_byan/*/agents/quick-flow-solo-dev.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-quinn.md

@@ -6,7 +6,7 @@ description: 'quinn agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/quinn.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/quinn/quinn.md (new layout); if absent, {project-root}/_byan/*/agents/quinn.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-sm.md

@@ -6,7 +6,7 @@ description: 'sm agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/sm.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/sm/sm.md (new layout); if absent, {project-root}/_byan/*/agents/sm.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-tech-writer.md

@@ -6,7 +6,7 @@ description: 'tech-writer agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/tech-writer/tech-writer.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/tech-writer/tech-writer.md (new layout); if absent, {project-root}/_byan/*/agents/tech-writer.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-bmm-ux-designer.md

@@ -6,7 +6,7 @@ description: 'ux-designer agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmm/agents/ux-designer.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/ux-designer/ux-designer.md (new layout); if absent, {project-root}/_byan/*/agents/ux-designer.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-byan-test.md

@@ -6,7 +6,7 @@ description: "BYAN Test - Token Optimized Version (-46%)"
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/byan-test.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/byan-test/byan-test.md (new layout); if absent, {project-root}/_byan/*/agents/byan-test.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,14 +18,14 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="byan-test.agent.yaml" name="BYAN-TEST" title="Builder of YAN - Test Version (Optimized)" icon="🏗️">
 <activation critical="MANDATORY">
-  <step n="1">Load persona from {project-root}/_byan/bmb/agents/byan-test.md</step>
+  <step n="1">Load persona from {project-root}/_byan/agent/byan-test/byan-test.md (new layout); if absent, {project-root}/_byan/*/agents/byan-test.md (legacy layout)</step>
   <step n="2">Load config from {project-root}/_byan/bmb/config.yaml - store {user_name}, {communication_language}, {output_folder}</step>
   <step n="3">Show greeting using {user_name} in {communication_language}, display menu</step>
   <step n="4">Inform about `/bmad-help` command</step>
   <step n="5">WAIT for input - accept number, cmd, or fuzzy match</step>
   <rules>
     <r>This is a TEST version of BYAN optimized for token reduction (-46%)</r>
-    <r>Full agent: _byan/bmb/agents/byan-test.md (116 lines vs 215 original)</r>
+    <r>Full agent: _byan/agent/byan-test/byan-test.md (new layout); if absent, _byan/*/agents/byan-test.md (legacy layout) (116 lines vs 215 original)</r>
     <r>Original BYAN still available via bmad-agent-byan</r>
   </rules>
 </activation>

package/install/templates/.github/agents/bmad-agent-byan.md

@@ -6,7 +6,7 @@ description: 'byan agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/agents/byan.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/byan/byan.md (new layout); if absent, {project-root}/_byan/*/agents/byan.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-carmack.md

@@ -3,10 +3,10 @@ name: "carmack"
 description: "Token Optimizer for BMAD/BYAN Agents"
 ---
 
-For the full agent definition and capabilities, see: `_byan/core/agents/carmack.md`
+For the full agent definition and capabilities, see: `_byan/agent/carmack/carmack.md (new layout); if absent, _byan/*/agents/carmack.md (legacy layout)`
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/core/agents/carmack.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/carmack/carmack.md (new layout); if absent, {project-root}/_byan/*/agents/carmack.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-brainstorming-coach.md

@@ -6,7 +6,7 @@ description: 'brainstorming-coach agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/brainstorming-coach.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/brainstorming-coach/brainstorming-coach.md (new layout); if absent, {project-root}/_byan/*/agents/brainstorming-coach.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-creative-problem-solver.md

@@ -6,7 +6,7 @@ description: 'creative-problem-solver agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/creative-problem-solver.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/creative-problem-solver/creative-problem-solver.md (new layout); if absent, {project-root}/_byan/*/agents/creative-problem-solver.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-design-thinking-coach.md

@@ -6,7 +6,7 @@ description: 'design-thinking-coach agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/design-thinking-coach.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/design-thinking-coach/design-thinking-coach.md (new layout); if absent, {project-root}/_byan/*/agents/design-thinking-coach.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-innovation-strategist.md

@@ -6,7 +6,7 @@ description: 'innovation-strategist agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/innovation-strategist.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/innovation-strategist/innovation-strategist.md (new layout); if absent, {project-root}/_byan/*/agents/innovation-strategist.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-presentation-master.md

@@ -6,7 +6,7 @@ description: 'presentation-master agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/presentation-master.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/presentation-master/presentation-master.md (new layout); if absent, {project-root}/_byan/*/agents/presentation-master.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-cis-storyteller.md

@@ -6,7 +6,7 @@ description: 'storyteller agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/cis/agents/storyteller/storyteller.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/storyteller/storyteller.md (new layout); if absent, {project-root}/_byan/*/agents/storyteller.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-claude.md

@@ -6,7 +6,7 @@ description: 'Claude Code integration specialist for BYAN agents'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/claude.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/claude/claude.md (new layout); if absent, {project-root}/_byan/*/agents/claude.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,7 +18,7 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="claude.agent.yaml" name="CLAUDE" title="Claude Code Integration Specialist" icon="🎭">
 <activation critical="MANDATORY">
-      <step n="1">Load persona from {project-root}/_byan/bmb/agents/claude.md</step>
+      <step n="1">Load persona from {project-root}/_byan/agent/claude/claude.md (new layout); if absent, {project-root}/_byan/*/agents/claude.md (legacy layout)</step>
       <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
       <step n="3">Show greeting and menu in {communication_language}</step>
       <step n="4">WAIT for user input</step>

package/install/templates/.github/agents/bmad-agent-codex.md

@@ -6,7 +6,7 @@ description: 'OpenCode/Codex integration specialist for BYAN skills'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/codex.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/codex/codex.md (new layout); if absent, {project-root}/_byan/*/agents/codex.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,7 +18,7 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="codex.agent.yaml" name="CODEX" title="OpenCode/Codex Integration Specialist" icon="📝">
 <activation critical="MANDATORY">
-      <step n="1">Load persona from {project-root}/_byan/bmb/agents/codex.md</step>
+      <step n="1">Load persona from {project-root}/_byan/agent/codex/codex.md (new layout); if absent, {project-root}/_byan/*/agents/codex.md (legacy layout)</step>
       <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
       <step n="3">Show greeting and menu in {communication_language}</step>
       <step n="4">WAIT for user input</step>

package/install/templates/.github/agents/bmad-agent-drawio.md

@@ -4,7 +4,7 @@ description: "Expert diagrammes techniques avec draw.io via MCP server"
 ---
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/drawio.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/drawio/drawio.md (new layout); if absent, {project-root}/_byan/*/agents/drawio.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -16,7 +16,7 @@ description: "Expert diagrammes techniques avec draw.io via MCP server"
 ```xml
 <agent id="drawio.agent.yaml" name="DRAWIO" title="Expert Diagrammes Draw.io" icon="📐">
 <activation critical="MANDATORY">
-      <step n="1">Load persona from {project-root}/_byan/bmb/agents/drawio.md</step>
+      <step n="1">Load persona from {project-root}/_byan/agent/drawio/drawio.md (new layout); if absent, {project-root}/_byan/*/agents/drawio.md (legacy layout)</step>
       <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
       <step n="3">Show greeting and menu in {communication_language}</step>
       <step n="4">WAIT for user input</step>

package/install/templates/.github/agents/bmad-agent-fact-checker.md

@@ -6,7 +6,7 @@ description: 'Scientific Fact-Check Agent — demonstrable, quantifiable, reprod
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/fact-checker.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/fact-checker/fact-checker.md (new layout); if absent, {project-root}/_byan/*/agents/fact-checker.md (legacy layout)
 2. READ its entire contents - this contains the complete persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-forgeron.md

@@ -6,7 +6,7 @@ description: 'Revelateur d ames — Interview psychologique profonde pour forger
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/forgeron.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/forgeron/forgeron.md (new layout); if absent, {project-root}/_byan/*/agents/forgeron.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-jimmy.md

@@ -6,7 +6,7 @@ description: 'Jimmy - Spécialiste Documentation Technique & Processus Internes
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/agents/jimmy.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/jimmy/jimmy.md (new layout); if absent, {project-root}/_byan/*/agents/jimmy.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. FOLLOW every step in the <activation> section precisely
 4. DISPLAY the welcome/greeting as instructed

package/install/templates/.github/agents/bmad-agent-marc.md

@@ -6,7 +6,7 @@ description: 'GitHub Copilot CLI integration specialist for BMAD agents'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/marc.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/marc/marc.md (new layout); if absent, {project-root}/_byan/*/agents/marc.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,7 +18,7 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="marc.agent.yaml" name="MARC" title="GitHub Copilot CLI Integration Specialist" icon="🤖">
 <activation critical="MANDATORY">
-      <step n="1">Load persona from {project-root}/_byan/bmb/agents/marc.md</step>
+      <step n="1">Load persona from {project-root}/_byan/agent/marc/marc.md (new layout); if absent, {project-root}/_byan/*/agents/marc.md (legacy layout)</step>
       <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
       <step n="3">Show greeting and menu in {communication_language}</step>
       <step n="4">WAIT for user input</step>

package/install/templates/.github/agents/bmad-agent-mike.md

@@ -6,7 +6,7 @@ description: 'Mike - Gestionnaire de Projet Spécialiste Leantime (Projets, Tâc
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/agents/mike.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/mike/mike.md (new layout); if absent, {project-root}/_byan/*/agents/mike.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. FOLLOW every step in the <activation> section precisely
 4. DISPLAY the welcome/greeting as instructed

package/install/templates/.github/agents/bmad-agent-patnote.md

@@ -6,7 +6,7 @@ description: "Patnote - BYAN Update Manager & Conflict Resolution Specialist"
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/patnote.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/patnote/patnote.md (new layout); if absent, {project-root}/_byan/*/agents/patnote.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,7 +18,7 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="patnote.agent.yaml" name="PATNOTE" title="Patnote - Gardien des Mises à Jour BYAN" icon="🛡️">
 <activation critical="MANDATORY">
-  <step n="1">Load persona from {project-root}/_byan/bmb/agents/patnote.md</step>
+  <step n="1">Load persona from {project-root}/_byan/agent/patnote/patnote.md (new layout); if absent, {project-root}/_byan/*/agents/patnote.md (legacy layout)</step>
   <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
   <step n="3">Detect current BYAN version and path</step>
   <step n="4">Show greeting and menu in {communication_language}</step>

package/install/templates/.github/agents/bmad-agent-rachid.md

@@ -6,7 +6,7 @@ description: 'NPM/NPX deployment specialist for BYAN installation'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/bmb/agents/rachid.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/rachid/rachid.md (new layout); if absent, {project-root}/_byan/*/agents/rachid.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely
@@ -18,7 +18,7 @@ You must fully embody this agent's persona and follow all activation instruction
 ```xml
 <agent id="rachid.agent.yaml" name="RACHID" title="NPM/NPX Deployment Specialist" icon="📦">
 <activation critical="MANDATORY">
-      <step n="1">Load persona from {project-root}/_byan/bmb/agents/rachid.md</step>
+      <step n="1">Load persona from {project-root}/_byan/agent/rachid/rachid.md (new layout); if absent, {project-root}/_byan/*/agents/rachid.md (legacy layout)</step>
       <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
       <step n="3">Show greeting and menu in {communication_language}</step>
       <step n="4">WAIT for user input</step>

package/install/templates/.github/agents/bmad-agent-skeptic.md

@@ -6,7 +6,7 @@ description: 'The Skeptic — Scientific Claim Challenger and Epistemic Guard'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/agents/skeptic.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/skeptic/skeptic.md (new layout); if absent, {project-root}/_byan/*/agents/skeptic.md (legacy layout)
 2. READ its entire contents — this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. EMBODY the Skeptic persona completely — methodical, rigorous, Socratic

package/install/templates/.github/agents/bmad-agent-tao.md

@@ -6,7 +6,7 @@ description: "Le Tao — Voice Director for BYAN Agents"
 You are the Tao agent. Load and follow ALL instructions from the agent definition file.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/agents/tao.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/tao/tao.md (new layout); if absent, {project-root}/_byan/*/agents/tao.md (legacy layout)
 2. READ its entire contents — this contains the complete agent persona and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-tea-tea.md

@@ -6,7 +6,7 @@ description: 'tea agent'
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/tea/agents/tea.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/tea/tea.md (new layout); if absent, {project-root}/_byan/*/agents/tea.md (legacy layout)
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW every step in the <activation> section precisely

package/install/templates/.github/agents/bmad-agent-test-dynamic.md

@@ -4,7 +4,7 @@ description: 'Test Dynamic Loading - Phase B Validation'
 ---
 
 <agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_byan/core/agents/test-dynamic.md
+1. LOAD the FULL agent file from {project-root}/_byan/agent/test-dynamic/test-dynamic.md (new layout); if absent, {project-root}/_byan/*/agents/test-dynamic.md (legacy layout)
 2. READ its entire contents
 3. LOAD the soul activation protocol from {project-root}/_byan/core/activation/soul-activation.md and EXECUTE it silently
 4. FOLLOW activation steps precisely
@@ -14,7 +14,7 @@ description: 'Test Dynamic Loading - Phase B Validation'
 ```xml
 <agent id="test-dynamic" name="TEST-DYNAMIC" title="Dynamic Loading Test" icon="🧪">
 <activation>
-  <step n="1">Load from {project-root}/_byan/core/agents/test-dynamic.md</step>
+  <step n="1">Load from {project-root}/_byan/agent/test-dynamic/test-dynamic.md (new layout); if absent, {project-root}/_byan/*/agents/test-dynamic.md (legacy layout)</step>
   <step n="2">Test inheritance from base agent</step>
   <step n="3">Display menu</step>
 </activation>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "2.19.0",
+  "version": "2.19.1",
   "description": "BYAN v2.8 - Intelligent AI agent creator with ELO trust system + scientific fact-check + Hermes universal dispatcher + native Claude Code integration (hooks, skills, MCP server). Multi-platform (Copilot CLI, Claude Code, Codex). Merise Agile + TDD + 64 Mantras. ~54% LLM cost savings.",
   "main": "src/index.js",
   "bin": {