bmalph 2.7.7 → 2.9.0

package/dist/commands/init.js

@@ -1,5 +1,6 @@
 import chalk from "chalk";
-import { select, input } from "@inquirer/prompts";
+import select from "@inquirer/select";
+import input from "@inquirer/input";
 import { writeConfig } from "../utils/config.js";
 import { installProject, mergeInstructionsFile, isInitialized, previewInstall, getBundledVersions, } from "../installer.js";
 import { formatDryRunSummary } from "../utils/dryrun.js";
@@ -9,6 +10,8 @@ import { exists } from "../utils/file-system.js";
 import { join } from "node:path";
 import { isPlatformId, getPlatform, getAllPlatforms } from "../platform/registry.js";
 import { detectPlatform } from "../platform/detect.js";
+import { getPlatformMasterAgentHint } from "../platform/guidance.js";
+import { PLATFORM_IDS } from "../platform/types.js";
 export async function initCommand(options) {
     await withErrorHandling(() => runInit(options));
 }
@@ -23,8 +26,7 @@ async function resolvePlatform(projectDir, explicit) {
     // 1. Explicit flag
     if (explicit) {
         if (!isPlatformId(explicit)) {
-            throw new Error(`Unknown platform: "${explicit}". ` +
-                `Valid platforms: claude-code, codex, cursor, windsurf, copilot, aider`);
+            throw new Error(`Unknown platform: "${explicit}". ` + `Valid platforms: ${PLATFORM_IDS.join(", ")}`);
         }
         return getPlatform(explicit);
     }
@@ -100,6 +102,7 @@ async function runInit(options) {
     const bundledVersions = await getBundledVersions();
     const config = {
         name: validatedName,
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- defensive against future refactors
         description: description ?? "",
         createdAt: new Date().toISOString(),
         platform: platform.id,
@@ -125,12 +128,21 @@ async function runInit(options) {
     if (platform.commandDelivery.kind === "directory") {
         console.log(`  ${platform.commandDelivery.dir}/  Slash commands`);
     }
+    else if (platform.commandDelivery.kind === "skills") {
+        console.log(`  ${platform.commandDelivery.dir}/  BMAD skills`);
+    }
     console.log(`  bmalph/            State management`);
     // Platform-specific next step guidance
     console.log(`\nNext step:`);
     if (platform.id === "claude-code") {
         console.log(`  Use ${chalk.cyan("/bmalph")} in Claude Code to see your current phase and commands.`);
     }
+    else if (platform.id === "opencode") {
+        console.log(`  ${getPlatformMasterAgentHint(platform)}.`);
+    }
+    else if (platform.id === "codex") {
+        console.log(`  ${getPlatformMasterAgentHint(platform)}.`);
+    }
     else if (platform.tier === "full") {
         console.log(`  Ask ${platform.displayName} to ${chalk.cyan("run the BMAD master agent")} to navigate phases.`);
     }

package/dist/commands/reset.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { confirm } from "@inquirer/prompts";
+import confirm from "@inquirer/confirm";
 import { isInitialized } from "../installer.js";
 import { buildResetPlan, executeResetPlan, planToDryRunActions } from "../reset.js";
 import { formatDryRunSummary } from "../utils/dryrun.js";

package/dist/commands/run.js

@@ -24,6 +24,10 @@ async function executeRun(options) {
     if (platform.experimental) {
         console.log(chalk.yellow(`Warning: ${platform.displayName} support is experimental`));
     }
+    const reviewEnabled = await resolveReviewMode(options.review, platform);
+    if (reviewEnabled) {
+        console.log(chalk.cyan("Enhanced mode: code review every 5 implementation loops"));
+    }
     const interval = parseInterval(options.interval);
     let useDashboard = dashboard;
     if (useDashboard) {
@@ -39,9 +43,10 @@ async function executeRun(options) {
     }
     const ralph = spawnRalphLoop(projectDir, platform.id, {
         inheritStdio: !useDashboard,
+        ...(reviewEnabled && { reviewEnabled }),
     });
     if (useDashboard) {
-        await startRunDashboard({ projectDir, interval, ralph });
+        await startRunDashboard({ projectDir, interval, ralph, reviewEnabled });
         if (ralph.state === "stopped") {
             applyRalphExitCode(ralph.exitCode);
         }
@@ -65,4 +70,34 @@ function resolvePlatform(driverOverride, configPlatform) {
     }
     return getPlatform(id);
 }
+async function resolveReviewMode(reviewFlag, platform) {
+    if (reviewFlag === true) {
+        if (platform.id !== "claude-code") {
+            throw new Error("--review requires Claude Code (other drivers lack read-only enforcement)");
+        }
+        return true;
+    }
+    if (reviewFlag === false) {
+        return false;
+    }
+    if (platform.id !== "claude-code") {
+        return false;
+    }
+    if (!process.stdin.isTTY) {
+        return false;
+    }
+    const { default: select } = await import("@inquirer/select");
+    const mode = await select({
+        message: "Quality mode:",
+        choices: [
+            { name: "Standard — current behavior (no extra cost)", value: "standard" },
+            {
+                name: "Enhanced — periodic code review every 5 loops (~10-14% more tokens)",
+                value: "enhanced",
+            },
+        ],
+        default: "standard",
+    });
+    return mode === "enhanced";
+}
 //# sourceMappingURL=run.js.map

package/dist/commands/status.js

@@ -6,10 +6,8 @@ import { formatStatus } from "../utils/format-status.js";
 import { ARTIFACT_DEFINITIONS } from "../utils/artifact-definitions.js";
 import { resolveProjectPlatform } from "../platform/resolve.js";
 import { getFullTierPlatformNames } from "../platform/registry.js";
+import { getPlatformAnalysisHint, getPlatformPrdHint } from "../platform/guidance.js";
 import { scanProjectArtifacts } from "../transition/artifact-scan.js";
-function getCursorNextAction() {
-    return "Read _bmad/COMMANDS.md and ask Cursor to run the BMAD master agent";
-}
 export async function statusCommand(options) {
     await withErrorHandling(() => runStatus(options));
 }
@@ -150,15 +148,9 @@ function getNextAction(phase, status, ralphStatus, platform) {
     }
     switch (phase) {
         case 1:
-            if (platform.id === "cursor") {
-                return getCursorNextAction();
-            }
-            return "Run /analyst to start analysis";
+            return getPlatformAnalysisHint(platform);
         case 2:
-            if (platform.id === "cursor") {
-                return getCursorNextAction();
-            }
-            return "Run /pm to create PRD";
+            return getPlatformPrdHint(platform);
         case 3:
             return "Run: bmalph implement";
         case 4:

package/dist/commands/upgrade.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { confirm } from "@inquirer/prompts";
+import confirm from "@inquirer/confirm";
 import { isInitialized, copyBundledAssets, mergeInstructionsFile, previewUpgrade, getBundledVersions, } from "../installer.js";
 import { readConfig, writeConfig } from "../utils/config.js";
 import { formatDryRunSummary } from "../utils/dryrun.js";

package/dist/installer/commands.js

@@ -2,7 +2,7 @@ import { cp, mkdir, readFile, readdir, rm } from "node:fs/promises";
 import { join } from "node:path";
 import { atomicWriteFile } from "../utils/file-system.js";
 import { isEnoent } from "../utils/errors.js";
-import { SKILLS_DIR, SKILLS_PREFIX } from "../utils/constants.js";
+import { CODEX_SKILLS_DIR, SKILLS_PREFIX } from "../utils/constants.js";
 const AGENT_DESCRIPTIONS = {
     analyst: "Research, briefs, discovery",
     architect: "Technical design, architecture",
@@ -177,17 +177,27 @@ export async function classifyCommands(projectDir, slashCmdsDir) {
             continue;
         }
         // Classify: workflow/task commands (matched via CSV)
-        if (workflowRef && workflowLookup.has(workflowRef)) {
-            const csv = workflowLookup.get(workflowRef);
-            results.push({
-                name,
-                description: csv.description,
-                invocation: firstLine,
-                body,
-                kind: "workflow",
-                phase: csv.phase,
-            });
-            continue;
+        if (workflowRef) {
+            // Try direct file-path lookup first
+            let csv = workflowLookup.get(workflowRef);
+            // Fallback: resolve _bmad/.../skill-name/workflow.md → skill:skill-name
+            if (!csv) {
+                const match = workflowRef.match(/\/([^/]+)\/workflow\.md$/);
+                if (match) {
+                    csv = workflowLookup.get(`skill:${match[1]}`);
+                }
+            }
+            if (csv) {
+                results.push({
+                    name,
+                    description: csv.description,
+                    invocation: firstLine,
+                    body,
+                    kind: "workflow",
+                    phase: csv.phase,
+                });
+                continue;
+            }
         }
         // Classify: pure agent commands
         if (agentRef && !workflowRef) {
@@ -276,8 +286,15 @@ export async function generateCommandIndex(projectDir, classified) {
  * Generate Codex Skills from pre-classified slash commands.
  * Creates .agents/skills/bmad-<name>/SKILL.md for each non-CLI-pointer command.
  */
-export async function generateSkills(projectDir, classified) {
-    const skillsBaseDir = join(projectDir, SKILLS_DIR);
+export async function generateSkills(projectDir, classified, platform) {
+    const delivery = platform?.commandDelivery.kind === "skills"
+        ? platform.commandDelivery
+        : {
+            kind: "skills",
+            dir: CODEX_SKILLS_DIR,
+            frontmatterName: "command",
+        };
+    const skillsBaseDir = join(projectDir, delivery.dir);
     // Cleanup: remove existing bmad-* skill directories
     try {
         const existingDirs = await readdir(skillsBaseDir);
@@ -297,8 +314,9 @@ export async function generateSkills(projectDir, classified) {
             continue;
         const skillDir = join(skillsBaseDir, `${SKILLS_PREFIX}${cmd.name}`);
         await mkdir(skillDir, { recursive: true });
+        const frontmatterName = delivery.frontmatterName === "directory" ? `${SKILLS_PREFIX}${cmd.name}` : cmd.name;
         const skillContent = `---
-name: ${cmd.name}
+name: ${frontmatterName}
 description: >
   ${cmd.description}. Use when the user asks about ${cmd.name.replace(/-/g, " ")}.
 metadata:

package/dist/installer/install.js

@@ -23,7 +23,7 @@ export async function copyBundledAssets(projectDir, platform) {
     }
     const classified = await installBmadAssets(projectDir, bmadDir, slashCommandsDir, p);
     if (p.commandDelivery.kind === "skills") {
-        await generateSkills(projectDir, classified);
+        await generateSkills(projectDir, classified, p);
     }
     const ralphAssets = await installRalphAssets(projectDir, ralphDir, p, await getPackageVersion());
     const commandPaths = await deliverCommands(projectDir, p, slashCommandsDir);

package/dist/installer/metadata.js

@@ -22,7 +22,7 @@ export async function getBundledVersions() {
     const versionsPath = join(__dirname, "..", "..", "bundled-versions.json");
     try {
         const versions = JSON.parse(await readFile(versionsPath, "utf-8"));
-        if (!versions || typeof versions.bmadCommit !== "string") {
+        if (typeof versions.bmadCommit !== "string") {
             throw new Error("Invalid bundled-versions.json structure: missing bmadCommit");
         }
         return {

package/dist/installer/project-files.js

@@ -2,7 +2,7 @@ import { mkdir, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { atomicWriteFile, exists, parseGitignoreLines, replaceSection, } from "../utils/file-system.js";
 import { isEnoent } from "../utils/errors.js";
-import { CONFIG_FILE, SKILLS_DIR, STATE_DIR } from "../utils/constants.js";
+import { CONFIG_FILE, GITIGNORE_ENTRIES, STATE_DIR } from "../utils/constants.js";
 import { getDefaultPlatform } from "./metadata.js";
 import { isTemplateCustomized } from "./template-files.js";
 export async function updateGitignore(projectDir) {
@@ -16,8 +16,7 @@ export async function updateGitignore(projectDir) {
             throw err;
     }
     const existingLines = parseGitignoreLines(existing);
-    const entries = [".ralph/logs/", "_bmad-output/"];
-    const newEntries = entries.filter((e) => !existingLines.has(e));
+    const newEntries = GITIGNORE_ENTRIES.filter((e) => !existingLines.has(e));
     if (newEntries.length === 0)
         return;
     const suffix = existing.length > 0 && !existing.endsWith("\n")
@@ -70,13 +69,13 @@ export async function previewInstall(projectDir, platform) {
         dirsToCreate.push(`${p.commandDelivery.dir}/`);
     }
     else if (p.commandDelivery.kind === "skills") {
-        dirsToCreate.push(`${SKILLS_DIR}/`);
+        dirsToCreate.push(`${p.commandDelivery.dir}/`);
     }
     for (const dir of dirsToCreate) {
         if (await exists(join(projectDir, dir))) {
             if (dir === "_bmad/" ||
                 (p.commandDelivery.kind === "directory" && dir === `${p.commandDelivery.dir}/`) ||
-                (p.commandDelivery.kind === "skills" && dir === `${SKILLS_DIR}/`)) {
+                (p.commandDelivery.kind === "skills" && dir === `${p.commandDelivery.dir}/`)) {
                 wouldModify.push(dir);
             }
         }
@@ -144,7 +143,7 @@ export async function previewUpgrade(projectDir, platform) {
         managedPaths.push({ path: `${p.commandDelivery.dir}/`, isDir: true });
     }
     else if (p.commandDelivery.kind === "skills") {
-        managedPaths.push({ path: `${SKILLS_DIR}/`, isDir: true });
+        managedPaths.push({ path: `${p.commandDelivery.dir}/`, isDir: true });
     }
     const wouldUpdate = [];
     const wouldCreate = [];

package/dist/installer/ralph-assets.js

@@ -8,8 +8,10 @@ export async function installRalphAssets(projectDir, ralphDir, platform, package
     await mkdir(join(projectDir, ".ralph"), { recursive: true });
     const promptPath = join(projectDir, ".ralph/PROMPT.md");
     const agentPath = join(projectDir, ".ralph/@AGENT.md");
+    const reviewPromptPath = join(projectDir, ".ralph/REVIEW_PROMPT.md");
     const promptCustomized = await isTemplateCustomized(promptPath, "PROMPT.md");
     const agentCustomized = await isTemplateCustomized(agentPath, "AGENT.md");
+    const reviewPromptCustomized = await isTemplateCustomized(reviewPromptPath, "REVIEW_PROMPT.md");
     if (!promptCustomized) {
         await cp(join(ralphDir, "templates/PROMPT.md"), promptPath, {
             dereference: false,
@@ -20,6 +22,11 @@ export async function installRalphAssets(projectDir, ralphDir, platform, package
             dereference: false,
         });
     }
+    if (!reviewPromptCustomized) {
+        await cp(join(ralphDir, "templates/REVIEW_PROMPT.md"), reviewPromptPath, {
+            dereference: false,
+        });
+    }
     await cp(join(ralphDir, "RALPH-REFERENCE.md"), join(projectDir, ".ralph/RALPH-REFERENCE.md"), {
         dereference: false,
     });
@@ -83,6 +90,7 @@ export async function installRalphAssets(projectDir, ralphDir, platform, package
             ".ralph/lib/",
             ...(!promptCustomized ? [".ralph/PROMPT.md"] : []),
             ...(!agentCustomized ? [".ralph/@AGENT.md"] : []),
+            ...(!reviewPromptCustomized ? [".ralph/REVIEW_PROMPT.md"] : []),
             ...(!ralphrcCustomized && currentRalphrc !== renderedRalphrc ? [".ralph/.ralphrc"] : []),
             ".ralph/RALPH-REFERENCE.md",
         ],

package/dist/installer/template-files.js

@@ -5,10 +5,15 @@ import { getBundledRalphDir } from "./metadata.js";
 const TEMPLATE_PLACEHOLDERS = {
     "PROMPT.md": "[YOUR PROJECT NAME]",
     "AGENT.md": "pip install -r requirements.txt",
+    "REVIEW_PROMPT.md": "[YOUR PROJECT NAME]",
 };
 const RALPHRC_TEMPLATE_NAME = "RALPHRC";
 const CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE = 'ALLOWED_TOOLS="Write,Read,Edit,MultiEdit,Glob,Grep,Task,TodoWrite,WebFetch,WebSearch,EnterPlanMode,ExitPlanMode,NotebookEdit,Bash"';
 const PREVIOUS_CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE = 'ALLOWED_TOOLS="Write,Read,Edit,MultiEdit,Glob,Grep,Task,TodoWrite,WebFetch,WebSearch,NotebookEdit,Bash"';
+const RALPHRC_DRIVER_COMMENT_LINE = "# Platform driver for Ralph loop (claude-code, codex, opencode, copilot, or cursor)";
+const PREVIOUS_RALPHRC_DRIVER_COMMENT_LINE = "# Platform driver for Ralph loop (claude-code, codex, copilot, or cursor)";
+const RALPHRC_IGNORED_DRIVERS_COMMENT_LINE = "# Ignored by the codex, opencode, cursor, and copilot drivers.";
+const PREVIOUS_RALPHRC_IGNORED_DRIVERS_COMMENT_LINE = "# Ignored by the codex, cursor, and copilot drivers.";
 const CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK = `# Permission mode for Claude Code CLI (default: bypassPermissions)
 # Options: auto, acceptEdits, bypassPermissions, default, dontAsk, plan
 CLAUDE_PERMISSION_MODE="bypassPermissions"
@@ -18,6 +23,47 @@ const PREVIOUS_CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK = `# Permission mode for Cl
 # Options: auto, acceptEdits, bypassPermissions, default, dontAsk, plan
 CLAUDE_PERMISSION_MODE="auto"
 
+`;
+const QUALITY_GATES_TEMPLATE_BLOCK = `# =============================================================================
+# QUALITY GATES
+# =============================================================================
+
+# Test command to verify TESTS_STATUS claims (e.g. "npm test", "pytest")
+# When set, runs after each loop to confirm the agent's test status report.
+# Leave empty to trust the agent's TESTS_STATUS without verification.
+TEST_COMMAND="\${TEST_COMMAND:-}"
+
+# Semicolon-separated quality gate commands (e.g. "npm run lint;npm run type-check")
+# Each command runs after the loop iteration completes.
+# Commands must not contain literal semicolons; use wrapper scripts if needed.
+QUALITY_GATES="\${QUALITY_GATES:-}"
+
+# Failure mode: warn | block | circuit-breaker
+#   warn            - log failures, continue normally (default)
+#   block           - suppress exit signal so the loop keeps running
+#   circuit-breaker - feed no-progress to circuit breaker
+QUALITY_GATE_MODE="\${QUALITY_GATE_MODE:-warn}"
+
+# Timeout in seconds for each gate command
+QUALITY_GATE_TIMEOUT="\${QUALITY_GATE_TIMEOUT:-120}"
+
+# Only run gates when the agent signals completion (EXIT_SIGNAL=true)
+QUALITY_GATE_ON_COMPLETION_ONLY="\${QUALITY_GATE_ON_COMPLETION_ONLY:-false}"
+
+`;
+const REVIEW_TEMPLATE_BLOCK = `# =============================================================================
+# PERIODIC CODE REVIEW
+# =============================================================================
+
+# Enable periodic code review loops (set via 'bmalph run --review' or manually)
+# When enabled, Ralph runs a read-only review session every REVIEW_INTERVAL loops.
+# The review agent analyzes git diffs and outputs findings for the next implementation loop.
+# Currently supported on Claude Code only.
+REVIEW_ENABLED="\${REVIEW_ENABLED:-false}"
+
+# Number of implementation loops between review sessions (default: 5)
+REVIEW_INTERVAL="\${REVIEW_INTERVAL:-5}"
+
 `;
 const LEGACY_RALPHRC_TEMPLATE = `# .ralphrc - Ralph project configuration
 # Generated by: ralph enable
@@ -132,6 +178,11 @@ RALPH_VERBOSE=false
 function renderLegacyRalphrcTemplate(platformId) {
     return LEGACY_RALPHRC_TEMPLATE.replace("__PLATFORM_DRIVER__", platformId);
 }
+function normalizeManagedRalphrcContent(content) {
+    return content
+        .replace(PREVIOUS_RALPHRC_DRIVER_COMMENT_LINE, RALPHRC_DRIVER_COMMENT_LINE)
+        .replace(PREVIOUS_RALPHRC_IGNORED_DRIVERS_COMMENT_LINE, RALPHRC_IGNORED_DRIVERS_COMMENT_LINE);
+}
 function renderCurrentRalphrcTemplate(templateContent, platformId) {
     return templateContent.replace(/PLATFORM_DRIVER="\$\{PLATFORM_DRIVER:-[^"]*\}"/, `PLATFORM_DRIVER="\${PLATFORM_DRIVER:-${platformId}}"`);
 }
@@ -140,29 +191,50 @@ export async function renderRalphrcTemplate(platformId) {
     const templateContent = await readFile(join(ralphDir, "templates/ralphrc.template"), "utf-8");
     return renderCurrentRalphrcTemplate(templateContent, platformId);
 }
+function matchesManagedPermissionVariants(content, template) {
+    if (content === template) {
+        return true;
+    }
+    if (content ===
+        template
+            .replace(CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE, PREVIOUS_CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE)
+            .replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, "")) {
+        return true;
+    }
+    if (content ===
+        template
+            .replace(CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE, PREVIOUS_CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE)
+            .replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, PREVIOUS_CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK)) {
+        return true;
+    }
+    if (content ===
+        template.replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, PREVIOUS_CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK)) {
+        return true;
+    }
+    return false;
+}
 async function isRalphrcCustomized(filePath, platformId) {
-    const content = await readFile(filePath, "utf-8");
+    const content = normalizeManagedRalphrcContent(await readFile(filePath, "utf-8"));
     const currentTemplate = await renderRalphrcTemplate(platformId);
-    if (content === currentTemplate) {
+    if (matchesManagedPermissionVariants(content, currentTemplate)) {
         return false;
     }
-    const previousManagedWithoutPermissionModeTemplate = currentTemplate
-        .replace(CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE, PREVIOUS_CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE)
-        .replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, "");
-    if (content === previousManagedWithoutPermissionModeTemplate) {
+    // Check variants without quality gates block (pre-quality-gates installs)
+    const templateWithoutQG = currentTemplate.replace(QUALITY_GATES_TEMPLATE_BLOCK, "");
+    if (matchesManagedPermissionVariants(content, templateWithoutQG)) {
         return false;
     }
-    const previousDefaultModeTemplate = currentTemplate
-        .replace(CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE, PREVIOUS_CLAUDE_ALLOWED_TOOLS_TEMPLATE_LINE)
-        .replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, PREVIOUS_CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK);
-    if (content === previousDefaultModeTemplate) {
+    // Check variants without review block (pre-review installs)
+    const templateWithoutReview = currentTemplate.replace(REVIEW_TEMPLATE_BLOCK, "");
+    if (matchesManagedPermissionVariants(content, templateWithoutReview)) {
         return false;
     }
-    const previousPermissionModeManagedTemplate = currentTemplate.replace(CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK, PREVIOUS_CLAUDE_PERMISSION_MODE_TEMPLATE_BLOCK);
-    if (content === previousPermissionModeManagedTemplate) {
+    // Check variants without both quality gates and review blocks
+    const templateWithoutQGAndReview = templateWithoutQG.replace(REVIEW_TEMPLATE_BLOCK, "");
+    if (matchesManagedPermissionVariants(content, templateWithoutQGAndReview)) {
         return false;
     }
-    const legacyTemplate = renderLegacyRalphrcTemplate(platformId);
+    const legacyTemplate = normalizeManagedRalphrcContent(renderLegacyRalphrcTemplate(platformId));
     return content !== legacyTemplate;
 }
 export async function isTemplateCustomized(filePath, templateName, options) {

package/dist/platform/codex.js

@@ -1,11 +1,16 @@
 import { buildPlatformDoctorChecks } from "./doctor-checks.js";
 import { generateSkillsTierSnippet } from "./instructions-snippet.js";
+import { CODEX_SKILLS_DIR } from "../utils/constants.js";
 export const codexPlatform = {
     id: "codex",
     displayName: "OpenAI Codex",
     tier: "full",
     instructionsFile: "AGENTS.md",
-    commandDelivery: { kind: "skills" },
+    commandDelivery: {
+        kind: "skills",
+        dir: CODEX_SKILLS_DIR,
+        frontmatterName: "command",
+    },
     instructionsSectionMarker: "## BMAD-METHOD Integration",
     generateInstructionsSnippet: () => generateSkillsTierSnippet(),
     getDoctorChecks() {

package/dist/platform/detect.js

@@ -2,13 +2,14 @@ import { exists } from "../utils/file-system.js";
 import { join } from "node:path";
 const STRONG_DETECTION_MARKERS = [
     { platform: "claude-code", markers: [".claude"] },
+    { platform: "opencode", markers: [".opencode"] },
     { platform: "cursor", markers: [".cursor"] },
     { platform: "windsurf", markers: [".windsurf"] },
     { platform: "copilot", markers: [".github/copilot-instructions.md"] },
     { platform: "aider", markers: [".aider.conf.yml"] },
 ];
 const ROOT_INSTRUCTION_MARKERS = [
-    { marker: "AGENTS.md", candidates: ["codex", "cursor"] },
+    { marker: "AGENTS.md", candidates: ["codex", "opencode", "cursor"] },
     { marker: "CLAUDE.md", candidates: ["claude-code", "cursor"] },
 ];
 export async function detectPlatform(projectDir) {
@@ -22,8 +23,11 @@ export async function detectPlatform(projectDir) {
             }
         }
     }
-    if (strongCandidates.includes("cursor") && strongCandidates.length === 1) {
-        return { detected: "cursor", candidates: ["cursor"] };
+    const strongExclusivePlatforms = ["cursor", "opencode"];
+    for (const platform of strongExclusivePlatforms) {
+        if (strongCandidates.includes(platform) && strongCandidates.length === 1) {
+            return { detected: platform, candidates: [platform] };
+        }
     }
     for (const { marker, candidates: inferred } of ROOT_INSTRUCTION_MARKERS) {
         if (!(await exists(join(projectDir, marker)))) {

package/dist/platform/doctor-checks.js

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { exists } from "../utils/file-system.js";
-import { SKILLS_DIR, SKILLS_PREFIX } from "../utils/constants.js";
+import { SKILLS_PREFIX } from "../utils/constants.js";
 import { isEnoent, formatError } from "../utils/errors.js";
 /**
  * Creates the standard instructions-file doctor check for a platform.
@@ -61,7 +61,7 @@ export function buildPlatformDoctorChecks(platform) {
         checks.push(createFileExistsCheck("command-index", "_bmad/COMMANDS.md", "Run: bmalph upgrade"));
     }
     if (platform.commandDelivery.kind === "skills") {
-        checks.push(createFileExistsCheck("skills", `${SKILLS_DIR}/${SKILLS_PREFIX}analyst/SKILL.md`, "Run: bmalph upgrade"));
+        checks.push(createFileExistsCheck("skills", `${platform.commandDelivery.dir}/${SKILLS_PREFIX}analyst/SKILL.md`, "Run: bmalph upgrade"));
     }
     checks.push(createFileExistsCheck("lite-workflow", "_bmad/lite/create-prd.md", "Run: bmalph upgrade"));
     checks.push(createInstructionsFileCheck(platform));

package/dist/platform/guidance.js

@@ -0,0 +1,66 @@
+function getCommandIndexHint(platform) {
+    return `Read _bmad/COMMANDS.md and ask ${platform.displayName} to run the BMAD master agent`;
+}
+function getSkillHint(platform, skillName, skillsDir) {
+    if (platform.id === "codex") {
+        return `Use the \`$${skillName}\` Codex Skill`;
+    }
+    return `Ask ${platform.displayName} to load the \`bmad-${skillName}\` skill from \`${skillsDir}\``;
+}
+export function getPlatformAnalysisHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /analyst to start analysis";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return getSkillHint(platform, "analyst", platform.commandDelivery.dir);
+    }
+    return getCommandIndexHint(platform);
+}
+export function getPlatformPrdHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /pm to create PRD";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return getSkillHint(platform, "create-prd", platform.commandDelivery.dir);
+    }
+    return getCommandIndexHint(platform);
+}
+export function getPlatformArchitectureHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /architect to create architecture";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return getSkillHint(platform, "architect", platform.commandDelivery.dir);
+    }
+    return getCommandIndexHint(platform);
+}
+export function getPlatformEpicsStoriesHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /create-epics-stories to define epics and stories";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return getSkillHint(platform, "create-epics-stories", platform.commandDelivery.dir);
+    }
+    return getCommandIndexHint(platform);
+}
+export function getPlatformReadinessHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /architect to generate readiness report";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return getSkillHint(platform, "architect", platform.commandDelivery.dir);
+    }
+    return getCommandIndexHint(platform);
+}
+export function getPlatformMasterAgentHint(platform) {
+    if (platform.commandDelivery.kind === "directory") {
+        return "Run /bmalph to navigate phases";
+    }
+    if (platform.commandDelivery.kind === "skills") {
+        return platform.id === "codex"
+            ? "Use the `$bmalph` Codex Skill to navigate phases"
+            : `Ask ${platform.displayName} to load the \`bmad-bmalph\` skill from \`${platform.commandDelivery.dir}\``;
+    }
+    return getCommandIndexHint(platform);
+}
+//# sourceMappingURL=guidance.js.map

package/dist/platform/instructions-snippet.js

@@ -59,6 +59,21 @@ export function generateSkillsTierSnippet() {
 BMAD commands are available as Codex Skills. Use \`$command-name\` to invoke them
 (e.g., \`$create-prd\`, \`$analyst\`). See \`_bmad/COMMANDS.md\` for a full reference.
 
+${FULL_TIER_PHASES}
+`;
+}
+/**
+ * Instructions snippet for OpenCode's native skills layout.
+ */
+export function generateOpencodeSkillsTierSnippet() {
+    return `
+## BMAD-METHOD Integration
+
+BMAD commands are available as native OpenCode skills in \`.opencode/skills/\`.
+Load the matching skill name (for example \`bmad-analyst\` or \`bmad-create-prd\`)
+when the user asks for a BMAD workflow or agent. Use the OpenCode question tool (\`question\`)
+when a BMAD workflow needs interactive answers. See \`_bmad/COMMANDS.md\` for a full reference.
+
 ${FULL_TIER_PHASES}
 `;
 }

package/dist/platform/opencode.js

@@ -0,0 +1,20 @@
+import { buildPlatformDoctorChecks } from "./doctor-checks.js";
+import { generateOpencodeSkillsTierSnippet } from "./instructions-snippet.js";
+import { OPENCODE_SKILLS_DIR } from "../utils/constants.js";
+export const opencodePlatform = {
+    id: "opencode",
+    displayName: "OpenCode",
+    tier: "full",
+    instructionsFile: "AGENTS.md",
+    commandDelivery: {
+        kind: "skills",
+        dir: OPENCODE_SKILLS_DIR,
+        frontmatterName: "directory",
+    },
+    instructionsSectionMarker: "## BMAD-METHOD Integration",
+    generateInstructionsSnippet: () => generateOpencodeSkillsTierSnippet(),
+    getDoctorChecks() {
+        return buildPlatformDoctorChecks(this);
+    },
+};
+//# sourceMappingURL=opencode.js.map