@cubis/foundry 0.3.81 → 0.3.83

package/src/cli/core.ts

@@ -71,18 +71,26 @@ const PRODUCT_FOUNDATION_BLOCK_END_RE =
   /<!--\s*cbx:product:foundation:end\s*-->/g;
 const ARCHITECTURE_DOC_BLOCK_START_RE =
   /<!--\s*cbx:architecture:doc:start[^>]*-->/g;
-const ARCHITECTURE_DOC_BLOCK_END_RE =
-  /<!--\s*cbx:architecture:doc:end\s*-->/g;
+const ARCHITECTURE_DOC_BLOCK_END_RE = /<!--\s*cbx:architecture:doc:end\s*-->/g;
 const TECH_ARCHITECTURE_BLOCK_START_RE =
   /<!--\s*cbx:architecture:tech:start[^>]*-->/g;
 const TECH_ARCHITECTURE_BLOCK_END_RE =
   /<!--\s*cbx:architecture:tech:end\s*-->/g;
+const MEMORY_FOUNDATION_BLOCK_START_RE =
+  /<!--\s*cbx:memory:index:start[^>]*-->/g;
+const MEMORY_FOUNDATION_BLOCK_END_RE =
+  /<!--\s*cbx:memory:index:end\s*-->/g;
+const MEMORY_TOPIC_BLOCK_START_RE =
+  /<!--\s*cbx:memory:topic:start[^>]*-->/g;
+const MEMORY_TOPIC_BLOCK_END_RE =
+  /<!--\s*cbx:memory:topic:end\s*-->/g;
 const ROADMAP_FOUNDATION_BLOCK_START_RE =
   /<!--\s*cbx:roadmap:foundation:start[^>]*-->/g;
 const ROADMAP_FOUNDATION_BLOCK_END_RE =
   /<!--\s*cbx:roadmap:foundation:end\s*-->/g;
 const FOUNDATION_DOCS_DIR = path.join("docs", "foundation");
 const FOUNDATION_ADR_DIR = path.join(FOUNDATION_DOCS_DIR, "adr");
+const FOUNDATION_MEMORY_DIR = path.join(FOUNDATION_DOCS_DIR, "memory");
 const COPILOT_ALLOWED_SKILL_FRONTMATTER_KEYS = new Set([
   "compatibility",
   "description",
@@ -107,57 +115,59 @@ const WORKFLOW_PROFILES = {
   antigravity: {
     id: "antigravity",
     label: "Antigravity",
-    installsCustomAgents: true,
+    installsCustomAgents: false,
     project: {
-      workflowDirs: [".agent/workflows"],
-      agentDirs: [".agent/agents"],
-      skillDirs: [".agent/skills"],
+      workflowDirs: [],
+      agentDirs: [],
+      skillDirs: [".agents/skills"],
       commandDirs: [".gemini/commands"],
-      ruleFilesByPriority: [".agent/rules/GEMINI.md"],
+      ruleFilesByPriority: [".agents/rules/GEMINI.md"],
     },
     global: {
-      workflowDirs: [
-        "~/.gemini/antigravity/workflows",
-        "~/.gemini/antigravity/global_workflows",
-      ],
-      agentDirs: [
-        "~/.gemini/antigravity/agents",
-        "~/.gemini/antigravity/global_agents",
-      ],
+      workflowDirs: [],
+      agentDirs: [],
       skillDirs: [
         "~/.gemini/antigravity/skills",
-        "~/.gemini/antigravity/global_skills",
       ],
       commandDirs: ["~/.gemini/commands"],
       ruleFilesByPriority: ["~/.gemini/GEMINI.md"],
     },
-    detectorPaths: [".agent", ".agent/workflows", ".agent/rules/GEMINI.md"],
-    legacyDetectorPaths: [],
+    detectorPaths: [
+      ".agents/skills",
+      ".agents/rules/GEMINI.md",
+      ".gemini/commands",
+    ],
+    legacyDetectorPaths: [
+      ".agent",
+      ".agent/workflows",
+      ".agent/agents",
+      ".agent/skills",
+      ".agent/rules/GEMINI.md",
+    ],
     ruleHintName: "GEMINI.md",
   },
   codex: {
     id: "codex",
     label: "Codex",
-    installsCustomAgents: false,
+    installsCustomAgents: true,
     project: {
-      workflowDirs: [".agents/workflows"],
-      agentDirs: [".agents/agents"],
+      workflowDirs: [],
+      agentDirs: [".codex/agents"],
       skillDirs: [".agents/skills"],
       ruleFilesByPriority: ["AGENTS.md"],
     },
     global: {
-      workflowDirs: ["~/.agents/workflows"],
-      agentDirs: ["~/.agents/agents"],
+      workflowDirs: [],
+      agentDirs: ["~/.codex/agents"],
       skillDirs: ["~/.agents/skills"],
       ruleFilesByPriority: ["~/.codex/AGENTS.md"],
     },
     detectorPaths: [
-      ".agents",
-      ".agents/workflows",
+      ".codex/agents",
       ".agents/skills",
       "AGENTS.md",
     ],
-    legacyDetectorPaths: [".codex/skills"],
+    legacyDetectorPaths: [".agents/workflows", ".agents/agents", ".codex/skills"],
     ruleHintName: "AGENTS.md",
   },
   copilot: {
@@ -165,14 +175,14 @@ const WORKFLOW_PROFILES = {
     label: "GitHub Copilot",
     installsCustomAgents: true,
     project: {
-      workflowDirs: [".github/copilot/workflows"],
+      workflowDirs: [],
       agentDirs: [".github/agents"],
       skillDirs: [".github/skills"],
       promptDirs: [".github/prompts"],
       ruleFilesByPriority: [".github/copilot-instructions.md"],
     },
     global: {
-      workflowDirs: ["~/.copilot/workflows"],
+      workflowDirs: [],
       agentDirs: ["~/.copilot/agents"],
       skillDirs: ["~/.copilot/skills"],
       promptDirs: ["~/.copilot/prompts"],
@@ -194,14 +204,14 @@ const WORKFLOW_PROFILES = {
     label: "Claude Code",
     installsCustomAgents: true,
     project: {
-      workflowDirs: [".claude/workflows"],
+      workflowDirs: [],
       agentDirs: [".claude/agents"],
       skillDirs: [".claude/skills"],
       hookDirs: [".claude/hooks"],
       ruleFilesByPriority: ["CLAUDE.md"],
     },
     global: {
-      workflowDirs: ["~/.claude/workflows"],
+      workflowDirs: [],
       agentDirs: ["~/.claude/agents"],
       skillDirs: ["~/.claude/skills"],
       hookDirs: ["~/.claude/hooks"],
@@ -214,7 +224,7 @@ const WORKFLOW_PROFILES = {
       ".claude/rules",
       ".claude/settings.json",
     ],
-    legacyDetectorPaths: [],
+    legacyDetectorPaths: [".claude/workflows"],
     ruleHintName: "CLAUDE.md",
   },
   gemini: {
@@ -222,32 +232,29 @@ const WORKFLOW_PROFILES = {
     label: "Gemini CLI",
     installsCustomAgents: false,
     project: {
-      workflowDirs: [".gemini/workflows"],
-      skillDirs: [".gemini/skills"],
+      workflowDirs: [],
+      skillDirs: [],
       commandDirs: [".gemini/commands"],
       ruleFilesByPriority: [".gemini/GEMINI.md", "GEMINI.md"],
     },
     global: {
-      workflowDirs: ["~/.gemini/workflows"],
-      skillDirs: ["~/.gemini/skills"],
+      workflowDirs: [],
+      skillDirs: [],
       commandDirs: ["~/.gemini/commands"],
       ruleFilesByPriority: ["~/.gemini/GEMINI.md"],
     },
     detectorPaths: [
       ".gemini",
-      ".gemini/workflows",
       ".gemini/commands",
       ".gemini/GEMINI.md",
       "GEMINI.md",
     ],
-    legacyDetectorPaths: [],
+    legacyDetectorPaths: [".gemini/workflows", ".gemini/skills"],
     ruleHintName: "GEMINI.md",
   },
 };
 
 const PLATFORM_IDS = Object.keys(WORKFLOW_PROFILES);
-const CODEX_WORKFLOW_SKILL_PREFIX = "workflow-";
-const CODEX_AGENT_SKILL_PREFIX = "agent-";
 const TERMINAL_VERIFIER_PROVIDERS = ["codex", "gemini"];
 const DEFAULT_TERMINAL_VERIFIER = "codex";
 const POSTMAN_API_KEY_ENV_VAR = "POSTMAN_API_KEY_DEFAULT";
@@ -283,6 +290,7 @@ const RESERVED_CREDENTIAL_PROFILE_NAMES = new Set(["all"]);
 const CREDENTIAL_SERVICES = new Set(["postman", "stitch"]);
 const MCP_RUNTIMES = new Set(["docker", "local"]);
 const ARCHITECTURE_BUILD_PLATFORMS = new Set([
+  "antigravity",
   "codex",
   "claude",
   "gemini",
@@ -839,10 +847,12 @@ function toPosixPath(value) {
 }
 
 function getAntigravityTerminalIntegrationDir(profilePaths) {
-  return path.join(
-    path.dirname(profilePaths.workflowsDir),
-    "terminal-integration",
-  );
+  const baseDir =
+    profilePaths.rulesDir ||
+    profilePaths.skillsDir ||
+    profilePaths.commandsDir ||
+    profilePaths.rootDir;
+  return path.join(path.dirname(baseDir), "terminal-integration");
 }
 
 function buildTerminalVerifierDefaultPrompt() {
@@ -1056,7 +1066,8 @@ function inferArchitectureContractProfile(snapshot) {
       snapshot.topDirs.includes("app")
         ? "App-level UI patterns should be centralized and reused across screens."
         : null,
-    ]) || "No dedicated design-system directory detected; infer shared UI rules from current components and screens.";
+    ]) ||
+    "No dedicated design-system directory detected; infer shared UI rules from current components and screens.";
 
   const testingStrategy = [];
   if (snapshot.keyScripts.some((script) => script.name === "lint")) {
@@ -1107,7 +1118,8 @@ function buildArchitectureMermaid(snapshot) {
     '  user["User / Entry Point"] --> app["Application Surface"]',
   ];
   for (let index = 0; index < flowNodes.length; index += 1) {
-    const nodeName = flowNodes[index].replace(/[^A-Za-z0-9]/g, "") || `N${index}`;
+    const nodeName =
+      flowNodes[index].replace(/[^A-Za-z0-9]/g, "") || `N${index}`;
     lines.push(`  app --> ${nodeName}["${flowNodes[index]}/"]`);
   }
   if (snapshot.isMcpServer || snapshot.mcpSignals.length > 0) {
@@ -1123,21 +1135,31 @@ function inferProductFoundationProfile(snapshot, specRoots = []) {
   const appRoots = (snapshot.architectureByApp || [])
     .map((item) => item.rootPath)
     .filter((value) => value && value !== ".");
-  const primarySurfaces = appRoots.length > 0 ? appRoots : snapshot.topDirs.slice(0, 6);
+  const primarySurfaces =
+    appRoots.length > 0 ? appRoots : snapshot.topDirs.slice(0, 6);
   const userPersonas = [];
 
   if (snapshot.frameworks.includes("Flutter")) {
-    userPersonas.push("End users interacting through mobile or desktop app surfaces");
+    userPersonas.push(
+      "End users interacting through mobile or desktop app surfaces",
+    );
   }
   if (
     snapshot.frameworks.includes("Next.js") ||
     snapshot.frameworks.includes("React") ||
     snapshot.topDirs.includes("web")
   ) {
-    userPersonas.push("Browser users and internal operators using web-facing flows");
+    userPersonas.push(
+      "Browser users and internal operators using web-facing flows",
+    );
   }
-  if (snapshot.frameworks.includes("NestJS") || snapshot.topDirs.includes("api")) {
-    userPersonas.push("Internal services, operators, or partner systems consuming API boundaries");
+  if (
+    snapshot.frameworks.includes("NestJS") ||
+    snapshot.topDirs.includes("api")
+  ) {
+    userPersonas.push(
+      "Internal services, operators, or partner systems consuming API boundaries",
+    );
   }
   if (userPersonas.length === 0) {
     userPersonas.push(
@@ -1157,7 +1179,9 @@ function inferProductFoundationProfile(snapshot, specRoots = []) {
     );
   }
   if (snapshot.isMcpServer || snapshot.mcpSignals.length > 0) {
-    coreJourneys.push("Tool-assisted and MCP-driven workflows are part of the operating model and should stay stable.");
+    coreJourneys.push(
+      "Tool-assisted and MCP-driven workflows are part of the operating model and should stay stable.",
+    );
   }
   if (coreJourneys.length === 0) {
     coreJourneys.push(
@@ -1266,12 +1290,16 @@ function buildArchitectureDocSection(snapshot, specRoots = []) {
     "### Bounded Contexts and Module Boundaries",
     ...(profile.moduleBoundaries.length > 0
       ? profile.moduleBoundaries.map((item) => `- ${item}`)
-      : ["- No strong top-level module boundaries were detected automatically."]),
+      : [
+          "- No strong top-level module boundaries were detected automatically.",
+        ]),
     "",
     "### Architecture Signals by Surface",
     ...(profile.architectureSignals.length > 0
       ? profile.architectureSignals.map((item) => `- ${item}`)
-      : ["- No app-level architecture signals were inferred from the repo scan."]),
+      : [
+          "- No app-level architecture signals were inferred from the repo scan.",
+        ]),
     "",
     "### Decision Areas to Preserve",
     ...profile.decisionAreas.map((item) => `- ${item}`),
@@ -1309,12 +1337,14 @@ function buildEngineeringArchitectureSection(snapshot) {
     "- Module and package boundaries to preserve:",
     ...(profile.moduleBoundaries.length > 0
       ? profile.moduleBoundaries.map((rule) => `  - ${rule}`)
-      : ["  - No strong module boundary was detected automatically; keep new boundaries explicit in specs and ADRs."]),
+      : [
+          "  - No strong module boundary was detected automatically; keep new boundaries explicit in specs and ADRs.",
+        ]),
     "- Testability expectations:",
     ...profile.testingStrategy.map((rule) => `  - ${rule}`),
     "- Doc refresh policy:",
     "  - Update these managed sections when architecture, scale, boundaries, design-system rules, or testing strategy changes.",
-    `  - For non-trivial work, read ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ENGINEERING_RULES.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, and ${FOUNDATION_DOCS_DIR}/TECH.md in that order when they exist.`,
+    `  - For non-trivial work, read ${FOUNDATION_DOCS_DIR}/MEMORY.md first. Then load ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ENGINEERING_RULES.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, ${FOUNDATION_MEMORY_DIR}/*, and ADRs only when the active task needs that deeper context.`,
     "<!-- cbx:architecture:rules:end -->",
     "",
   ].join("\n");
@@ -1374,7 +1404,9 @@ function buildTechArchitectureSection(snapshot) {
     "### Module / App Topology",
     ...(profile.moduleBoundaries.length > 0
       ? profile.moduleBoundaries.map((item) => `- ${item}`)
-      : ["- No significant top-level module boundaries detected automatically."]),
+      : [
+          "- No significant top-level module boundaries detected automatically.",
+        ]),
     "",
     "### Flow Narratives",
     "- Describe the primary request, data, and background-job flows here when architecture generation runs.",
@@ -1402,11 +1434,12 @@ function buildRoadmapFoundationSection(snapshot, specRoots = []) {
     specRoots,
   };
   const hash = hashStableObject(payload);
-  const nowItems = specRoots.length > 0
-    ? specRoots.map((item) => `Track active change planning in \`${item}\`.`)
-    : [
-        "No active spec packs detected. Create a spec pack before starting the next non-trivial feature or migration.",
-      ];
+  const nowItems =
+    specRoots.length > 0
+      ? specRoots.map((item) => `Track active change planning in \`${item}\`.`)
+      : [
+          "No active spec packs detected. Create a spec pack before starting the next non-trivial feature or migration.",
+        ];
   const nextItems = [];
   if (snapshot.frameworks.length > 0) {
     nextItems.push(
@@ -1438,7 +1471,7 @@ function buildRoadmapFoundationSection(snapshot, specRoots = []) {
     "- Use this section for medium-term scaling themes, major migrations, or cross-team architecture investments.",
     "",
     "### Backbone Maintenance",
-    `- Keep ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ENGINEERING_RULES.md, and ${FOUNDATION_DOCS_DIR}/TECH.md aligned when direction or structure changes.`,
+    `- Keep ${FOUNDATION_DOCS_DIR}/MEMORY.md, ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ENGINEERING_RULES.md, and ${FOUNDATION_DOCS_DIR}/TECH.md aligned when direction or structure changes.`,
     "- Link major roadmap themes back to specs and ADRs instead of burying them in chat-only planning.",
     "<!-- cbx:roadmap:foundation:end -->",
     "",
@@ -1523,15 +1556,17 @@ function buildEngineeringRulesTemplate() {
     "- skill-name, workflow-name, or agent-name",
     "- or: none",
     "",
-    "## 9) Keep TECH.md Fresh",
+    "## 9) Keep Foundation Docs Fresh",
     "",
-    "- `TECH.md` is generated from current codebase reality.",
-    "- Re-run `cbx rules tech-md --overwrite` after major stack or architecture changes.",
+    "- `docs/foundation/MEMORY.md` is the AI entrypoint for non-trivial work.",
+    "- Read `docs/foundation/MEMORY.md` first, then load deeper foundation docs only when the active task needs them.",
+    "- Re-run `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>` after major product, architecture, runtime, or tooling changes.",
+    "- Re-run `cbx rules tech-md --overwrite` only when you specifically need the legacy root-level `TECH.md` snapshot refreshed.",
     "",
     "<!-- cbx:architecture:rules:start version=1 profile=bootstrap -->",
     "## 10) Architecture Contract (auto-managed)",
     "",
-    "- Declared style: bootstrap placeholder. Re-run `cbx build architecture --platform <codex|claude|gemini|copilot>` to refresh this contract from the repo.",
+    "- Declared style: bootstrap placeholder. Re-run `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>` to refresh this contract from the repo.",
     "- Design-system source of truth: bootstrap placeholder.",
     "- Dependency direction rules:",
     "  - Replace this placeholder with the managed architecture block when architecture generation runs.",
@@ -1587,7 +1622,7 @@ function buildProductBuildSkeleton() {
     "This file is managed by `cbx build architecture`.",
     "",
     "<!-- cbx:product:foundation:start version=1 profile=uninitialized -->",
-    "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+    "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
     "<!-- cbx:product:foundation:end -->",
     "",
   ].join("\n");
@@ -1600,7 +1635,7 @@ function buildArchitectureBuildSkeleton() {
     "This file is managed by `cbx build architecture`.",
     "",
     "<!-- cbx:architecture:doc:start version=1 profile=uninitialized -->",
-    "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+    "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
     "<!-- cbx:architecture:doc:end -->",
     "",
   ].join("\n");
@@ -1613,12 +1648,38 @@ function buildTechBuildSkeleton() {
     "This file is managed by `cbx build architecture`.",
     "",
     "<!-- cbx:architecture:tech:start version=1 snapshot=uninitialized -->",
-    "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+    "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
     "<!-- cbx:architecture:tech:end -->",
     "",
   ].join("\n");
 }
 
+function buildMemoryBuildSkeleton() {
+  return [
+    "# Memory",
+    "",
+    "This file is managed by `cbx build architecture` as the durable AI entrypoint for the project.",
+    "",
+    "<!-- cbx:memory:index:start version=1 profile=uninitialized -->",
+    "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
+    "<!-- cbx:memory:index:end -->",
+    "",
+  ].join("\n");
+}
+
+function buildMemoryTopicSkeleton(title, topicId) {
+  return [
+    `# ${title}`,
+    "",
+    "This file is managed by `cbx build architecture`.",
+    "",
+    `<!-- cbx:memory:topic:start version=1 topic=${topicId} profile=uninitialized -->`,
+    "Replace this managed section by running `cbx build architecture`.",
+    "<!-- cbx:memory:topic:end -->",
+    "",
+  ].join("\n");
+}
+
 function buildAdrReadme() {
   return [
     "# Architecture Decision Records",
@@ -1673,6 +1734,7 @@ function buildAdrTemplate() {
 
 function buildEngineeringRulesManagedBlock({
   platform,
+  memoryFilePath,
   productFilePath,
   architectureFilePath,
   engineeringRulesFilePath,
@@ -1680,6 +1742,7 @@ function buildEngineeringRulesManagedBlock({
   roadmapFilePath,
   ruleFilePath,
 }) {
+  const memoryRef = toPosixPath(path.resolve(memoryFilePath));
   const productRef = toPosixPath(path.resolve(productFilePath));
   const architectureRef = toPosixPath(path.resolve(architectureFilePath));
   const engineeringRef = toPosixPath(path.resolve(engineeringRulesFilePath));
@@ -1687,28 +1750,58 @@ function buildEngineeringRulesManagedBlock({
   const roadmapRef = toPosixPath(path.resolve(roadmapFilePath));
   const ruleRef = toPosixPath(path.resolve(ruleFilePath));
 
+  const supportsAtImport = platform === "claude" || platform === "gemini";
+  const ruleFileDir = path.dirname(path.resolve(ruleFilePath));
+  const relMemory = toPosixPath(
+    path.relative(ruleFileDir, path.resolve(memoryFilePath)),
+  );
+  const relProduct = toPosixPath(
+    path.relative(ruleFileDir, path.resolve(productFilePath)),
+  );
+  const relArchitecture = toPosixPath(
+    path.relative(ruleFileDir, path.resolve(architectureFilePath)),
+  );
+  const relTech = toPosixPath(
+    path.relative(ruleFileDir, path.resolve(techMdFilePath)),
+  );
+
+  const importLines = supportsAtImport
+    ? [
+        "",
+        "Foundation memory index (auto-imported into context):",
+        `@${relMemory}`,
+        "Load deeper docs from MEMORY.md only when needed:",
+        `- ${relProduct}`,
+        `- ${relArchitecture}`,
+        `- ${relTech}`,
+      ]
+    : [];
+
   return [
     `<!-- cbx:engineering:auto:start platform=${platform} version=1 -->`,
     "## Engineering Guardrails (auto-managed)",
     "Apply these before planning, coding, review, and release:",
     "",
+    `- Shared memory index: \`${memoryRef}\``,
     `- Product backbone: \`${productRef}\``,
     `- Accepted architecture: \`${architectureRef}\``,
     `- Required baseline: \`${engineeringRef}\``,
     `- Project tech map: \`${techRef}\``,
     `- Delivery roadmap: \`${roadmapRef}\``,
     `- Active platform rule file: \`${ruleRef}\``,
+    ...importLines,
     "",
     "Hard policy:",
     "1. Start from product outcomes and ship the smallest valuable slice.",
     "2. Keep architecture simple (KISS) and avoid speculative work (YAGNI).",
     "3. Apply SOLID pragmatically to reduce change risk, not add ceremony.",
     "4. Use clear naming with focused responsibilities and explicit boundaries.",
-    `5. For non-trivial work, read ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ENGINEERING_RULES.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, and ${FOUNDATION_DOCS_DIR}/TECH.md in that order when they exist before planning or implementation.`,
-    "6. Require validation evidence (lint/types/tests) before merge.",
-    "7. Use Decision Log response style.",
-    "8. Every Decision Log must include a `Skills Used` section listing skill, workflow, or agent names.",
-    "9. If no skill loaded, `Skills Used: none` is mandatory.",
+    `5. For non-trivial work, read ${FOUNDATION_DOCS_DIR}/MEMORY.md first. Then load ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, ${FOUNDATION_MEMORY_DIR}/*, and ADRs only when the active task needs that deeper context. Check ${FOUNDATION_DOCS_DIR}/PRODUCT.md for domain glossary and ${FOUNDATION_DOCS_DIR}/TECH.md for build/validation commands.`,
+    "6. Use MEMORY.md's load map and consumer notes to decide which deeper docs the active workflow, agent, or skill should consult.",
+    "7. Require validation evidence (lint/types/tests) before merge.",
+    "8. Use Decision Log response style.",
+    "9. Every Decision Log must include a `Skills Used` section listing skill, workflow, or agent names.",
+    "10. If no skill loaded, `Skills Used: none` is mandatory.",
     "",
     "<!-- cbx:engineering:auto:end -->",
   ].join("\n");
@@ -1829,6 +1922,7 @@ async function upsertEngineeringRulesFile({
 async function upsertEngineeringRulesBlock({
   ruleFilePath,
   platform,
+  memoryFilePath,
   productFilePath,
   architectureFilePath,
   engineeringRulesFilePath,
@@ -1838,6 +1932,7 @@ async function upsertEngineeringRulesBlock({
 }) {
   const block = buildEngineeringRulesManagedBlock({
     platform,
+    memoryFilePath,
     productFilePath,
     architectureFilePath,
     engineeringRulesFilePath,
@@ -2095,6 +2190,12 @@ async function ensureArchitectureBuildScaffold({
   const productPath = path.join(foundationRoot, "PRODUCT.md");
   const architectureDocPath = path.join(foundationRoot, "ARCHITECTURE.md");
   const techMdPath = path.join(foundationRoot, "TECH.md");
+  const memoryPath = path.join(foundationRoot, "MEMORY.md");
+  const memoryDir = path.join(workspaceRoot, FOUNDATION_MEMORY_DIR);
+  const domainMemoryPath = path.join(memoryDir, "domain.md");
+  const runtimeMemoryPath = path.join(memoryDir, "runtime.md");
+  const integrationsMemoryPath = path.join(memoryDir, "integrations.md");
+  const debuggingMemoryPath = path.join(memoryDir, "debugging.md");
   const adrDir = path.join(workspaceRoot, FOUNDATION_ADR_DIR);
   const adrReadmePath = path.join(adrDir, "README.md");
   const adrTemplatePath = path.join(adrDir, "0000-template.md");
@@ -2104,7 +2205,7 @@ async function ensureArchitectureBuildScaffold({
     initialContent: `${buildProductBuildSkeleton()}\n`,
     block: [
       "<!-- cbx:product:foundation:start version=1 profile=uninitialized -->",
-      "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+      "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
       "<!-- cbx:product:foundation:end -->",
       "",
     ].join("\n"),
@@ -2118,7 +2219,7 @@ async function ensureArchitectureBuildScaffold({
     initialContent: `${buildArchitectureBuildSkeleton()}\n`,
     block: [
       "<!-- cbx:architecture:doc:start version=1 profile=uninitialized -->",
-      "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+      "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
       "<!-- cbx:architecture:doc:end -->",
       "",
     ].join("\n"),
@@ -2132,7 +2233,7 @@ async function ensureArchitectureBuildScaffold({
     initialContent: `${buildTechBuildSkeleton()}\n`,
     block: [
       "<!-- cbx:architecture:tech:start version=1 snapshot=uninitialized -->",
-      "Replace this managed section by running `cbx build architecture --platform <codex|claude|gemini|copilot>`.",
+      "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
       "<!-- cbx:architecture:tech:end -->",
       "",
     ].join("\n"),
@@ -2141,6 +2242,76 @@ async function ensureArchitectureBuildScaffold({
     dryRun,
   });
 
+  const memoryResult = await upsertTaggedSectionInFile({
+    targetPath: memoryPath,
+    initialContent: `${buildMemoryBuildSkeleton()}\n`,
+    block: [
+      "<!-- cbx:memory:index:start version=1 profile=uninitialized -->",
+      "Replace this managed section by running `cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>`.",
+      "<!-- cbx:memory:index:end -->",
+      "",
+    ].join("\n"),
+    startPattern: MEMORY_FOUNDATION_BLOCK_START_RE,
+    endPattern: MEMORY_FOUNDATION_BLOCK_END_RE,
+    dryRun,
+  });
+
+  const domainMemoryResult = await upsertTaggedSectionInFile({
+    targetPath: domainMemoryPath,
+    initialContent: `${buildMemoryTopicSkeleton("Domain Memory", "domain")}\n`,
+    block: [
+      "<!-- cbx:memory:topic:start version=1 topic=domain profile=uninitialized -->",
+      "Replace this managed section by running `cbx build architecture`.",
+      "<!-- cbx:memory:topic:end -->",
+      "",
+    ].join("\n"),
+    startPattern: MEMORY_TOPIC_BLOCK_START_RE,
+    endPattern: MEMORY_TOPIC_BLOCK_END_RE,
+    dryRun,
+  });
+
+  const runtimeMemoryResult = await upsertTaggedSectionInFile({
+    targetPath: runtimeMemoryPath,
+    initialContent: `${buildMemoryTopicSkeleton("Runtime Memory", "runtime")}\n`,
+    block: [
+      "<!-- cbx:memory:topic:start version=1 topic=runtime profile=uninitialized -->",
+      "Replace this managed section by running `cbx build architecture`.",
+      "<!-- cbx:memory:topic:end -->",
+      "",
+    ].join("\n"),
+    startPattern: MEMORY_TOPIC_BLOCK_START_RE,
+    endPattern: MEMORY_TOPIC_BLOCK_END_RE,
+    dryRun,
+  });
+
+  const integrationsMemoryResult = await upsertTaggedSectionInFile({
+    targetPath: integrationsMemoryPath,
+    initialContent: `${buildMemoryTopicSkeleton("Integrations Memory", "integrations")}\n`,
+    block: [
+      "<!-- cbx:memory:topic:start version=1 topic=integrations profile=uninitialized -->",
+      "Replace this managed section by running `cbx build architecture`.",
+      "<!-- cbx:memory:topic:end -->",
+      "",
+    ].join("\n"),
+    startPattern: MEMORY_TOPIC_BLOCK_START_RE,
+    endPattern: MEMORY_TOPIC_BLOCK_END_RE,
+    dryRun,
+  });
+
+  const debuggingMemoryResult = await upsertTaggedSectionInFile({
+    targetPath: debuggingMemoryPath,
+    initialContent: `${buildMemoryTopicSkeleton("Debugging Memory", "debugging")}\n`,
+    block: [
+      "<!-- cbx:memory:topic:start version=1 topic=debugging profile=uninitialized -->",
+      "Replace this managed section by running `cbx build architecture`.",
+      "<!-- cbx:memory:topic:end -->",
+      "",
+    ].join("\n"),
+    startPattern: MEMORY_TOPIC_BLOCK_START_RE,
+    endPattern: MEMORY_TOPIC_BLOCK_END_RE,
+    dryRun,
+  });
+
   const adrReadmeResult = await writeTextFile({
     targetPath: adrReadmePath,
     content: `${buildAdrReadme()}\n`,
@@ -2158,11 +2329,21 @@ async function ensureArchitectureBuildScaffold({
     productPath,
     architectureDocPath,
     techMdPath,
+    memoryPath,
+    domainMemoryPath,
+    runtimeMemoryPath,
+    integrationsMemoryPath,
+    debuggingMemoryPath,
     adrReadmePath,
     adrTemplatePath,
     productResult,
     architectureDocResult,
     techResult,
+    memoryResult,
+    domainMemoryResult,
+    runtimeMemoryResult,
+    integrationsMemoryResult,
+    debuggingMemoryResult,
     adrReadmeResult,
     adrTemplateResult,
   };
@@ -3557,7 +3738,8 @@ function targetStateKey(platform, scope) {
 }
 
 function getStateFilePath(scope, cwd = process.cwd()) {
-  if (scope === "global") return path.join(os.homedir(), ".cbx", "state.json");
+  if (scope === "global")
+    return path.join(resolveManagedHomeDir(), ".cbx", "state.json");
   return path.join(cwd, ".cbx", "workflows-state.json");
 }
 
@@ -3751,9 +3933,9 @@ async function resolveProfilePaths(profileId, scope, cwd = process.cwd()) {
     workflowsDir: await resolvePreferredDir(workflowDirs),
     agentsDir: await resolvePreferredDir(agentDirs),
     skillsDir: await resolvePreferredDir(skillDirs),
-    commandsDir: commandDirs[0] ? expandPath(commandDirs[0], cwd) : null,
-    promptsDir: promptDirs[0] ? expandPath(promptDirs[0], cwd) : null,
-    hooksDir: hookDirs[0] ? expandPath(hookDirs[0], cwd) : null,
+    commandsDir: await resolvePreferredDir(commandDirs),
+    promptsDir: await resolvePreferredDir(promptDirs),
+    hooksDir: await resolvePreferredDir(hookDirs),
     ruleFilesByPriority: cfg.ruleFilesByPriority.map((filePath) =>
       expandPath(filePath, cwd),
     ),
@@ -4384,53 +4566,10 @@ function normalizeMarkdownId(fileName) {
     .replace(/^-|-$/g, "");
 }
 
-function yamlSingleQuoted(value) {
-  return `'${String(value || "").replace(/'/g, "''")}'`;
-}
-
 function escapeRegExp(value) {
   return String(value).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
-function rewriteCodexWorkflowAgentReferences(sourceBody, agentIds) {
-  if (!sourceBody || !Array.isArray(agentIds) || agentIds.length === 0)
-    return normalizeCodexWrapperMentions(sourceBody);
-
-  let rewritten = sourceBody;
-  const sortedAgentIds = unique(agentIds.filter(Boolean)).sort(
-    (a, b) => b.length - a.length,
-  );
-
-  for (const agentId of sortedAgentIds) {
-    const agentPattern = new RegExp(
-      `(^|[^A-Za-z0-9_-])@${escapeRegExp(agentId)}(?=$|[^A-Za-z0-9_-])`,
-      "g",
-    );
-    rewritten = rewritten.replace(
-      agentPattern,
-      (_match, prefix) => `${prefix}$${CODEX_AGENT_SKILL_PREFIX}${agentId}`,
-    );
-  }
-
-  return normalizeCodexWrapperMentions(rewritten);
-}
-
-function rewriteCodexAgentSkillReferences(sourceBody) {
-  if (!sourceBody) return sourceBody;
-  // Agent source files live under platforms/*/agents, but wrapper skills live
-  // under .agents/skills/agent-*. Rebase ../skills/<id> links accordingly.
-  const rebased = sourceBody.replace(/\(\.\.\/skills\//g, "(../");
-  return normalizeCodexWrapperMentions(rebased);
-}
-
-function normalizeCodexWrapperMentions(sourceBody) {
-  if (!sourceBody) return sourceBody;
-  return sourceBody.replace(
-    /`\$(workflow|agent)-([A-Za-z0-9_-]+|\*)`/g,
-    (_match, kind, id) => `$${kind}-${id}`,
-  );
-}
-
 async function parseWorkflowMetadata(filePath) {
   const raw = await readFile(filePath, "utf8");
   const { frontmatter, body } = extractFrontmatter(raw);
@@ -4475,217 +4614,6 @@ async function parseAgentMetadata(filePath) {
   };
 }
 
-function buildCodexWorkflowWrapperSkillMarkdown(wrapperSkillId, workflow) {
-  const description = `Callable Codex wrapper for ${workflow.command}: ${workflow.description}`;
-  const sourceBody =
-    workflow.body?.trim() || "No source workflow content found.";
-
-  return [
-    "---",
-    `name: ${wrapperSkillId}`,
-    `description: ${yamlSingleQuoted(description)}`,
-    "metadata:",
-    "  source: cubis-foundry",
-    "  wrapper: workflow",
-    "  platform: codex",
-    `  workflow-id: ${yamlSingleQuoted(workflow.id)}`,
-    `  workflow-command: ${yamlSingleQuoted(workflow.command)}`,
-    "---",
-    "",
-    `# Workflow Compatibility Alias: ${workflow.command}`,
-    "",
-    `Compatibility alias for \`${workflow.command}\` in Codex. Prefer the direct workflow route first and use this wrapper only when older installs or prompts mention $${wrapperSkillId}.`,
-    "",
-    "## Invocation Contract",
-    "1. Resolve the workflow route first; do not use this alias as a substitute for skill discovery.",
-    "2. Follow the sequence and guardrails in the source instructions below.",
-    "3. Produce actionable output and call out assumptions before edits.",
-    "",
-    "## Source Workflow Instructions",
-    "",
-    sourceBody,
-    "",
-  ].join("\n");
-}
-
-function buildCodexAgentWrapperSkillMarkdown(wrapperSkillId, agent) {
-  const description = `Callable Codex wrapper for @${agent.id}: ${agent.description}`;
-  const sourceBody = agent.body?.trim() || "No source agent content found.";
-  const relatedSkillsLine =
-    agent.skills.length > 0
-      ? `Related skills from source agent: ${agent.skills.join(", ")}`
-      : "Related skills from source agent: (none listed)";
-
-  return [
-    "---",
-    `name: ${wrapperSkillId}`,
-    `description: ${yamlSingleQuoted(description)}`,
-    "metadata:",
-    "  source: cubis-foundry",
-    "  wrapper: agent",
-    "  platform: codex",
-    `  agent-id: ${yamlSingleQuoted(agent.id)}`,
-    "---",
-    "",
-    `# Agent Compatibility Alias: @${agent.id}`,
-    "",
-    `Compatibility alias for @${agent.id} in Codex. Prefer the direct @agent route first and use this wrapper only when older installs or prompts mention $${wrapperSkillId}.`,
-    "",
-    "## Invocation Contract",
-    "1. Resolve the agent route first; do not use this alias as a substitute for skill discovery.",
-    "2. Adopt the role and constraints defined in the source agent content.",
-    "3. Apply domain heuristics and escalation rules before coding.",
-    "4. Ask clarifying questions when requirements are ambiguous.",
-    "",
-    `- Source agent name: ${agent.name}`,
-    `- Source agent description: ${agent.description}`,
-    `- ${relatedSkillsLine}`,
-    "",
-    "## Source Agent Instructions",
-    "",
-    sourceBody,
-    "",
-  ].join("\n");
-}
-
-async function writeGeneratedSkillArtifact({
-  destinationDir,
-  content,
-  overwrite,
-  dryRun = false,
-}) {
-  const exists = await pathExists(destinationDir);
-  if (exists && !overwrite) {
-    return { action: dryRun ? "would-skip" : "skipped", path: destinationDir };
-  }
-
-  if (!dryRun && exists && overwrite) {
-    await rm(destinationDir, { recursive: true, force: true });
-  }
-
-  if (!dryRun) {
-    await mkdir(destinationDir, { recursive: true });
-    await writeFile(path.join(destinationDir, "SKILL.md"), content, "utf8");
-  }
-
-  if (dryRun) {
-    return {
-      action: exists ? "would-replace" : "would-install",
-      path: destinationDir,
-    };
-  }
-
-  return { action: exists ? "replaced" : "installed", path: destinationDir };
-}
-
-function buildCodexWrapperSkillIds(platformSpec) {
-  const workflowIds = (platformSpec.workflows || []).map((fileName) => {
-    const id = normalizeMarkdownId(path.basename(fileName));
-    return `${CODEX_WORKFLOW_SKILL_PREFIX}${id}`;
-  });
-
-  const agentIds = (platformSpec.agents || []).map((fileName) => {
-    const id = normalizeMarkdownId(path.basename(fileName));
-    return `${CODEX_AGENT_SKILL_PREFIX}${id}`;
-  });
-
-  return unique([...workflowIds, ...agentIds]);
-}
-
-async function generateCodexWrapperSkills({
-  platformRoot,
-  platformSpec,
-  skillsDir,
-  overwrite,
-  dryRun = false,
-}) {
-  const installed = [];
-  const skipped = [];
-  const artifacts = [];
-  const generated = [];
-  const codexAgentIds = (platformSpec.agents || []).map((fileName) =>
-    normalizeMarkdownId(path.basename(fileName)),
-  );
-
-  for (const workflowFile of platformSpec.workflows || []) {
-    const source = path.join(platformRoot, "workflows", workflowFile);
-    if (!(await pathExists(source))) {
-      throw new Error(
-        `Missing workflow source file for wrapper generation: ${source}`,
-      );
-    }
-
-    const metadata = await parseWorkflowMetadata(source);
-    const raw = await readFile(source, "utf8");
-    const sourceBody = extractFrontmatter(raw).body.trim();
-    const rewrittenBody = rewriteCodexWorkflowAgentReferences(
-      sourceBody,
-      codexAgentIds,
-    );
-    const wrapperSkillId = `${CODEX_WORKFLOW_SKILL_PREFIX}${metadata.id}`;
-    const destinationDir = path.join(skillsDir, wrapperSkillId);
-    const content = buildCodexWorkflowWrapperSkillMarkdown(wrapperSkillId, {
-      ...metadata,
-      body: rewrittenBody,
-    });
-
-    const result = await writeGeneratedSkillArtifact({
-      destinationDir,
-      content,
-      overwrite,
-      dryRun,
-    });
-
-    artifacts.push(destinationDir);
-    generated.push({
-      kind: "workflow",
-      id: metadata.id,
-      skillId: wrapperSkillId,
-    });
-    if (result.action === "skipped" || result.action === "would-skip")
-      skipped.push(destinationDir);
-    else installed.push(destinationDir);
-  }
-
-  for (const agentFile of platformSpec.agents || []) {
-    const source = path.join(platformRoot, "agents", agentFile);
-    if (!(await pathExists(source))) {
-      throw new Error(
-        `Missing agent source file for wrapper generation: ${source}`,
-      );
-    }
-
-    const metadata = await parseAgentMetadata(source);
-    const rewrittenBody = rewriteCodexAgentSkillReferences(metadata.body);
-    const wrapperSkillId = `${CODEX_AGENT_SKILL_PREFIX}${metadata.id}`;
-    const destinationDir = path.join(skillsDir, wrapperSkillId);
-    const content = buildCodexAgentWrapperSkillMarkdown(wrapperSkillId, {
-      ...metadata,
-      body: rewrittenBody,
-    });
-
-    const result = await writeGeneratedSkillArtifact({
-      destinationDir,
-      content,
-      overwrite,
-      dryRun,
-    });
-
-    artifacts.push(destinationDir);
-    generated.push({ kind: "agent", id: metadata.id, skillId: wrapperSkillId });
-    if (result.action === "skipped" || result.action === "would-skip")
-      skipped.push(destinationDir);
-    else installed.push(destinationDir);
-  }
-
-  return {
-    installed,
-    skipped,
-    artifacts,
-    generated,
-  };
-}
-
 async function resolvePlatformAgentSkillDependencies({
   platformRoot,
   platformSpec,
@@ -4707,15 +4635,51 @@ async function collectInstalledWorkflows(
   scope,
   cwd = process.cwd(),
 ) {
-  // Global install mode keeps workflows/agents in workspace paths.
-  // Index using artifact-aware paths so sync-rules reflects installed workflows.
+  const workflows = [];
+  const state = await readState(scope, cwd);
+  const key = targetStateKey(profileId, scope);
+  const bundleEntries = Object.entries(state.targets?.[key]?.bundles || {});
+  const seen = new Set();
+
+  for (const [bundleId] of bundleEntries) {
+    const sharedWorkflowsDir = path.join(
+      agentAssetsRoot(),
+      "workflows",
+      bundleId,
+      "shared",
+      "workflows",
+    );
+    if (!(await pathExists(sharedWorkflowsDir))) continue;
+    const entries = await readdir(sharedWorkflowsDir, {
+      withFileTypes: true,
+    });
+    for (const entry of entries) {
+      if (
+        !entry.isFile() ||
+        !entry.name.endsWith(".md") ||
+        entry.name.startsWith(".")
+      ) {
+        continue;
+      }
+      const filePath = path.join(sharedWorkflowsDir, entry.name);
+      const metadata = await parseWorkflowMetadata(filePath);
+      if (seen.has(metadata.id)) continue;
+      seen.add(metadata.id);
+      workflows.push(metadata);
+    }
+  }
+
+  if (workflows.length > 0) {
+    return workflows.sort((a, b) => a.command.localeCompare(b.command));
+  }
+
   const profilePaths = await resolveArtifactProfilePaths(profileId, scope, cwd);
-  if (!(await pathExists(profilePaths.workflowsDir))) return [];
+  if (!profilePaths.workflowsDir || !(await pathExists(profilePaths.workflowsDir)))
+    return [];
 
   const entries = await readdir(profilePaths.workflowsDir, {
     withFileTypes: true,
   });
-  const workflows = [];
 
   for (const entry of entries) {
     if (
@@ -4792,9 +4756,8 @@ function buildManagedWorkflowBlock(platformId, workflows) {
     lines.push("Prefer direct route identifiers first:");
     lines.push("- Workflows: `/workflow-name`");
     lines.push("- Agents: `@agent-name`");
-    lines.push(
-      "- Compatibility aliases remain available: `$workflow-*`, `$agent-*`",
-    );
+    lines.push("- Native agents: `.codex/agents/*.toml`");
+    lines.push("- Native workflow skills: `.agents/skills/<workflow-id>/SKILL.md`");
     lines.push("");
 
     if (workflows.length === 0) {
@@ -4815,9 +4778,7 @@ function buildManagedWorkflowBlock(platformId, workflows) {
       "1. If the user names `/workflow` or `@agent`, use that route directly.",
     );
     lines.push("2. Else map intent to one primary workflow.");
-    lines.push(
-      "3. Treat `$workflow-*` / `$agent-*` as compatibility aliases only.",
-    );
+    lines.push("3. Load supporting skills only after route selection.");
     lines.push("");
     lines.push("<!-- cbx:workflows:auto:end -->");
     return lines.join("\n");
@@ -4825,46 +4786,31 @@ function buildManagedWorkflowBlock(platformId, workflows) {
 
   if (platformId === "copilot") {
     lines.push("Prefer native Copilot route surfaces first:");
-    lines.push("- Workflow prompts: `.github/prompts/workflow-*.prompt.md`");
-    lines.push("- Workflow files: `.github/copilot/workflows/*.md`");
+    lines.push("- Workflow prompts: `.github/prompts/*.prompt.md`");
+    lines.push("- Agents: `.github/agents/*.md`");
+    lines.push("- Skills: `.github/skills/<skill>/SKILL.md`");
     lines.push("- Agents: `@agent-name`");
     lines.push("- Workspace-first MCP: `.vscode/mcp.json`");
-    lines.push(
-      "- Do not use `$workflow-*` / `$agent-*` as the primary route surface here; those are Codex compatibility aliases.",
-    );
-    lines.push(
-      "- `.github/skills` is installed by default, but route through workflows and agents before loading skills.",
-    );
     lines.push("");
   } else if (platformId === "antigravity") {
     lines.push("Prefer native Antigravity route surfaces first:");
     lines.push("- Commands: `.gemini/commands/*.toml`");
-    lines.push("- Workflow files: `.agent/workflows/*.md`");
-    lines.push("- Agents: `@agent-name`");
-    lines.push(
-      "- Do not use `$workflow-*` / `$agent-*` as the primary route surface here; those are Codex compatibility aliases.",
-    );
+    lines.push("- Rules: `.agents/rules/GEMINI.md`");
+    lines.push("- Skills: `.agents/skills/<skill>/SKILL.md`");
+    lines.push("- Agent routes compile to native command/rule flows here.");
     lines.push("");
   } else if (platformId === "claude") {
     lines.push("Prefer native Claude Code route surfaces first:");
     lines.push("- Rules: `.claude/rules/*.md`");
-    lines.push("- Workflow files: `.claude/workflows/*.md`");
+    lines.push("- Skills: `.claude/skills/<skill>/SKILL.md`");
+    lines.push("- Agents: `.claude/agents/*.md`");
     lines.push("- Memory: `CLAUDE.md`");
-    lines.push(
-      "- Do not use `$workflow-*` / `$agent-*` as the primary route surface here; those are Codex compatibility aliases.",
-    );
     lines.push("");
   } else if (platformId === "gemini") {
     lines.push("Prefer native Gemini route surfaces first:");
     lines.push("- Commands: `.gemini/commands/*.toml`");
-    lines.push("- Workflow files: `.gemini/workflows/*.md`");
     lines.push("- Rules: `.gemini/GEMINI.md`");
-    lines.push(
-      "- Specialists are inline postures here, not standalone agent files.",
-    );
-    lines.push(
-      "- Do not use `$workflow-*` / `$agent-*` as the primary route surface here; those are Codex compatibility aliases.",
-    );
+    lines.push("- Route specialists through commands and rule guidance.");
     lines.push("");
   }
 
@@ -4891,39 +4837,21 @@ function buildManagedWorkflowBlock(platformId, workflows) {
   lines.push("");
   lines.push("Selection policy:");
   if (platformId === "copilot") {
-    lines.push(
-      "1. Match explicit workflow prompt, workflow, or `@agent` first.",
-    );
-    lines.push(
-      "2. Else match user intent to one primary workflow and reuse the matching prompt file when available.",
-    );
-    lines.push(
-      "3. Treat `$workflow-*` / `$agent-*` as Codex compatibility aliases, not as the primary route surface here.",
-    );
+    lines.push("1. Match explicit workflow prompt or `@agent` first.");
+    lines.push("2. Else match user intent to one primary workflow and reuse the matching prompt file.");
+    lines.push("3. Use skill_search only when the best workflow or agent route is unclear.");
   } else if (platformId === "antigravity") {
-    lines.push(
-      "1. Match explicit Gemini command, workflow, or `@agent` first.",
-    );
-    lines.push(
-      "2. Else match user intent to one primary workflow and use the matching command file when available.",
-    );
-    lines.push(
-      "3. Treat `$workflow-*` / `$agent-*` as Codex compatibility aliases, not as the primary route surface here.",
-    );
+    lines.push("1. Match explicit Gemini command first.");
+    lines.push("2. Else match user intent to one primary workflow and use the matching command file.");
+    lines.push("3. Use skill_search only when workflow intent is unclear.");
   } else if (platformId === "claude") {
-    lines.push("1. Match explicit workflow or scoped rule first.");
+    lines.push("1. Match explicit workflow skill or `@agent` first.");
     lines.push("2. Else match user intent to one primary workflow.");
-    lines.push(
-      "3. Treat `$workflow-*` / `$agent-*` as Codex compatibility aliases, not as the primary route surface here.",
-    );
+    lines.push("3. Use skill_search only when workflow intent is unclear.");
   } else if (platformId === "gemini") {
-    lines.push("1. Match explicit Gemini command or workflow first.");
-    lines.push(
-      "2. Else match user intent to one primary workflow and use the matching command file when available.",
-    );
-    lines.push(
-      "3. Treat specialists as inline postures defined by GEMINI.md, not separate agent files.",
-    );
+    lines.push("1. Match explicit Gemini command first.");
+    lines.push("2. Else match user intent to one primary workflow and use the matching command file.");
+    lines.push("3. Keep specialists inside the command plan; there are no standalone agent files.");
   } else {
     lines.push("1. Match explicit slash command first.");
     lines.push(
@@ -5150,7 +5078,24 @@ async function syncRulesForPlatform({
   if (!ruleFilePath)
     throw new Error(`No rule file configured for platform '${platform}'.`);
 
-  const workflows = await collectInstalledWorkflows(platform, scope, cwd);
+  let workflows = await collectInstalledWorkflows(platform, scope, cwd);
+  if (scope === "global") {
+    const workspaceRuleFile = await resolveWorkspaceRuleFileForGlobalScope(
+      platform,
+      cwd,
+    );
+    const profile = WORKFLOW_PROFILES[platform];
+    const globalRuleFile = profile
+      ? expandPath(profile.global.ruleFilesByPriority[0], cwd)
+      : null;
+    if (
+      workspaceRuleFile &&
+      globalRuleFile &&
+      path.resolve(workspaceRuleFile) !== path.resolve(globalRuleFile)
+    ) {
+      workflows = await collectInstalledWorkflows(platform, "project", cwd);
+    }
+  }
   const patchResult = await upsertManagedRuleBlock(
     ruleFilePath,
     platform,
@@ -5317,7 +5262,7 @@ async function writeGeneratedArtifact({
 
 function resolveLegacyPostmanConfigPath({ scope, cwd = process.cwd() }) {
   if (scope === "global") {
-    return path.join(os.homedir(), ".cbx", LEGACY_POSTMAN_CONFIG_FILENAME);
+    return path.join(resolveManagedHomeDir(), ".cbx", LEGACY_POSTMAN_CONFIG_FILENAME);
   }
   const workspaceRoot = findWorkspaceRoot(cwd);
   return path.join(workspaceRoot, LEGACY_POSTMAN_CONFIG_FILENAME);
@@ -5325,7 +5270,7 @@ function resolveLegacyPostmanConfigPath({ scope, cwd = process.cwd() }) {
 
 function resolveCbxConfigPath({ scope, cwd = process.cwd() }) {
   if (scope === "global") {
-    return path.join(os.homedir(), ".cbx", CBX_CONFIG_FILENAME);
+    return path.join(resolveManagedHomeDir(), ".cbx", CBX_CONFIG_FILENAME);
   }
   const workspaceRoot = findWorkspaceRoot(cwd);
   return path.join(workspaceRoot, CBX_CONFIG_FILENAME);
@@ -5345,14 +5290,23 @@ async function assertNoLegacyOnlyPostmanConfig({ scope, cwd = process.cwd() }) {
 
 function resolveMcpRootPath({ scope, cwd = process.cwd() }) {
   if (scope === "global") {
-    return path.join(os.homedir(), ".cbx", "mcp");
+    return path.join(resolveManagedHomeDir(), ".cbx", "mcp");
   }
   const workspaceRoot = findWorkspaceRoot(cwd);
   return path.join(workspaceRoot, ".cbx", "mcp");
 }
 
+function resolveManagedHomeDir() {
+  const override = String(
+    process.env.HOME ||
+      process.env.USERPROFILE ||
+      "",
+  ).trim();
+  return override || os.homedir();
+}
+
 function resolveManagedCredentialsEnvPath() {
-  return path.join(os.homedir(), ".cbx", CBX_CREDENTIALS_ENV_FILENAME);
+  return path.join(resolveManagedHomeDir(), ".cbx", CBX_CREDENTIALS_ENV_FILENAME);
 }
 
 function parseShellEnvValue(rawValue) {
@@ -5491,11 +5445,7 @@ function resolveStitchMcpDefinitionPath({
   scope,
   cwd = process.cwd(),
 }) {
-  return path.join(
-    resolveMcpRootPath({ scope, cwd }),
-    platform,
-    "stitch.json",
-  );
+  return path.join(resolveMcpRootPath({ scope, cwd }), platform, "stitch.json");
 }
 
 function buildPostmanAuthHeader({
@@ -7109,7 +7059,11 @@ async function configurePostmanInstallArtifacts({
       })
     : null;
   const credentialEnvVarNames = [];
-  if (persistCredentials && shouldInstallPostman && effectiveApiKeySource === "env") {
+  if (
+    persistCredentials &&
+    shouldInstallPostman &&
+    effectiveApiKeySource === "env"
+  ) {
     credentialEnvVarNames.push(
       effectiveApiKeyEnvVar || POSTMAN_API_KEY_ENV_VAR,
     );
@@ -7583,34 +7537,66 @@ async function installBundleArtifacts({
   }
 
   const shouldInstallPlatformSkills = true;
+  const workflowFiles = Array.isArray(platformSpec.workflows)
+    ? platformSpec.workflows
+    : [];
+  const generatedSkillDirs = Array.isArray(platformSpec.generatedSkills)
+    ? platformSpec.generatedSkills
+    : [];
+  const agentFiles = platformInstallsCustomAgents(platform)
+    ? Array.isArray(platformSpec.agents)
+      ? platformSpec.agents
+      : []
+    : [];
+  const commandFiles = Array.isArray(platformSpec.commands)
+    ? platformSpec.commands
+    : [];
+  const promptFiles = Array.isArray(platformSpec.prompts)
+    ? platformSpec.prompts
+    : [];
+  const hookFiles = Array.isArray(platformSpec.hooks)
+    ? platformSpec.hooks
+        .map((entry) =>
+          typeof entry === "string"
+            ? entry
+            : typeof entry?.file === "string"
+              ? entry.file
+              : null,
+        )
+        .filter(Boolean)
+    : [];
 
   if (!dryRun) {
-    await mkdir(profilePaths.workflowsDir, { recursive: true });
-    if (shouldInstallPlatformSkills) {
+    if (workflowFiles.length > 0) {
+      if (!profilePaths.workflowsDir) {
+        throw new Error(
+          `Platform '${platform}' does not define a workflow install directory.`,
+        );
+      }
+      await mkdir(profilePaths.workflowsDir, { recursive: true });
+    }
+    if (
+      shouldInstallPlatformSkills &&
+      profilePaths.skillsDir &&
+      (generatedSkillDirs.length > 0 || Array.isArray(platformSpec.skills))
+    ) {
       await mkdir(profilePaths.skillsDir, { recursive: true });
     }
-    if (platformInstallsCustomAgents(platform)) {
+    if (agentFiles.length > 0) {
+      if (!profilePaths.agentsDir) {
+        throw new Error(
+          `Platform '${platform}' does not define an agent install directory.`,
+        );
+      }
       await mkdir(profilePaths.agentsDir, { recursive: true });
     }
-    if (
-      profilePaths.commandsDir &&
-      Array.isArray(platformSpec.commands) &&
-      platformSpec.commands.length > 0
-    ) {
+    if (profilePaths.commandsDir && commandFiles.length > 0) {
       await mkdir(profilePaths.commandsDir, { recursive: true });
     }
-    if (
-      profilePaths.promptsDir &&
-      Array.isArray(platformSpec.prompts) &&
-      platformSpec.prompts.length > 0
-    ) {
+    if (profilePaths.promptsDir && promptFiles.length > 0) {
       await mkdir(profilePaths.promptsDir, { recursive: true });
     }
-    if (
-      profilePaths.hooksDir &&
-      Array.isArray(platformSpec.hooks) &&
-      platformSpec.hooks.some((entry) => typeof entry?.file === "string")
-    ) {
+    if (profilePaths.hooksDir && hookFiles.length > 0) {
       await mkdir(profilePaths.hooksDir, { recursive: true });
     }
   }
@@ -7632,10 +7618,8 @@ async function installBundleArtifacts({
   // Bind useSymlinks into copyArtifact so every call site inherits it
   const copyArt = (args) => copyArtifact({ ...args, useSymlinks });
 
-  const workflowFiles = Array.isArray(platformSpec.workflows)
-    ? platformSpec.workflows
-    : [];
   for (const workflowFile of workflowFiles) {
+    if (!profilePaths.workflowsDir) continue;
     const source = path.join(platformRoot, "workflows", workflowFile);
     const destination = path.join(
       profilePaths.workflowsDir,
@@ -7658,12 +7642,8 @@ async function installBundleArtifacts({
     else installed.push(destination);
   }
 
-  const agentFiles = platformInstallsCustomAgents(platform)
-    ? Array.isArray(platformSpec.agents)
-      ? platformSpec.agents
-      : []
-    : [];
   for (const agentFile of agentFiles) {
+    if (!profilePaths.agentsDir) continue;
     const source = path.join(platformRoot, "agents", agentFile);
     const destination = path.join(
       profilePaths.agentsDir,
@@ -7686,9 +7666,6 @@ async function installBundleArtifacts({
     else installed.push(destination);
   }
 
-  const commandFiles = Array.isArray(platformSpec.commands)
-    ? platformSpec.commands
-    : [];
   for (const commandFile of commandFiles) {
     if (!profilePaths.commandsDir) continue;
     const source = path.join(platformRoot, "commands", commandFile);
@@ -7713,9 +7690,6 @@ async function installBundleArtifacts({
     else installed.push(destination);
   }
 
-  const promptFiles = Array.isArray(platformSpec.prompts)
-    ? platformSpec.prompts
-    : [];
   for (const promptFile of promptFiles) {
     if (!profilePaths.promptsDir) continue;
     const source = path.join(platformRoot, "prompts", promptFile);
@@ -7739,17 +7713,6 @@ async function installBundleArtifacts({
       skipped.push(destination);
     else installed.push(destination);
   }
-  const hookFiles = Array.isArray(platformSpec.hooks)
-    ? platformSpec.hooks
-        .map((entry) =>
-          typeof entry === "string"
-            ? entry
-            : typeof entry?.file === "string"
-              ? entry.file
-              : null,
-        )
-        .filter(Boolean)
-    : [];
   for (const hookFile of hookFiles) {
     if (!profilePaths.hooksDir) continue;
     const source = path.join(platformRoot, "hooks", hookFile);
@@ -7773,7 +7736,7 @@ async function installBundleArtifacts({
       skipped.push(destination);
     else installed.push(destination);
   }
-  if (shouldInstallPlatformSkills) {
+  if (shouldInstallPlatformSkills && profilePaths.skillsDir) {
     const agentSkillDependencies = await resolvePlatformAgentSkillDependencies({
       platformRoot,
       platformSpec,
@@ -7830,21 +7793,33 @@ async function installBundleArtifacts({
         skipped.push(skillsIndexDest);
       else installed.push(skillsIndexDest);
     }
-  }
 
-  let generatedWrapperSkills = [];
-  if (platform === "codex") {
-    const wrapperResult = await generateCodexWrapperSkills({
-      platformRoot,
-      platformSpec,
-      skillsDir: profilePaths.skillsDir,
-      overwrite,
-      dryRun,
-    });
-    installed.push(...wrapperResult.installed);
-    skipped.push(...wrapperResult.skipped);
-    artifacts.skills.push(...wrapperResult.artifacts);
-    generatedWrapperSkills = wrapperResult.generated;
+    for (const generatedSkillDir of generatedSkillDirs) {
+      const source = path.join(
+        platformRoot,
+        "generated-skills",
+        generatedSkillDir,
+      );
+      const destination = path.join(
+        profilePaths.skillsDir,
+        path.basename(generatedSkillDir),
+      );
+
+      if (!(await pathExists(source))) {
+        throw new Error(`Missing generated skill source directory: ${source}`);
+      }
+
+      const result = await copyArt({
+        source,
+        destination,
+        overwrite,
+        dryRun,
+      });
+      artifacts.skills.push(destination);
+      if (result.action === "skipped" || result.action === "would-skip")
+        skipped.push(destination);
+      else installed.push(destination);
+    }
   }
 
   let terminalIntegration = null;
@@ -7857,11 +7832,13 @@ async function installBundleArtifacts({
     installed.push(...terminalIntegration.installedPaths);
   }
 
-  const duplicateSkillCleanup = await cleanupNestedDuplicateSkills({
-    skillsRootDir: profilePaths.skillsDir,
-    installedSkillDirs: artifacts.skills,
-    dryRun,
-  });
+  const duplicateSkillCleanup = profilePaths.skillsDir
+    ? await cleanupNestedDuplicateSkills({
+        skillsRootDir: profilePaths.skillsDir,
+        installedSkillDirs: artifacts.skills,
+        dryRun,
+      })
+    : [];
 
   const sanitizedSkills = await sanitizeInstalledSkillsForPlatform({
     platform,
@@ -7880,64 +7857,12 @@ async function installBundleArtifacts({
     skipped,
     artifacts,
     terminalIntegration,
-    generatedWrapperSkills,
     duplicateSkillCleanup,
     sanitizedSkills,
     sanitizedAgents,
   };
 }
 
-async function installCodexProjectWorkflowTemplates({
-  bundleId,
-  manifest,
-  overwrite,
-  dryRun = false,
-  cwd = process.cwd(),
-}) {
-  const platform = "codex";
-  const platformSpec = manifest.platforms?.[platform];
-  if (!platformSpec) return { installed: [], skipped: [] };
-
-  const workflowFiles = Array.isArray(platformSpec.workflows)
-    ? platformSpec.workflows
-    : [];
-  if (workflowFiles.length === 0) return { installed: [], skipped: [] };
-
-  const profilePaths = await resolveProfilePaths(platform, "project", cwd);
-  if (!dryRun) {
-    await mkdir(profilePaths.workflowsDir, { recursive: true });
-  }
-
-  const bundleRoot = path.join(agentAssetsRoot(), "workflows", bundleId);
-  const platformRoot = path.join(bundleRoot, "platforms", platform);
-  const installed = [];
-  const skipped = [];
-
-  for (const workflowFile of workflowFiles) {
-    const source = path.join(platformRoot, "workflows", workflowFile);
-    const destination = path.join(
-      profilePaths.workflowsDir,
-      path.basename(workflowFile),
-    );
-
-    if (!(await pathExists(source))) {
-      throw new Error(`Missing workflow source file: ${source}`);
-    }
-
-    const result = await copyArtifact({
-      source,
-      destination,
-      overwrite,
-      dryRun,
-    });
-    if (result.action === "skipped" || result.action === "would-skip")
-      skipped.push(destination);
-    else installed.push(destination);
-  }
-
-  return { installed, skipped };
-}
-
 async function seedRuleFileFromTemplateIfMissing({
   bundleId,
   manifest,
@@ -7987,6 +7912,7 @@ function commandToFilename(command) {
 }
 
 async function findWorkflowFileByTarget(workflowsDir, target) {
+  if (!workflowsDir) return null;
   const direct = target.endsWith(".md") ? target : `${target}.md`;
   const directPath = path.join(workflowsDir, direct);
   if (await pathExists(directPath)) return directPath;
@@ -8035,8 +7961,12 @@ async function removeBundleArtifacts({
     );
 
   const removed = [];
+  const generatedSkillDirs = Array.isArray(platformSpec.generatedSkills)
+    ? platformSpec.generatedSkills
+    : [];
 
   for (const workflowFile of platformSpec.workflows || []) {
+    if (!profilePaths.workflowsDir) continue;
     const destination = path.join(
       profilePaths.workflowsDir,
       path.basename(workflowFile),
@@ -8045,6 +7975,7 @@ async function removeBundleArtifacts({
   }
 
   for (const agentFile of platformSpec.agents || []) {
+    if (!profilePaths.agentsDir) continue;
     const destination = path.join(
       profilePaths.agentsDir,
       path.basename(agentFile),
@@ -8091,63 +8022,83 @@ async function removeBundleArtifacts({
     extraSkillIds: [],
   });
   for (const skillId of skillIds) {
+    if (!profilePaths.skillsDir) continue;
     const destination = path.join(profilePaths.skillsDir, skillId);
     if (await safeRemove(destination, dryRun)) removed.push(destination);
   }
 
-  if (platform === "codex") {
-    const wrapperSkillIds = buildCodexWrapperSkillIds(platformSpec);
-    for (const skillId of wrapperSkillIds) {
-      const destination = path.join(profilePaths.skillsDir, skillId);
-      if (await safeRemove(destination, dryRun)) removed.push(destination);
-    }
+  for (const generatedSkillDir of generatedSkillDirs) {
+    if (!profilePaths.skillsDir) continue;
+    const destination = path.join(
+      profilePaths.skillsDir,
+      path.basename(generatedSkillDir),
+    );
+    if (await safeRemove(destination, dryRun)) removed.push(destination);
   }
 
   return { removed, profilePaths };
 }
 
 function printPlatforms() {
+  const formatPathList = (paths, disabledLabel = "(not used)") =>
+    Array.isArray(paths) && paths.length > 0 ? paths.join(" | ") : disabledLabel;
   console.log("Workflow platforms:");
   for (const profileId of PLATFORM_IDS) {
     const profile = WORKFLOW_PROFILES[profileId];
     const agentsEnabled = platformInstallsCustomAgents(profileId);
     console.log(`- ${profile.id} (${profile.label})`);
-    console.log(`  project workflows: ${profile.project.workflowDirs[0]}`);
     console.log(
-      `  project agents:    ${agentsEnabled ? profile.project.agentDirs[0] : "(disabled for this platform)"}`,
+      `  project workflows: ${formatPathList(profile.project.workflowDirs)}`,
+    );
+    console.log(
+      `  project agents:    ${agentsEnabled ? formatPathList(profile.project.agentDirs, "(not used)") : "(disabled for this platform)"}`,
+    );
+    console.log(
+      `  project skills:    ${formatPathList(profile.project.skillDirs)}`,
     );
-    console.log(`  project skills:    ${profile.project.skillDirs[0]}`);
     if (
       Array.isArray(profile.project.commandDirs) &&
       profile.project.commandDirs.length > 0
     ) {
-      console.log(`  project commands:  ${profile.project.commandDirs[0]}`);
+      console.log(
+        `  project commands:  ${formatPathList(profile.project.commandDirs)}`,
+      );
     }
     if (
       Array.isArray(profile.project.promptDirs) &&
       profile.project.promptDirs.length > 0
     ) {
-      console.log(`  project prompts:   ${profile.project.promptDirs[0]}`);
+      console.log(
+        `  project prompts:   ${formatPathList(profile.project.promptDirs)}`,
+      );
     }
     console.log(
       `  project rules:     ${profile.project.ruleFilesByPriority.join(" | ")}`,
     );
-    console.log(`  global workflows:  ${profile.global.workflowDirs[0]}`);
     console.log(
-      `  global agents:     ${agentsEnabled ? profile.global.agentDirs[0] : "(disabled for this platform)"}`,
+      `  global workflows:  ${formatPathList(profile.global.workflowDirs)}`,
+    );
+    console.log(
+      `  global agents:     ${agentsEnabled ? formatPathList(profile.global.agentDirs, "(not used)") : "(disabled for this platform)"}`,
+    );
+    console.log(
+      `  global skills:     ${formatPathList(profile.global.skillDirs)}`,
     );
-    console.log(`  global skills:     ${profile.global.skillDirs[0]}`);
     if (
       Array.isArray(profile.global.commandDirs) &&
       profile.global.commandDirs.length > 0
     ) {
-      console.log(`  global commands:   ${profile.global.commandDirs[0]}`);
+      console.log(
+        `  global commands:   ${formatPathList(profile.global.commandDirs)}`,
+      );
     }
     if (
       Array.isArray(profile.global.promptDirs) &&
       profile.global.promptDirs.length > 0
     ) {
-      console.log(`  global prompts:    ${profile.global.promptDirs[0]}`);
+      console.log(
+        `  global prompts:    ${formatPathList(profile.global.promptDirs)}`,
+      );
     }
     console.log(
       `  global rules:      ${profile.global.ruleFilesByPriority.join(" | ")}`,
@@ -8191,7 +8142,6 @@ function printInstallSummary({
   bundleId,
   installed,
   skipped,
-  generatedWrapperSkills = [],
   duplicateSkillCleanup = [],
   sanitizedSkills = [],
   sanitizedAgents = [],
@@ -8228,21 +8178,6 @@ function printInstallSummary({
     console.log("\nNo changes made.");
   }
 
-  if (generatedWrapperSkills.length > 0) {
-    const workflowCount = generatedWrapperSkills.filter(
-      (item) => item.kind === "workflow",
-    ).length;
-    const agentCount = generatedWrapperSkills.filter(
-      (item) => item.kind === "agent",
-    ).length;
-    console.log(
-      `\nCodex callable wrapper skills: ${generatedWrapperSkills.length} (workflow=${workflowCount}, agent=${agentCount})`,
-    );
-    console.log(
-      "These remain compatibility aliases. Prefer direct /workflow and @agent routing in Codex when available.",
-    );
-  }
-
   if (terminalIntegration) {
     console.log("\nAntigravity terminal verification integration:");
     console.log(`- Provider: ${terminalIntegration.provider}`);
@@ -8365,7 +8300,8 @@ function printPostmanSetupSummary({ postmanSetup }) {
       `- .gitignore (${ignoreResult.filePath}): ${ignoreResult.action}`,
     );
   }
-  for (const cleanupResult of postmanSetup.legacyDefinitionCleanupResults || []) {
+  for (const cleanupResult of postmanSetup.legacyDefinitionCleanupResults ||
+    []) {
     console.log(
       `- Legacy direct MCP cleanup (${cleanupResult.path}): ${cleanupResult.action}`,
     );
@@ -8620,14 +8556,19 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
       const lines = gitignore.split(/\r?\n/).map((line) => line.trim());
       const hasAgentIgnore = lines.some(
         (line) =>
-          line === ".agent" || line === ".agent/" || line === "/.agent/",
+          line === ".agent" ||
+          line === ".agent/" ||
+          line === "/.agent/" ||
+          line === ".agents" ||
+          line === ".agents/" ||
+          line === "/.agents/",
       );
       if (hasAgentIgnore) {
         warnings.push(
-          ".agent/ is ignored in .gitignore; this can hide team workflow/rule updates.",
+          ".agents/ or legacy .agent/ is ignored in .gitignore; this can hide team workflow/rule updates.",
         );
         recommendations.push(
-          "Prefer tracking .agent/ in git. For local-only excludes, use '.git/info/exclude' instead of .gitignore.",
+          "Prefer tracking .agents/ in git. For local-only excludes, use '.git/info/exclude' instead of .gitignore.",
         );
       }
     }
@@ -8842,10 +8783,7 @@ function withInstallOptions(command) {
       "--stitch",
       "optional: configure Stitch profiles and gateway-backed Foundry MCP wiring",
     )
-    .option(
-      "--playwright",
-      "optional: include Playwright MCP server wiring",
-    )
+    .option("--playwright", "optional: include Playwright MCP server wiring")
     .option(
       "--postman-api-key <key>",
       "deprecated: inline key mode is disabled. Use env vars + profiles.",
@@ -9141,13 +9079,13 @@ async function cleanupAntigravityTerminalIntegration({
 }) {
   const profilePaths = await resolveArtifactProfilePaths(
     "antigravity",
-    scope,
+    "project",
     cwd,
   );
   const integrationDir = getAntigravityTerminalIntegrationDir(profilePaths);
   const dirRemoved = await safeRemove(integrationDir, dryRun);
 
-  const primaryRuleFile = await resolveRuleFilePath("antigravity", scope, cwd);
+  const primaryRuleFile = await resolveRuleFilePath("antigravity", "project", cwd);
   const primaryRule = primaryRuleFile
     ? await removeTerminalVerificationBlock(primaryRuleFile, dryRun)
     : { action: "missing-rule-file", filePath: null };
@@ -9262,28 +9200,6 @@ async function performWorkflowInstall(
     cwd,
   });
 
-  if (platform === "codex" && scope === "global") {
-    const codexProjectPaths = await resolveProfilePaths(
-      "codex",
-      "project",
-      cwd,
-    );
-    if (
-      path.resolve(artifactProfilePaths.workflowsDir) !==
-      path.resolve(codexProjectPaths.workflowsDir)
-    ) {
-      const codexProjectWorkflows = await installCodexProjectWorkflowTemplates({
-        bundleId,
-        manifest,
-        overwrite: Boolean(options.overwrite),
-        dryRun,
-        cwd,
-      });
-      installResult.installed.push(...codexProjectWorkflows.installed);
-      installResult.skipped.push(...codexProjectWorkflows.skipped);
-    }
-  }
-
   await seedRuleFileFromTemplateIfMissing({
     bundleId,
     manifest,
@@ -9365,7 +9281,6 @@ async function runWorkflowInstall(options) {
       bundleId: result.bundleId,
       installed: result.installResult.installed,
       skipped: result.installResult.skipped,
-      generatedWrapperSkills: result.installResult.generatedWrapperSkills,
       duplicateSkillCleanup: result.installResult.duplicateSkillCleanup,
       sanitizedSkills: result.installResult.sanitizedSkills,
       sanitizedAgents: result.installResult.sanitizedAgents,
@@ -9627,6 +9542,11 @@ async function runWorkflowRemove(target, options) {
         }
       }
     } else {
+      if (!artifactProfilePaths.workflowsDir) {
+        throw new Error(
+          `Platform '${platform}' does not install standalone workflow files. Remove the bundle instead, or remove the native command/prompt/skill artifact directly.`,
+        );
+      }
       const workflowFile = await findWorkflowFileByTarget(
         artifactProfilePaths.workflowsDir,
         target,
@@ -9654,23 +9574,24 @@ async function runWorkflowRemove(target, options) {
       }
     }
 
-    const syncResult = await syncRulesForPlatform({
-      platform,
-      scope: ruleScope,
-      dryRun,
-      cwd,
-    });
-
     if (!dryRun && removedType === "bundle") {
+      const ruleFilePath = await resolveRuleFilePath(platform, ruleScope, cwd);
       await recordBundleRemovalState({
-        scope,
+        scope: ruleScope,
         platform,
         bundleId: target,
-        ruleFilePath: syncResult.filePath,
+        ruleFilePath,
         cwd,
       });
     }
 
+    const syncResult = await syncRulesForPlatform({
+      platform,
+      scope: ruleScope,
+      dryRun,
+      cwd,
+    });
+
     printRemoveSummary({
       platform,
       scope,
@@ -10114,14 +10035,15 @@ async function runWorkflowRemoveAll(options) {
           const promptFiles = (platformSpec.prompts || []).map((entry) =>
             path.basename(entry),
           );
+          const generatedSkillIds = (platformSpec.generatedSkills || []).map(
+            (entry) => path.basename(entry),
+          );
           const skillIds = await resolveInstallSkillIds({
             platformSpec,
             extraSkillIds: [],
           });
-          const wrapperSkillIds =
-            platform === "codex" ? buildCodexWrapperSkillIds(platformSpec) : [];
           const bundleSkillIds = [
-            ...new Set([...skillIds, ...wrapperSkillIds]),
+            ...new Set([...skillIds, ...generatedSkillIds]),
           ];
 
           for (const workflowsDir of alternateWorkflowsDirs) {
@@ -11010,7 +10932,7 @@ async function runWorkflowConfigKeysList(options) {
       cwd,
     });
 
-    console.log(`Config file: ${configPath}`);
+    console.log(`Config file: ${toPosixPath(configPath)}`);
     if (!existing.exists) {
       console.log("Status: missing");
       return;
@@ -11321,15 +11243,16 @@ async function runWorkflowConfigKeysMigrateInline(options) {
     }
     console.log(`Legacy direct MCP cleanup actions: ${cleanupResults.length}`);
     for (const cleanup of cleanupResults) {
-      console.log(`- ${cleanup.action} ${cleanup.path}`);
+      console.log(`- ${cleanup.action} ${toPosixPath(cleanup.path)}`);
     }
     if (secureArtifacts?.mcpRuntimeResult) {
       console.log(
-        `Secure platform MCP target: ${secureArtifacts.mcpRuntimeResult.action} (${secureArtifacts.mcpRuntimeResult.path || "n/a"})`,
+        `Secure platform MCP target: ${secureArtifacts.mcpRuntimeResult.action} (${secureArtifacts.mcpRuntimeResult.path ? toPosixPath(secureArtifacts.mcpRuntimeResult.path) : "n/a"})`,
       );
     }
-    for (const cleanup of secureArtifacts?.legacyDefinitionCleanupResults || []) {
-      console.log(`- ${cleanup.action} ${cleanup.path}`);
+    for (const cleanup of secureArtifacts?.legacyDefinitionCleanupResults ||
+      []) {
+      console.log(`- ${cleanup.action} ${toPosixPath(cleanup.path)}`);
     }
     for (const warning of secureArtifacts?.warnings || []) {
       console.log(`Warning: ${warning}`);
@@ -11356,14 +11279,17 @@ async function runWorkflowConfigKeysDoctor(options) {
       cwd,
     });
 
-    console.log(`Config file: ${configPath}`);
+    console.log(`Config file: ${toPosixPath(configPath)}`);
     if (!existing.exists) {
       console.log("Status: missing");
       return;
     }
 
     const configFindings = collectInlineCredentialFindings(existingValue);
-    const artifactFindings = await collectCredentialLeakFindings({ scope, cwd });
+    const artifactFindings = await collectCredentialLeakFindings({
+      scope,
+      cwd,
+    });
     const migrationPreview = migrateInlineCredentialsInConfig(existingValue);
 
     console.log(`Inline key findings: ${configFindings.length}`);
@@ -11373,7 +11299,7 @@ async function runWorkflowConfigKeysDoctor(options) {
 
     console.log(`Credential leak findings: ${artifactFindings.length}`);
     for (const finding of artifactFindings) {
-      console.log(`- ${finding.filePath} [${finding.matches.join(", ")}]`);
+      console.log(`- ${toPosixPath(finding.filePath)} [${finding.matches.join(", ")}]`);
     }
 
     if (migrationPreview.requiredEnvVars.length > 0) {
@@ -12291,7 +12217,7 @@ async function runMcpServe(options) {
 
 function resolveCbxRootPath({ scope, cwd = process.cwd() }) {
   if (scope === "global") {
-    return path.join(os.homedir(), ".cbx");
+    return path.join(resolveManagedHomeDir(), ".cbx");
   }
   const workspaceRoot = findWorkspaceRoot(cwd);
   return path.join(workspaceRoot, ".cbx");
@@ -12832,11 +12758,9 @@ function printInstallEngineeringSummary({ engineeringResults, techResult }) {
 
 function printInstallDocumentationNotice() {
   console.log("\nProject backbone docs:");
+  console.log("- Install only wires the rule references and workflow assets.");
   console.log(
-    "- Install only wires the rule references and workflow assets.",
-  );
-  console.log(
-    `- Use \`cbx rules init\` to scaffold ENGINEERING_RULES.md and TECH.md, or \`cbx build architecture --platform <codex|claude|gemini|copilot>\` to generate ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, and ADR scaffolds.`,
+    `- Use \`cbx rules init\` to scaffold ENGINEERING_RULES.md and TECH.md, or \`cbx build architecture --platform <antigravity|codex|claude|gemini|copilot>\` to generate ${FOUNDATION_DOCS_DIR}/MEMORY.md, ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, topic memory docs, and ADR scaffolds.`,
   );
 }
 
@@ -12885,6 +12809,7 @@ async function upsertEngineeringArtifacts({
     const blockResult = await upsertEngineeringRulesBlock({
       ruleFilePath: target.ruleFilePath,
       platform,
+      memoryFilePath: path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "MEMORY.md"),
       productFilePath: scaffold.productPath,
       architectureFilePath: scaffold.architectureDocPath,
       engineeringRulesFilePath: scaffold.engineeringRulesPath,
@@ -12895,9 +12820,10 @@ async function upsertEngineeringArtifacts({
     engineeringResults.push({
       ruleFilePath: target.ruleFilePath,
       rulesFilePath: scaffold.engineeringRulesPath,
-      rulesFileResult: scaffold.rulesArchitectureResult.action === "unchanged"
-        ? scaffold.rulesFileResult
-        : scaffold.rulesArchitectureResult,
+      rulesFileResult:
+        scaffold.rulesArchitectureResult.action === "unchanged"
+          ? scaffold.rulesFileResult
+          : scaffold.rulesArchitectureResult,
       blockResult,
     });
   }
@@ -12994,7 +12920,7 @@ function normalizeArchitectureBuildPlatform(value) {
   const normalized = normalizePlatform(value);
   if (!normalized || !ARCHITECTURE_BUILD_PLATFORMS.has(normalized)) {
     throw new Error(
-      "Architecture build platform must be one of: codex, claude, gemini, copilot.",
+      "Architecture build platform must be one of: antigravity, codex, claude, gemini, copilot.",
     );
   }
   return normalized;
@@ -13083,7 +13009,11 @@ async function resolveArchitectureInspectionAnchors(
   return ordered.slice(0, 18);
 }
 
-function resolveArchitectureConditionalSkills(snapshot, specRoots, researchMode) {
+function resolveArchitectureConditionalSkills(
+  snapshot,
+  specRoots,
+  researchMode,
+) {
   const conditional = [];
   const frameworks = new Set(snapshot.frameworks || []);
   const topDirs = new Set(snapshot.topDirs || []);
@@ -13137,7 +13067,9 @@ async function resolveArchitectureSkillPathHints(platform, cwd, skillIds) {
   if (!skillsDir) return [];
   return skillIds
     .map((skillId) => path.join(skillsDir, skillId, "SKILL.md"))
-    .map((filePath) => toPosixPath(path.relative(findWorkspaceRoot(cwd), filePath)));
+    .map((filePath) =>
+      toPosixPath(path.relative(findWorkspaceRoot(cwd), filePath)),
+    );
 }
 
 function buildArchitecturePrompt({
@@ -13151,9 +13083,14 @@ function buildArchitecturePrompt({
   conditionalSkills,
   skillPathHints,
 }) {
+  const memoryPath = `${FOUNDATION_DOCS_DIR}/MEMORY.md`;
   const productPath = `${FOUNDATION_DOCS_DIR}/PRODUCT.md`;
   const architecturePath = `${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md`;
   const techPath = `${FOUNDATION_DOCS_DIR}/TECH.md`;
+  const domainMemoryPath = `${FOUNDATION_MEMORY_DIR}/domain.md`;
+  const runtimeMemoryPath = `${FOUNDATION_MEMORY_DIR}/runtime.md`;
+  const integrationsMemoryPath = `${FOUNDATION_MEMORY_DIR}/integrations.md`;
+  const debuggingMemoryPath = `${FOUNDATION_MEMORY_DIR}/debugging.md`;
   const adrReadmePath = `${FOUNDATION_ADR_DIR}/README.md`;
   const adrTemplatePath = `${FOUNDATION_ADR_DIR}/0000-template.md`;
   const architectureSignals = snapshot.architectureByApp
@@ -13163,13 +13100,28 @@ function buildArchitecturePrompt({
       return `${label}: ${item.architectureSignals.join(", ")}`;
     });
 
+  const platformCapabilities = {
+    antigravity:
+      "You are generating repo-shared foundation docs for Antigravity. Use the Gemini-family CLI surface available in this environment and optimize the docs for `.agents/rules/GEMINI.md` plus command-driven workflows.",
+    codex:
+      "You can read, write, and execute shell commands. Use `codex exec` mode.",
+    claude:
+      "You can read, write files, and run bash commands. Use non-interactive mode.",
+    gemini:
+      "You can read, write files, and run commands within your sandbox. Follow Gemini CLI conventions.",
+    copilot:
+      "You can read, write files, and use terminal commands. Follow Copilot agent conventions.",
+  };
+
   return [
     `You are running inside ${platform}.`,
+    platformCapabilities[platform] || "",
     "",
     "Objective:",
-    `- Inspect the repository at ${toPosixPath(workspaceRoot)} and author or refresh the core foundation docs in ${productPath}, ${architecturePath}, ${techPath}, ${adrReadmePath}, and ${adrTemplatePath}.`,
+    `- Inspect the repository at ${toPosixPath(workspaceRoot)} and author or refresh the core foundation docs in ${memoryPath}, ${productPath}, ${architecturePath}, ${techPath}, ${domainMemoryPath}, ${runtimeMemoryPath}, ${integrationsMemoryPath}, ${debuggingMemoryPath}, ${adrReadmePath}, and ${adrTemplatePath}.`,
     "- The content should be primarily AI-authored from repository inspection, not copied from placeholder scaffolding.",
     "- Preserve manual content outside the managed `cbx:*` markers.",
+    "- The output docs must be immediately useful to any AI agent (Copilot, Claude, Gemini, Codex) inspecting this repo for the first time, reducing search and exploration time.",
     "",
     "Required skill bundle:",
     `- Load these exact skill IDs first: ${coreSkills.map((skillId) => `\`${skillId}\``).join(", ")}`,
@@ -13189,45 +13141,297 @@ function buildArchitecturePrompt({
       ? `- Architecture signals: ${architectureSignals.join(" | ")}`
       : "- Architecture signals: none confidently inferred from the repo scan",
     `- Entry points: ${snapshot.entryPoints.length > 0 ? snapshot.entryPoints.slice(0, 8).join(" | ") : "none detected"}`,
-    `- Key scripts: ${snapshot.keyScripts.length > 0 ? snapshot.keyScripts.slice(0, 8).map((item) => `${item.name}=${item.command}`).join(" | ") : "none detected"}`,
+    `- Key scripts: ${
+      snapshot.keyScripts.length > 0
+        ? snapshot.keyScripts
+            .slice(0, 8)
+            .map((item) => `${item.name}=${item.command}`)
+            .join(" | ")
+        : "none detected"
+    }`,
     `- Inspection anchors: ${inspectionAnchors.length > 0 ? inspectionAnchors.join(", ") : "no concrete anchors detected; inspect the repo root, main source trees, and manifest files manually"}`,
     "",
+    "Foundation doc usage contract:",
+    `- ${memoryPath} is the durable AI entrypoint and first-stop index. Keep it concise, keep it under roughly 120 lines when possible, and route readers to deeper docs instead of duplicating every deep detail.`,
+    `- ${productPath} is for planning, scoping, specs, product intent, business rules, and domain vocabulary.`,
+    `- ${architecturePath} is for structure, boundaries, dependency rules, ADR-worthy decisions, refactors, and design-system governance.`,
+    `- ${techPath} is for build, test, run, debug, CI/CD, tooling, runtime operations, and exact commands.`,
+    `- ${domainMemoryPath}, ${runtimeMemoryPath}, ${integrationsMemoryPath}, and ${debuggingMemoryPath} are load-on-demand drill-down docs for their named topics.`,
+    `- ${adrReadmePath} and ${adrTemplatePath} exist for durable architecture decisions; they are not a replacement for the backbone docs.`,
+    "- `.cbx/architecture-build.json` is build metadata for automation and drift checks, not a primary context document for agents.",
+    "- These docs are downstream inputs to `ENGINEERING_RULES.md` and platform rule files such as `AGENTS.md`, `CLAUDE.md`, `.agents/rules/GEMINI.md`, `.gemini/GEMINI.md`, and `.github/copilot-instructions.md`.",
+    "- Each doc should make it easy for future rules, workflows, agents, and skills to decide whether they need to open it.",
+    "",
+    "Markdown formatting rules (apply to all generated docs):",
+    "- Start each file with a single `# Title` heading. Never use more than one H1 per file.",
+    "- Use `## Heading` for major sections, `### Heading` for subsections. Never skip heading levels (e.g., do not jump from `##` to `####`).",
+    "- Separate headings from surrounding content with exactly one blank line above and below.",
+    "- Use fenced code blocks with triple backticks and a language identifier (```bash, ```typescript, ```json, ```yaml, ```mermaid) for all code, commands, and diagrams. Never use indented code blocks.",
+    "- Use `-` for unordered lists. Use `1.` for ordered lists. Indent nested lists by 2 spaces.",
+    "- Use `inline code` backticks for file paths, command names, env vars, config keys, and identifiers.",
+    "- Use Mermaid fenced blocks (```mermaid) for diagrams. Validate that diagram syntax is correct: `graph TD`, `sequenceDiagram`, `flowchart LR`, or `C4Context` style. Every node and edge must be syntactically valid.",
+    "- Tables must have a header row, a separator row with dashes and pipes, and aligned columns. Example:",
+    "  ```",
+    "  | Column A | Column B |",
+    "  | -------- | -------- |",
+    "  | value    | value    |",
+    "  ```",
+    "- Use `> blockquote` only for callouts or important notes, prefixed with **Note:** or **Warning:**.",
+    "- Relative links to other repo files should use repo-relative paths: `[ARCHITECTURE.md](docs/foundation/ARCHITECTURE.md)`.",
+    "- End every file with a single trailing newline. No trailing whitespace on lines.",
+    "",
     "Execution contract:",
     "1. Inspect the repository first before writing any backbone doc content. Derive structure, product surfaces, runtime boundaries, and technical constraints from the actual codebase.",
     "2. Complete a real inspection pass before drafting. At minimum, inspect the concrete anchors listed above, plus any adjacent directories needed to understand the main execution paths, data boundaries, and integration surfaces.",
     "3. Do not infer architecture from filenames alone when you can open representative files. Read enough source to validate the main app boundaries, runtime flows, and persistence/integration patterns.",
-    `4. Then read ${productPath}, ${architecturePath}, and ${techPath} in that order when they exist so you can preserve useful manual context and update existing managed sections cleanly.`,
-    `5. Replace or update only the content between the existing managed markers in ${productPath}, ${architecturePath}, and ${techPath}. Do not append a second marker block.`,
-    `6. In ${productPath}, write a concrete product foundation: product purpose, primary users/operators, main journeys, business capabilities, operational constraints, and what future contributors must preserve.`,
-    `7. In ${architecturePath}, write a lean but detailed architecture backbone in a pragmatic arc42/C4 style: system purpose and constraints, explicit architecture classification, bounded contexts, major building blocks, dependency rules, data and integration boundaries, runtime flows, deployment/operability notes, testing/debugging strategy, and only the diagram levels that add real value.`,
-    `8. ${architecturePath} must include a dedicated folder-structure guide that lists the important apps/packages/directories, what each owns, and how contributors should treat those boundaries when editing code.`,
-    `9. In ${techPath}, write the developer-facing technical map: stack, repo layout, key commands, entrypoints, data stores, external services, environment/config surfaces, MCP/tooling footprint, and change hotspots future agents should inspect before editing code.`,
-    `10. ${techPath} should complement ${architecturePath}; do not repeat the same structure prose unless it helps a developer act faster.`,
-    `11. Use exact required headings in ${productPath}: \`## Product Scope\`, \`## Product Purpose\`, \`## Primary Users And Operators\`, \`## Main Journeys\`, \`## Business Capabilities That Matter\`, \`## Operational Constraints\`, \`## Preservation Rules For Future Contributors\`.`,
-    `12. Use exact required headings in ${architecturePath}: \`## Architecture Type\`, \`## System Purpose\`, \`## Constraints And Architectural Drivers\`, \`## Repository Structure Guide\`, \`## Bounded Contexts\`, \`## Major Building Blocks\`, \`## Dependency Rules\`, \`## Data Boundaries\`, \`## Integration Boundaries\`, \`## Runtime Flows\`, \`## Deployment And Operability\`, \`## Testing And Debugging Strategy\`, \`## Architectural Guidance\`.`,
-    `13. Use exact required headings in ${techPath}: \`## Stack Snapshot\`, \`## Repository Layout\`, \`## Entrypoints\`, \`## Key Commands\`, \`## Runtime Data Stores\`, \`## External Services And Integration Surfaces\`, \`## Environment And Config Surfaces\`, \`## Generated Artifacts To Respect\`, \`## Change Hotspots\`, \`## Practical Editing Notes\`.`,
-    "14. Every major claim should be grounded in repository evidence. Mention concrete repo paths in the docs when a structural claim would otherwise be ambiguous.",
-    "15. Avoid placeholder filler, generic checklists, and duplicated content across files. Each doc should have a clear job.",
-    "16. Do not create ROADMAP.md, ENGINEERING_RULES.md, or other extra docs unless the prompt explicitly asks for them.",
+    `4. Then read ${memoryPath}, ${productPath}, ${architecturePath}, ${techPath}, ${domainMemoryPath}, ${runtimeMemoryPath}, ${integrationsMemoryPath}, and ${debuggingMemoryPath} in that order when they exist so you can preserve useful manual context and update existing managed sections cleanly.`,
+    `5. Replace or update only the content between the existing managed markers in ${memoryPath}, ${productPath}, ${architecturePath}, ${techPath}, ${domainMemoryPath}, ${runtimeMemoryPath}, ${integrationsMemoryPath}, and ${debuggingMemoryPath}. Do not append a second marker block.`,
+    "",
+    `6. In ${memoryPath}, write the durable AI memory index:`,
+    "   - A terse project summary that a fresh agent can absorb in under a minute.",
+    "   - A task-based map telling rules, workflows, agents, and skills when to load PRODUCT, ARCHITECTURE, TECH, each topic memory doc, and ADRs.",
+    "   - Durable facts and invariants that are expensive to rediscover.",
+    "   - Active watchpoints: areas likely to break, drift, or require re-validation after changes.",
+    "   - Keep MEMORY.md as an index, not a dump: no long command catalogs, no repeated architecture prose, no copied API contracts, and no verbose troubleshooting playbooks when those belong in deeper docs.",
+    "   - If a section needs more than a short paragraph or 5-7 bullets, move the detail into PRODUCT, ARCHITECTURE, TECH, a topic memory doc, or an ADR and link to it from MEMORY.md.",
+    "",
+    `7. In ${productPath}, write a concrete product foundation:`,
+    "   - Product purpose with a one-sentence elevator pitch an AI agent can use as context.",
+    "   - A short consumer note explaining that PRODUCT is the doc for planning, scoping, specs, UX, and domain-language questions.",
+    "   - Primary users/operators with their key goals.",
+    "   - Main journeys as numbered sequences an agent can follow to understand the happy path.",
+    "   - Business capabilities that matter, linked to repo paths that implement them.",
+    "   - Operational constraints and SLA/uptime expectations if evident.",
+    "   - What future contributors must preserve (invariants, contracts, compatibility guarantees).",
+    "   - A domain glossary defining project-specific terms, abbreviations, and bounded-context language so AI agents use consistent vocabulary.",
+    "",
+    `8. In ${architecturePath}, write a lean but detailed architecture backbone in a pragmatic arc42/C4 style:`,
+    "   - Architecture classification (monolith, modular monolith, microservices, serverless, hybrid) with evidence.",
+    "   - A short consumer note explaining that ARCHITECTURE is the doc for refactors, boundary decisions, ADR work, and design-system governance.",
+    "   - System purpose, constraints, and architectural drivers.",
+    "   - Bounded contexts with ownership boundaries mapped to directories.",
+    "   - Major building blocks as a table or Mermaid C4 diagram with responsibilities.",
+    "   - Dependency rules: what can import what, forbidden coupling, and layering policy.",
+    "   - Data and integration boundaries with protocol/format details.",
+    "   - Runtime flows as Mermaid sequence diagrams for the top 2-3 critical paths.",
+    "   - Crosscutting concerns: logging, auth, error handling, i18n patterns with repo-path evidence.",
+    "   - Quality requirements derived from the codebase (performance budgets, test coverage, accessibility).",
+    "   - Known risks and tech debt visible in the codebase (TODOs, deprecated deps, missing tests).",
+    "   - Deployment/operability notes.",
+    "   - Testing/debugging strategy with concrete test commands and coverage tooling.",
+    "   - A dedicated folder-structure guide listing every important directory, what it owns, and contributor rules.",
+    "",
+    `9. In ${techPath}, write the developer-facing technical map that an AI agent can use to start working immediately:`,
+    "   - Stack snapshot as a table (runtime, language, framework, version if discoverable).",
+    "   - A short consumer note explaining that TECH is the doc for build, run, test, debug, CI/CD, and tooling execution.",
+    "   - Repository layout: directory tree with one-line purpose per directory.",
+    "   - Entrypoints: the exact files that bootstrap each app/service/CLI.",
+    "   - Key commands: the exact shell commands for bootstrap, build, test, lint, format, run, and deploy. Validate that these commands actually exist in the project manifests. Document required order and preconditions.",
+    "   - Build and validation: the validated sequence of commands to go from clean clone to passing CI locally, including environment prerequisites (Node version, Python version, Docker, etc.).",
+    "   - CI/CD pipeline: describe the CI/CD workflow files, their triggers, and what checks must pass before merge.",
+    "   - Runtime data stores and migration commands.",
+    "   - External services and integration surfaces with protocol details.",
+    "   - Environment and config surfaces: list every env var the app reads, its purpose, default value if any, and whether it is required or optional.",
+    "   - MCP/tooling footprint if present.",
+    "   - Generated artifacts: files that are auto-generated and must not be hand-edited.",
+    "   - Error patterns and debugging: common error messages, their causes, and resolution steps discovered during inspection.",
+    "   - Change hotspots: files/directories that change most often or have the most coupling, so agents know where to look first.",
+    "   - Practical editing notes: conventions for naming, imports, test file placement, and PR hygiene.",
+    "",
+    `10. In ${domainMemoryPath}, write the domain memory topic doc:`,
+    "   - Core entities, bounded contexts, business terminology, and invariants.",
+    "   - A short consumer note explaining that this topic doc is for domain modeling and product-language alignment.",
+    "   - Which files or modules embody each important concept.",
+    "   - Ambiguous terminology or overloaded names that agents should avoid misusing.",
+    "",
+    `11. In ${runtimeMemoryPath}, write the runtime memory topic doc:`,
+    "   - Runtime topology, entrypoints, queues/jobs, background workers, schedules, and deployment-time assumptions.",
+    "   - A short consumer note explaining that this topic doc is for request flow, process lifecycle, workers, and deployment reasoning.",
+    "   - The shortest path to understand request flow and process lifecycle.",
+    "",
+    `12. In ${integrationsMemoryPath}, write the integrations memory topic doc:`,
+    "   - External services, APIs, auth boundaries, data contracts, webhook/event flows, and migration-sensitive integration notes.",
+    "   - A short consumer note explaining that this topic doc is for external-service, API, auth-boundary, and contract-sensitive work.",
+    "",
+    `13. In ${debuggingMemoryPath}, write the debugging memory topic doc:`,
+    "   - Common failures, hot logs, exact investigation commands, smoke checks, and repo-specific diagnostic shortcuts.",
+    "   - A short consumer note explaining that this topic doc is for triage, incident response, and debugging workflows.",
+    "",
+    "Consumer guidance contract:",
+    "- Near the top of each foundation doc, include a short 'when to consult this doc' cue so future rules, workflows, agents, and skills can decide quickly whether they need that document.",
+    "- In MEMORY.md, name the likely downstream consumers of each deeper doc using concrete route families such as planning/spec, architecture/refactor, build/test/debug, runtime/integration, and ADR work.",
+    "- Keep MEMORY.md lean enough to be imported frequently. Prefer short bullets, compact tables only when necessary, and links outward instead of repeated explanations.",
+    "",
+    `14. ${techPath} should complement ${architecturePath}; do not repeat the same structure prose unless it helps a developer act faster.`,
+    "",
+    `15. Use exact required headings in ${memoryPath}: \`## Project Summary\`, \`## Load These Docs By Task\`, \`## Durable Facts\`, \`## Active Watchpoints\`.`,
+    `16. Use exact required headings in ${productPath}: \`## Product Scope\`, \`## Product Purpose\`, \`## Primary Users And Operators\`, \`## Main Journeys\`, \`## Business Capabilities That Matter\`, \`## Operational Constraints\`, \`## Preservation Rules For Future Contributors\`, \`## Domain Glossary\`.`,
+    `17. Use exact required headings in ${architecturePath}: \`## Architecture Type\`, \`## System Purpose\`, \`## Constraints And Architectural Drivers\`, \`## Repository Structure Guide\`, \`## Bounded Contexts\`, \`## Major Building Blocks\`, \`## Dependency Rules\`, \`## Data Boundaries\`, \`## Integration Boundaries\`, \`## Runtime Flows\`, \`## Crosscutting Concerns\`, \`## Quality Requirements\`, \`## Risks And Tech Debt\`, \`## Deployment And Operability\`, \`## Testing And Debugging Strategy\`, \`## Architectural Guidance\`.`,
+    `18. Use exact required headings in ${techPath}: \`## Stack Snapshot\`, \`## Repository Layout\`, \`## Entrypoints\`, \`## Key Commands\`, \`## Build And Validation\`, \`## CI CD Pipeline\`, \`## Runtime Data Stores\`, \`## External Services And Integration Surfaces\`, \`## Environment And Config Surfaces\`, \`## Generated Artifacts To Respect\`, \`## Error Patterns And Debugging\`, \`## Change Hotspots\`, \`## Practical Editing Notes\`.`,
+    `19. Use exact required headings in ${domainMemoryPath}: \`## Core Concepts\`, \`## Bounded Context Vocabulary\`, \`## Invariants To Preserve\`, \`## File Ownership Map\`.`,
+    `20. Use exact required headings in ${runtimeMemoryPath}: \`## Runtime Topology\`, \`## Entrypoint Paths\`, \`## Background Work\`, \`## Deployment Assumptions\`.`,
+    `21. Use exact required headings in ${integrationsMemoryPath}: \`## External Services\`, \`## Contracts And Schemas\`, \`## Auth And Trust Boundaries\`, \`## Change Risks\`.`,
+    `22. Use exact required headings in ${debuggingMemoryPath}: \`## Fast Triage Paths\`, \`## Logs And Signals\`, \`## Known Failure Modes\`, \`## Verification Shortcuts\`.`,
+    "",
+    "23. Every major claim should be grounded in repository evidence. Mention concrete repo paths in the docs when a structural claim would otherwise be ambiguous.",
+    "24. Avoid placeholder filler, generic checklists, and duplicated content across files. Each doc should have a clear job.",
+    "25. Do not create ROADMAP.md, ENGINEERING_RULES.md, or other extra docs unless the prompt explicitly asks for them.",
     researchMode === "never"
-      ? "17. Stay repo-only. Do not use outside research."
-      : "17. Use repo evidence first. Use official docs when needed. Treat Reddit or community sources only as labeled secondary evidence.",
+      ? "26. Stay repo-only. Do not use outside research."
+      : "26. Use repo evidence first. Use official docs when needed. Treat Reddit or community sources only as labeled secondary evidence.",
     researchMode === "always"
-      ? `18. Include an external research evidence subsection in ${techPath} with clearly labeled primary and secondary evidence.`
-      : "18. Include external research notes only if they materially informed the architecture update.",
-    `19. If the project clearly follows Clean Architecture, feature-first modules, DDD, modular monolith, or another stable structure, make that explicit in ${architecturePath} with evidence from the repo.`,
-    `20. Ensure ${adrReadmePath} and ${adrTemplatePath} exist as ADR entrypoints, but keep them lean.`,
+      ? `27. Include an external research evidence subsection in ${techPath} with clearly labeled primary and secondary evidence.`
+      : "27. Include external research notes only if they materially informed the architecture update.",
+    `28. If the project clearly follows Clean Architecture, feature-first modules, DDD, modular monolith, or another stable structure, make that explicit in ${architecturePath} with evidence from the repo.`,
+    `29. Ensure ${adrReadmePath} and ${adrTemplatePath} exist as ADR entrypoints, but keep them lean.`,
+    "30. In all docs, when referencing other foundation docs, use relative markdown links: `[ARCHITECTURE.md](docs/foundation/ARCHITECTURE.md)`. This lets AI agents and humans navigate between docs.",
+    "31. Validate all Mermaid diagram syntax before writing. Each diagram must render without errors. Use simple node IDs (alphanumeric, no special characters) and quote labels containing spaces.",
+    "32. For each key command documented, note the expected exit code (0 for success) and any common failure modes. This helps AI agents validate their own changes.",
+    "",
+    "Platform context-loading awareness (these docs will be @imported into agent rule files):",
+    "- Claude loads CLAUDE.md at session start via @file imports; each imported doc should be concise and self-contained.",
+    "- Gemini loads GEMINI.md hierarchically with JIT context; structure docs with clear H2 headings so sections are independently useful.",
+    "- Antigravity benefits from the same hierarchical structure because `.agents/rules/GEMINI.md` should point to a small durable memory index, not dump every deep reference by default.",
+    "- Codex concatenates AGENTS.md files root-to-CWD with a default 32 KiB combined limit; keep total foundation doc prose lean.",
+    "- Copilot loads copilot-instructions.md automatically; headings and inline code markers aid discoverability.",
+    "- `ENGINEERING_RULES.md` and platform rule files should treat MEMORY.md as the first-stop shared memory index and load deeper docs only on demand.",
+    "- Target each individual foundation doc under 300 lines so it stays effective when imported into any platform's context window.",
+    "- Treat MEMORY.md as the tightest budget document in the set. It should remain substantially shorter than PRODUCT.md, ARCHITECTURE.md, or TECH.md.",
+    "- Front-load the most actionable information (commands, paths, constraints) in each doc; put supplementary detail later.",
     "",
     "Return one JSON object on the last line with this shape:",
-    `{"files_written":["${productPath}","${architecturePath}","${techPath}","${adrReadmePath}","${adrTemplatePath}"],"research_used":false,"gaps":[],"next_actions":[]}`,
+    `{"files_written":["${memoryPath}","${productPath}","${architecturePath}","${techPath}","${domainMemoryPath}","${runtimeMemoryPath}","${integrationsMemoryPath}","${debuggingMemoryPath}","${adrReadmePath}","${adrTemplatePath}"],"research_used":false,"gaps":[],"next_actions":[]}`,
     "",
     "Do not emit placeholder TODOs in the managed sections.",
   ].join("\n");
 }
 
+let architectureExecFileCaptureOverride = null;
+let architectureSpawnCaptureOverride = null;
+const WINDOWS_COMMAND_EXTENSION_PREFERENCE = [
+  ".exe",
+  ".cmd",
+  ".bat",
+  ".com",
+  "",
+];
+
+export function __setArchitectureCommandCaptureForTests(overrides = {}) {
+  architectureExecFileCaptureOverride =
+    overrides.execFileCapture || architectureExecFileCaptureOverride;
+  architectureSpawnCaptureOverride =
+    overrides.spawnCapture || architectureSpawnCaptureOverride;
+}
+
+export function __resetArchitectureCommandCaptureForTests() {
+  architectureExecFileCaptureOverride = null;
+  architectureSpawnCaptureOverride = null;
+}
+
+function getEnvValueCaseInsensitive(env, key) {
+  if (!env) return "";
+  const match = Object.keys(env).find(
+    (candidate) => candidate.toLowerCase() === key.toLowerCase(),
+  );
+  return match ? String(env[match] || "") : "";
+}
+
+function rankWindowsCommandCandidate(command, candidate) {
+  const requestedBase = path.parse(command).name.toLowerCase();
+  const parsedCandidate = path.parse(candidate);
+  if (parsedCandidate.name.toLowerCase() !== requestedBase) return -1;
+  const ext = parsedCandidate.ext.toLowerCase();
+  const rank = WINDOWS_COMMAND_EXTENSION_PREFERENCE.indexOf(ext);
+  if (rank !== -1) {
+    return WINDOWS_COMMAND_EXTENSION_PREFERENCE.length - rank;
+  }
+  return 0;
+}
+
+function pickWindowsCommandCandidate(command, candidates) {
+  const normalized = (candidates || [])
+    .map((candidate) => String(candidate || "").trim())
+    .filter(Boolean);
+  if (normalized.length === 0) return null;
+
+  const ranked = normalized
+    .map((candidate) => ({
+      candidate,
+      score: rankWindowsCommandCandidate(command, candidate),
+    }))
+    .sort((left, right) => right.score - left.score);
+
+  return ranked[0]?.candidate || normalized[0];
+}
+
+function scanWindowsPathForCommand(command, env = process.env) {
+  const pathValue = getEnvValueCaseInsensitive(env, "PATH");
+  if (!pathValue) return null;
+
+  const pathEntries = pathValue
+    .split(path.delimiter)
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+  const requestedExt = path.extname(command).toLowerCase();
+  const pathExts = getEnvValueCaseInsensitive(env, "PATHEXT")
+    .split(";")
+    .map((ext) => ext.trim().toLowerCase())
+    .filter(Boolean)
+    .map((ext) => (ext.startsWith(".") ? ext : `.${ext}`));
+  const suffixes = requestedExt
+    ? [""]
+    : Array.from(
+        new Set([
+          ...WINDOWS_COMMAND_EXTENSION_PREFERENCE,
+          ...pathExts,
+        ]),
+      );
+  const candidates = [];
+
+  for (const entry of pathEntries) {
+    const basePath = path.join(entry, command);
+    if (requestedExt && existsSync(basePath)) {
+      candidates.push(basePath);
+      continue;
+    }
+    for (const suffix of suffixes) {
+      const candidate = suffix ? `${basePath}${suffix}` : basePath;
+      if (existsSync(candidate)) {
+        candidates.push(candidate);
+      }
+    }
+  }
+
+  return pickWindowsCommandCandidate(command, candidates);
+}
+
+export function __pickWindowsCommandCandidateForTests(command, candidates) {
+  return pickWindowsCommandCandidate(command, candidates);
+}
+
+export function __scanWindowsPathForCommandForTests(command, env) {
+  return scanWindowsPathForCommand(command, env);
+}
+
 async function execFileCapture(command, args, options = {}) {
+  if (architectureExecFileCaptureOverride) {
+    return await architectureExecFileCaptureOverride(command, args, options);
+  }
+  const resolvedCommand =
+    process.platform === "win32"
+      ? await resolveWindowsCommand(command, options.env)
+      : command;
+  if (
+    process.platform === "win32" &&
+    /\.(cmd|bat)$/i.test(resolvedCommand)
+  ) {
+    return await spawnCapture(resolvedCommand, args, {
+      ...options,
+      useShell: true,
+    });
+  }
   try {
-    const result = await execFile(command, args, {
+    const result = await execFile(resolvedCommand, args, {
       ...options,
       maxBuffer: 8 * 1024 * 1024,
     });
@@ -13238,7 +13442,9 @@ async function execFileCapture(command, args, options = {}) {
     };
   } catch (error) {
     if (error?.code === "ENOENT") {
-      throw new Error(`Required CLI '${command}' is not installed or not on PATH.`);
+      throw new Error(
+        `Required CLI '${command}' is not installed or not on PATH.`,
+      );
     }
     return {
       ok: false,
@@ -13249,14 +13455,56 @@ async function execFileCapture(command, args, options = {}) {
   }
 }
 
+async function resolveWindowsCommand(command, env = process.env) {
+  if (process.platform !== "win32") return command;
+  if (path.isAbsolute(command) || /[\\/]/.test(command)) return command;
+  const pathCandidate = scanWindowsPathForCommand(command, env);
+  try {
+    const result = await execFile("where.exe", [command], {
+      windowsHide: true,
+      maxBuffer: 1024 * 1024,
+    });
+    const candidates = String(result.stdout || "")
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean);
+    const resolved = pickWindowsCommandCandidate(command, candidates);
+    if (resolved) return resolved;
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      if (pathCandidate) return pathCandidate;
+      throw new Error(`Required CLI '${command}' is not installed or not on PATH.`);
+    }
+    if (pathCandidate) return pathCandidate;
+  }
+  if (pathCandidate) return pathCandidate;
+  const missingError = new Error(
+    `Required CLI '${command}' is not installed or not on PATH.`,
+  );
+  missingError.code = "ENOENT";
+  throw missingError;
+}
+
 async function spawnCapture(command, args, options = {}) {
-  const { cwd, env, streamOutput = false } = options;
+  if (architectureSpawnCaptureOverride) {
+    return await architectureSpawnCaptureOverride(command, args, options);
+  }
+  const { cwd, env, streamOutput = false, useShell } = options;
+  const resolvedCommand =
+    process.platform === "win32"
+      ? await resolveWindowsCommand(command, env)
+      : command;
+  const shell =
+    typeof useShell === "boolean"
+      ? useShell
+      : process.platform === "win32" && /\.(cmd|bat)$/i.test(resolvedCommand);
   return await new Promise((resolve, reject) => {
     let stdout = "";
     let stderr = "";
-    const child = spawn(command, args, {
+    const child = spawn(resolvedCommand, args, {
       cwd,
       env,
+      shell,
       stdio: ["ignore", "pipe", "pipe"],
     });
 
@@ -13275,7 +13523,9 @@ async function spawnCapture(command, args, options = {}) {
     child.on("error", (error) => {
       if (error?.code === "ENOENT") {
         reject(
-          new Error(`Required CLI '${command}' is not installed or not on PATH.`),
+          new Error(
+            `Required CLI '${command}' is not installed or not on PATH.`,
+          ),
         );
         return;
       }
@@ -13299,7 +13549,7 @@ function explainArchitectureBuildFailure(platform, execution) {
   );
   const notes = [];
 
-  if (platform === "gemini") {
+  if (platform === "gemini" || platform === "antigravity") {
     if (
       combined.includes("Error during discovery for MCP server") ||
       combined.includes("[MCP error]")
@@ -13379,7 +13629,7 @@ async function probeArchitectureAdapter(platform, cwd) {
     };
   }
 
-  if (platform === "gemini") {
+  if (platform === "gemini" || platform === "antigravity") {
     const help = await execFileCapture("gemini", ["--help"], { cwd });
     const helpText = `${help.stdout}\n${help.stderr}`.trim();
     const promptFlag = helpText.includes("--prompt")
@@ -13543,6 +13793,11 @@ async function collapseDuplicateTaggedBlocks({
 }
 
 async function normalizeArchitectureBuildOutputs(scaffold) {
+  await collapseDuplicateTaggedBlocks({
+    targetPath: scaffold.memoryPath,
+    startPattern: MEMORY_FOUNDATION_BLOCK_START_RE,
+    endPattern: MEMORY_FOUNDATION_BLOCK_END_RE,
+  });
   await collapseDuplicateTaggedBlocks({
     targetPath: scaffold.productPath,
     startPattern: PRODUCT_FOUNDATION_BLOCK_START_RE,
@@ -13558,28 +13813,76 @@ async function normalizeArchitectureBuildOutputs(scaffold) {
     startPattern: TECH_ARCHITECTURE_BLOCK_START_RE,
     endPattern: TECH_ARCHITECTURE_BLOCK_END_RE,
   });
+  for (const targetPath of [
+    scaffold.domainMemoryPath,
+    scaffold.runtimeMemoryPath,
+    scaffold.integrationsMemoryPath,
+    scaffold.debuggingMemoryPath,
+  ]) {
+    await collapseDuplicateTaggedBlocks({
+      targetPath,
+      startPattern: MEMORY_TOPIC_BLOCK_START_RE,
+      endPattern: MEMORY_TOPIC_BLOCK_END_RE,
+    });
+  }
 }
 
 async function readArchitectureDriftStatus(workspaceRoot, snapshot) {
-  const productPath = path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "PRODUCT.md");
+  const memoryPath = path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "MEMORY.md");
+  const productPath = path.join(
+    workspaceRoot,
+    FOUNDATION_DOCS_DIR,
+    "PRODUCT.md",
+  );
   const architecturePath = path.join(
     workspaceRoot,
     FOUNDATION_DOCS_DIR,
     "ARCHITECTURE.md",
   );
   const techPath = path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "TECH.md");
-  const adrReadmePath = path.join(workspaceRoot, FOUNDATION_ADR_DIR, "README.md");
+  const domainMemoryPath = path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "domain.md");
+  const runtimeMemoryPath = path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "runtime.md");
+  const integrationsMemoryPath = path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "integrations.md");
+  const debuggingMemoryPath = path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "debugging.md");
+  const adrReadmePath = path.join(
+    workspaceRoot,
+    FOUNDATION_ADR_DIR,
+    "README.md",
+  );
   const metadataPath = path.join(
     workspaceRoot,
     ".cbx",
     ARCHITECTURE_BUILD_METADATA_FILENAME,
   );
+  const memoryExists = await pathExists(memoryPath);
   const productExists = await pathExists(productPath);
   const architectureExists = await pathExists(architecturePath);
   const techExists = await pathExists(techPath);
+  const topicPaths = [
+    domainMemoryPath,
+    runtimeMemoryPath,
+    integrationsMemoryPath,
+    debuggingMemoryPath,
+  ];
   const adrReadmeExists = await pathExists(adrReadmePath);
 
   const findings = [];
+  if (!memoryExists) {
+    findings.push(`${FOUNDATION_DOCS_DIR}/MEMORY.md is missing.`);
+  } else {
+    const content = await readFile(memoryPath, "utf8");
+    if (
+      !extractTaggedMarkerAttribute(
+        content,
+        MEMORY_FOUNDATION_BLOCK_START_RE,
+        "profile",
+      )
+    ) {
+      findings.push(
+        `${FOUNDATION_DOCS_DIR}/MEMORY.md is missing the managed memory block.`,
+      );
+    }
+  }
   let actualProductHash = null;
   let actualArchitectureHash = null;
   let actualTechHash = null;
@@ -13635,6 +13938,24 @@ async function readArchitectureDriftStatus(workspaceRoot, snapshot) {
   if (!adrReadmeExists) {
     findings.push(`${FOUNDATION_ADR_DIR}/README.md is missing.`);
   }
+  for (const topicPath of topicPaths) {
+    const exists = await pathExists(topicPath);
+    const relativePath = toPosixPath(path.relative(workspaceRoot, topicPath));
+    if (!exists) {
+      findings.push(`${relativePath} is missing.`);
+      continue;
+    }
+    const content = await readFile(topicPath, "utf8");
+    if (
+      !extractTaggedMarkerAttribute(
+        content,
+        MEMORY_TOPIC_BLOCK_START_RE,
+        "profile",
+      )
+    ) {
+      findings.push(`${relativePath} is missing the managed memory topic block.`);
+    }
+  }
 
   const metadata = await readJsonFileIfExists(metadataPath);
   if (!metadata.exists) {
@@ -13644,6 +13965,7 @@ async function readArchitectureDriftStatus(workspaceRoot, snapshot) {
   return {
     stale: findings.length > 0,
     findings,
+    memoryPath,
     productPath,
     architecturePath,
     techPath,
@@ -13677,7 +13999,7 @@ async function runBuildArchitecture(options) {
         console.log(`Workspace: ${toPosixPath(workspaceRoot)}`);
         console.log(`Status: ${drift.stale ? "stale" : "fresh"}`);
         console.log(
-          `Backbone docs: ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, ${FOUNDATION_ADR_DIR}/README.md`,
+          `Backbone docs: ${FOUNDATION_DOCS_DIR}/MEMORY.md, ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, ${FOUNDATION_MEMORY_DIR}/*.md, ${FOUNDATION_ADR_DIR}/README.md`,
         );
         if (drift.findings.length > 0) {
           console.log("Findings:");
@@ -13691,9 +14013,14 @@ async function runBuildArchitecture(options) {
     }
 
     const managedFilePaths = [
+      path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "MEMORY.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "PRODUCT.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "ARCHITECTURE.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "TECH.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "domain.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "runtime.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "integrations.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "debugging.md"),
       path.join(workspaceRoot, FOUNDATION_ADR_DIR, "README.md"),
       path.join(workspaceRoot, FOUNDATION_ADR_DIR, "0000-template.md"),
     ];
@@ -13733,9 +14060,14 @@ async function runBuildArchitecture(options) {
     const adapter = await probeArchitectureAdapter(platform, workspaceRoot);
     const args = adapter.buildInvocation(prompt);
     const managedTargets = [
+      path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "MEMORY.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "PRODUCT.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "ARCHITECTURE.md"),
       path.join(workspaceRoot, FOUNDATION_DOCS_DIR, "TECH.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "domain.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "runtime.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "integrations.md"),
+      path.join(workspaceRoot, FOUNDATION_MEMORY_DIR, "debugging.md"),
       path.join(workspaceRoot, FOUNDATION_ADR_DIR, "README.md"),
       path.join(workspaceRoot, FOUNDATION_ADR_DIR, "0000-template.md"),
     ].map((filePath) => toPosixPath(filePath));
@@ -13757,9 +14089,7 @@ async function runBuildArchitecture(options) {
         console.log(`Workspace: ${toPosixPath(workspaceRoot)}`);
         console.log(`Adapter: ${adapter.binary}`);
         console.log(`Research mode: ${researchMode}`);
-        console.log(
-          `Managed targets: ${summary.managedTargets.join(", ")}`,
-        );
+        console.log(`Managed targets: ${summary.managedTargets.join(", ")}`);
         console.log(`Skill bundle: ${skillBundle.join(", ")}`);
         console.log(`Invocation: ${[adapter.binary, ...args].join(" ")}`);
       }
@@ -13793,9 +14123,11 @@ async function runBuildArchitecture(options) {
       .map((filePath) => toPosixPath(path.relative(workspaceRoot, filePath)));
 
     const techContent =
-      filesAfter[scaffold.techMdPath] ?? (await readFile(scaffold.techMdPath, "utf8"));
+      filesAfter[scaffold.techMdPath] ??
+      (await readFile(scaffold.techMdPath, "utf8"));
     const productContent =
-      filesAfter[scaffold.productPath] ?? (await readFile(scaffold.productPath, "utf8"));
+      filesAfter[scaffold.productPath] ??
+      (await readFile(scaffold.productPath, "utf8"));
     const architectureContent =
       filesAfter[scaffold.architectureDocPath] ??
       (await readFile(scaffold.architectureDocPath, "utf8"));
@@ -13809,9 +14141,14 @@ async function runBuildArchitecture(options) {
       platform,
       researchMode,
       managedDocs: [
+        `${FOUNDATION_DOCS_DIR}/MEMORY.md`,
         `${FOUNDATION_DOCS_DIR}/PRODUCT.md`,
         `${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md`,
         `${FOUNDATION_DOCS_DIR}/TECH.md`,
+        `${FOUNDATION_MEMORY_DIR}/domain.md`,
+        `${FOUNDATION_MEMORY_DIR}/runtime.md`,
+        `${FOUNDATION_MEMORY_DIR}/integrations.md`,
+        `${FOUNDATION_MEMORY_DIR}/debugging.md`,
         `${FOUNDATION_ADR_DIR}/README.md`,
         `${FOUNDATION_ADR_DIR}/0000-template.md`,
       ],
@@ -13850,7 +14187,7 @@ async function runBuildArchitecture(options) {
     console.log(`Adapter: ${adapter.binary}`);
     console.log(`Workspace: ${toPosixPath(workspaceRoot)}`);
     console.log(
-      `Managed docs: ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md`,
+      `Managed docs: ${FOUNDATION_DOCS_DIR}/MEMORY.md, ${FOUNDATION_DOCS_DIR}/PRODUCT.md, ${FOUNDATION_DOCS_DIR}/ARCHITECTURE.md, ${FOUNDATION_DOCS_DIR}/TECH.md, ${FOUNDATION_MEMORY_DIR}/*.md`,
     );
     console.log(
       `ADR scaffold: ${FOUNDATION_ADR_DIR}/README.md, ${FOUNDATION_ADR_DIR}/0000-template.md`,
@@ -13891,12 +14228,7 @@ function normalizeInitPlatforms(value) {
 }
 
 function normalizeInitMcpSelections(value) {
-  const allowed = new Set([
-    "cubis-foundry",
-    "postman",
-    "stitch",
-    "playwright",
-  ]);
+  const allowed = new Set(["cubis-foundry", "postman", "stitch", "playwright"]);
   const items = Array.isArray(value) ? value : parseCsvOption(value);
   const normalized = [];
   for (const item of items) {
@@ -14120,8 +14452,6 @@ async function runInitWizard(options) {
           bundleId: installOutcome.bundleId,
           installed: installOutcome.installResult.installed,
           skipped: installOutcome.installResult.skipped,
-          generatedWrapperSkills:
-            installOutcome.installResult.generatedWrapperSkills,
           duplicateSkillCleanup:
             installOutcome.installResult.duplicateSkillCleanup,
           sanitizedSkills: installOutcome.installResult.sanitizedSkills,