@nathapp/nax 0.50.3 → 0.51.2

package/dist/nax.js

@@ -3246,6 +3246,8 @@ function resolveTestStrategy(raw) {
     return "test-after";
   if (VALID_TEST_STRATEGIES.includes(raw))
     return raw;
+  if (raw === "none")
+    return "no-test";
   if (raw === "tdd")
     return "tdd-simple";
   if (raw === "three-session")
@@ -3256,6 +3258,9 @@ function resolveTestStrategy(raw) {
 }
 var VALID_TEST_STRATEGIES, COMPLEXITY_GUIDE = `## Complexity Classification Guide
 
+- no-test: Config-only changes, documentation, CI/build files, dependency bumps, pure refactors
+  with NO behavioral change. MUST include noTestJustification explaining why tests are unnecessary.
+  If any user-facing behavior changes, use tdd-simple or higher.
 - simple: \u226450 LOC, single-file change, purely additive, no new dependencies \u2192 tdd-simple
 - medium: 50\u2013200 LOC, 2\u20135 files, standard patterns, clear requirements \u2192 three-session-tdd-lite
 - complex: 200\u2013500 LOC, multiple modules, new abstractions or integrations \u2192 three-session-tdd
@@ -3266,6 +3271,9 @@ var VALID_TEST_STRATEGIES, COMPLEXITY_GUIDE = `## Complexity Classification Guid
 Security-critical functions (authentication, cryptography, tokens, sessions, credentials,
 password hashing, access control) must use three-session-tdd regardless of complexity.`, TEST_STRATEGY_GUIDE = `## Test Strategy Guide
 
+- no-test: Stories with zero behavioral change \u2014 config files, documentation, CI/build changes,
+  dependency bumps, pure structural refactors. REQUIRES noTestJustification field. If any runtime
+  behavior changes, use tdd-simple or higher. When in doubt, use tdd-simple.
 - tdd-simple: Simple stories (\u226450 LOC). Write failing tests first, then implement to pass them \u2014 all in one session.
 - three-session-tdd-lite: Medium stories, or complex stories involving UI/CLI/integration. 3 sessions: (1) test-writer writes failing tests and may create minimal src/ stubs for imports, (2) implementer makes tests pass and may replace stubs, (3) verifier confirms correctness.
 - three-session-tdd: Complex/expert stories or security-critical code. 3 sessions with strict isolation: (1) test-writer writes failing tests \u2014 no src/ changes allowed, (2) implementer makes them pass without modifying test files, (3) verifier confirms correctness.
@@ -3283,6 +3291,7 @@ password hashing, access control) must use three-session-tdd regardless of compl
 - Aim for coherent units of value. Maximum recommended stories: 10-15 per feature.`;
 var init_test_strategy = __esm(() => {
   VALID_TEST_STRATEGIES = [
+    "no-test",
     "test-after",
     "tdd-simple",
     "three-session-tdd",
@@ -3312,7 +3321,8 @@ Decompose this spec into user stories. For each story, provide:
 9. reasoning: Why this complexity level
 10. estimatedLOC: Estimated lines of code to change
 11. risks: Array of implementation risks
-12. testStrategy: "test-after" | "tdd-simple" | "three-session-tdd" | "three-session-tdd-lite"
+12. testStrategy: "no-test" | "test-after" | "tdd-simple" | "three-session-tdd" | "three-session-tdd-lite"
+13. noTestJustification: string (REQUIRED when testStrategy is "no-test" \u2014 explain why tests are unnecessary)
 
 ${COMPLEXITY_GUIDE}
 
@@ -17967,8 +17977,8 @@ var init_schemas3 = __esm(() => {
     storySizeGate: StorySizeGateConfigSchema
   });
   PromptsConfigSchema = exports_external.object({
-    overrides: exports_external.record(exports_external.string().refine((key) => ["test-writer", "implementer", "verifier", "single-session", "tdd-simple"].includes(key), {
-      message: "Role must be one of: test-writer, implementer, verifier, single-session, tdd-simple"
+    overrides: exports_external.record(exports_external.string().refine((key) => ["no-test", "test-writer", "implementer", "verifier", "single-session", "tdd-simple"].includes(key), {
+      message: "Role must be one of: no-test, test-writer, implementer, verifier, single-session, tdd-simple"
     }), exports_external.string().min(1, "Override path must be non-empty")).optional()
   });
   DecomposeConfigSchema = exports_external.object({
@@ -18761,7 +18771,8 @@ Rules:
 - **integration-check ACs** \u2192 use the language's HTTP client or existing test helpers; add a clear setup block (beforeAll/setup/TestMain/etc.) explaining what must be running
 - **NEVER use placeholder assertions** \u2014 no always-passing or always-failing stubs, no TODO comments as the only content, no empty test bodies
 - Every test MUST have real assertions that PASS when the feature is correctly implemented and FAIL when it is broken
-- Output raw code only \u2014 no markdown fences, start directly with the language's import or package declaration`;
+- Output raw code only \u2014 no markdown fences, start directly with the language's import or package declaration
+- **Path anchor (CRITICAL)**: This test file will be saved at \`<repo-root>/nax/features/${options.featureName}/acceptance.test.ts\` and will ALWAYS run from the repo root via \`bun test <absolute-path>\`. The repo root is exactly 3 \`../\` levels above \`__dirname\`: \`join(__dirname, '..', '..', '..')\`. Never use 4 or more \`../\` \u2014 that would escape the repo. For monorepo projects, navigate into packages from root (e.g. \`join(root, 'apps/api/src')\`).`;
   const prompt = basePrompt;
   logger.info("acceptance", "Generating tests from PRD refined criteria", { count: refinedCriteria.length });
   const rawOutput = await (options.adapter ?? _generatorPRDDeps.adapter).complete(prompt, {
@@ -18846,7 +18857,8 @@ Rules:
 - **integration-check ACs** \u2192 use the language's HTTP client or existing test helpers; add a clear setup block (beforeAll/setup/TestMain/etc.) explaining what must be running
 - **NEVER use placeholder assertions** \u2014 no always-passing or always-failing stubs, no TODO comments as the only content, no empty test bodies
 - Every test MUST have real assertions that PASS when the feature is correctly implemented and FAIL when it is broken
-- Output raw code only \u2014 no markdown fences, start directly with the language's import or package declaration`;
+- Output raw code only \u2014 no markdown fences, start directly with the language's import or package declaration
+- **Path anchor (CRITICAL)**: This test file will be saved at \`<repo-root>/nax/features/${featureName}/acceptance.test.ts\` and will ALWAYS run from the repo root via \`bun test <absolute-path>\`. The repo root is exactly 3 \`../\` levels above \`__dirname\`: \`join(__dirname, '..', '..', '..')\`. Never use 4 or more \`../\` \u2014 that would escape the repo. For monorepo projects, navigate into packages from root (e.g. \`join(root, 'apps/api/src')\`).`;
 }
 async function generateAcceptanceTests(adapter, options) {
   const logger = getLogger();
@@ -18961,7 +18973,34 @@ function findRelatedStories(failedAC, prd) {
   const passedStories = prd.userStories.filter((s) => s.status === "passed").map((s) => s.id);
   return passedStories.slice(0, 5);
 }
-function buildFixPrompt(failedAC, acText, testOutput, relatedStories, prd) {
+function groupACsByRelatedStories(failedACs, prd) {
+  const groups = new Map;
+  for (const ac of failedACs) {
+    const related = findRelatedStories(ac, prd);
+    const key = [...related].sort().join(",");
+    if (!groups.has(key)) {
+      groups.set(key, { acs: [], relatedStories: related });
+    }
+    groups.get(key)?.acs.push(ac);
+  }
+  const result = Array.from(groups.values());
+  while (result.length > MAX_FIX_STORIES) {
+    result.sort((a, b) => a.acs.length - b.acs.length);
+    const smallest = result.shift();
+    if (!smallest)
+      break;
+    result[0].acs.push(...smallest.acs);
+    for (const s of smallest.relatedStories) {
+      if (!result[0].relatedStories.includes(s)) {
+        result[0].relatedStories.push(s);
+      }
+    }
+  }
+  return result;
+}
+function buildFixPrompt(batchedACs, acTextMap, testOutput, relatedStories, prd, testFilePath) {
+  const acList = batchedACs.map((ac) => `${ac}: ${acTextMap[ac] || "No description available"}`).join(`
+`);
   const relatedStoriesText = relatedStories.map((id) => {
     const story = prd.userStories.find((s) => s.id === id);
     if (!story)
@@ -18971,43 +19010,47 @@ function buildFixPrompt(failedAC, acText, testOutput, relatedStories, prd) {
   }).filter(Boolean).join(`
 
 `);
-  return `You are a debugging expert. A feature acceptance test has failed.
-
-FAILED ACCEPTANCE CRITERION:
-${failedAC}: ${acText}
+  const testFileSection = testFilePath ? `
+ACCEPTANCE TEST FILE: ${testFilePath}
+(Read this file first to understand what each test expects)
+` : "";
+  return `You are a debugging expert. Feature acceptance tests have failed.${testFileSection}
+FAILED ACCEPTANCE CRITERIA (${batchedACs.length} total):
+${acList}
 
 TEST FAILURE OUTPUT:
-${testOutput}
+${testOutput.slice(0, 2000)}
 
 RELATED STORIES (implemented this functionality):
 ${relatedStoriesText}
 
-Your task: Generate a fix story description that will make the acceptance test pass.
+Your task: Generate a fix description that will make these acceptance tests pass.
 
 Requirements:
-1. Analyze the test failure to understand the root cause
-2. Identify what needs to change in the code
-3. Write a clear, actionable fix description (2-4 sentences)
-4. Focus on the specific issue, not general improvements
+1. Read the acceptance test file first to understand what each failing test expects
+2. Identify the root cause based on the test failure output
+3. Find and fix the relevant implementation code (do NOT modify the test file)
+4. Write a clear, actionable fix description (2-4 sentences)
 5. Reference the relevant story IDs if needed
 
 Respond with ONLY the fix description (no JSON, no markdown, just the description text).`;
 }
 async function generateFixStories(adapter, options) {
-  const { failedACs, testOutput, prd, specContent, modelDef } = options;
-  const fixStories = [];
-  const acTextMap = parseACTextFromSpec(specContent);
+  const { failedACs, testOutput, prd, specContent, modelDef, testFilePath } = options;
   const logger = getLogger();
-  for (let i = 0;i < failedACs.length; i++) {
-    const failedAC = failedACs[i];
-    const acText = acTextMap[failedAC] || "No description available";
-    logger.info("acceptance", "Generating fix for failed AC", { failedAC });
-    const relatedStories = findRelatedStories(failedAC, prd);
+  const acTextMap = parseACTextFromSpec(specContent);
+  const groups = groupACsByRelatedStories(failedACs, prd);
+  const fixStories = [];
+  for (let i = 0;i < groups.length; i++) {
+    const { acs: batchedACs, relatedStories } = groups[i];
     if (relatedStories.length === 0) {
-      logger.warn("acceptance", "\u26A0 No related stories found for failed AC \u2014 skipping", { failedAC });
+      logger.warn("acceptance", "[WARN] No related stories found for AC group \u2014 skipping", { batchedACs });
       continue;
     }
-    const prompt = buildFixPrompt(failedAC, acText, testOutput, relatedStories, prd);
+    logger.info("acceptance", "Generating fix for AC group", { batchedACs });
+    const prompt = buildFixPrompt(batchedACs, acTextMap, testOutput, relatedStories, prd, testFilePath);
+    const relatedStory = prd.userStories.find((s) => relatedStories.includes(s.id) && s.workdir);
+    const workdir = relatedStory?.workdir;
     try {
       const fixDescription = await adapter.complete(prompt, {
         model: modelDef.model,
@@ -19015,25 +19058,31 @@ async function generateFixStories(adapter, options) {
       });
       fixStories.push({
         id: `US-FIX-${String(i + 1).padStart(3, "0")}`,
-        title: `Fix: ${failedAC} \u2014 ${acText.slice(0, 50)}`,
-        failedAC,
+        title: `Fix: ${batchedACs.join(", ")} \u2014 ${(acTextMap[batchedACs[0]] || "").slice(0, 40)}`,
+        failedAC: batchedACs[0],
+        batchedACs,
         testOutput,
         relatedStories,
-        description: fixDescription
+        description: fixDescription,
+        testFilePath,
+        workdir
       });
-      logger.info("acceptance", "\u2713 Generated fix story", { storyId: fixStories[fixStories.length - 1].id });
+      logger.info("acceptance", "[OK] Generated fix story", { storyId: fixStories[fixStories.length - 1].id });
     } catch (error48) {
-      logger.warn("acceptance", "\u26A0 Error generating fix", {
-        failedAC,
+      logger.warn("acceptance", "[WARN] Error generating fix", {
+        batchedACs,
         error: error48.message
       });
       fixStories.push({
         id: `US-FIX-${String(i + 1).padStart(3, "0")}`,
-        title: `Fix: ${failedAC}`,
-        failedAC,
+        title: `Fix: ${batchedACs.join(", ")}`,
+        failedAC: batchedACs[0],
+        batchedACs,
         testOutput,
         relatedStories,
-        description: `Fix the implementation to make ${failedAC} pass. Related stories: ${relatedStories.join(", ")}.`
+        description: `Fix the implementation to make ${batchedACs.join(", ")} pass. Related stories: ${relatedStories.join(", ")}.`,
+        testFilePath,
+        workdir
       });
     }
   }
@@ -19054,20 +19103,40 @@ function parseACTextFromSpec(specContent) {
   return map2;
 }
 function convertFixStoryToUserStory(fixStory) {
+  const batchedACs = fixStory.batchedACs ?? [fixStory.failedAC];
+  const acList = batchedACs.join(", ");
+  const truncatedOutput = fixStory.testOutput.slice(0, 1000);
+  const testFilePath = fixStory.testFilePath ?? "acceptance.test.ts";
+  const enrichedDescription = [
+    fixStory.description,
+    "",
+    `ACCEPTANCE TEST FILE: ${testFilePath}`,
+    `FAILED ACCEPTANCE CRITERIA: ${acList}`,
+    "",
+    "TEST FAILURE OUTPUT:",
+    truncatedOutput,
+    "",
+    "Instructions: Read the acceptance test file first to understand what each failing test expects.",
+    "Then find the relevant source code and fix the implementation.",
+    "Do NOT modify the test file."
+  ].join(`
+`);
   return {
     id: fixStory.id,
     title: fixStory.title,
-    description: fixStory.description,
-    acceptanceCriteria: [`Fix ${fixStory.failedAC}`],
+    description: enrichedDescription,
+    acceptanceCriteria: batchedACs.map((ac) => `Fix ${ac}`),
     tags: ["fix", "acceptance-failure"],
     dependencies: fixStory.relatedStories,
     status: "pending",
     passes: false,
     escalations: [],
     attempts: 0,
-    contextFiles: []
+    contextFiles: [],
+    workdir: fixStory.workdir
   };
 }
+var MAX_FIX_STORIES = 8;
 var init_fix_generator = __esm(() => {
   init_logger2();
 });
@@ -19460,7 +19529,7 @@ async function closeAcpSession(session) {
   }
 }
 function acpSessionsPath(workdir, featureName) {
-  return join3(workdir, "nax", "features", featureName, "acp-sessions.json");
+  return join3(workdir, ".nax", "features", featureName, "acp-sessions.json");
 }
 function sidecarSessionName(entry) {
   return typeof entry === "string" ? entry : entry.sessionName;
@@ -20971,6 +21040,7 @@ import { join as join6, resolve as resolve4 } from "path";
 function globalConfigDir() {
   return join6(homedir3(), ".nax");
 }
+var PROJECT_NAX_DIR = ".nax";
 var init_paths = () => {};
 
 // src/config/loader.ts
@@ -20983,7 +21053,7 @@ function findProjectDir(startDir = process.cwd()) {
   let dir = resolve5(startDir);
   let depth = 0;
   while (depth < MAX_DIRECTORY_DEPTH) {
-    const candidate = join7(dir, "nax");
+    const candidate = join7(dir, PROJECT_NAX_DIR);
     if (existsSync5(join7(candidate, "config.json"))) {
       return candidate;
     }
@@ -21053,7 +21123,7 @@ async function loadConfigForWorkdir(rootConfigPath, packageDir) {
     return rootConfig;
   }
   const repoRoot = dirname2(rootNaxDir);
-  const packageConfigPath = join7(repoRoot, packageDir, "nax", "config.json");
+  const packageConfigPath = join7(repoRoot, PROJECT_NAX_DIR, "mono", packageDir, "config.json");
   const packageOverride = await loadJsonFile(packageConfigPath, "config");
   if (!packageOverride) {
     return rootConfig;
@@ -22329,7 +22399,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@nathapp/nax",
-    version: "0.50.3",
+    version: "0.51.2",
     description: "AI Coding Agent Orchestrator \u2014 loops until done",
     type: "module",
     bin: {
@@ -22380,8 +22450,6 @@ var init_package = __esm(() => {
     ],
     files: [
       "dist/",
-      "src/",
-      "bin/",
       "README.md",
       "CHANGELOG.md"
     ],
@@ -22403,8 +22471,8 @@ var init_version = __esm(() => {
   NAX_VERSION = package_default.version;
   NAX_COMMIT = (() => {
     try {
-      if (/^[0-9a-f]{6,10}$/.test("684b48b"))
-        return "684b48b";
+      if (/^[0-9a-f]{6,10}$/.test("7f71f43"))
+        return "7f71f43";
     } catch {}
     try {
       const result = Bun.spawnSync(["git", "rev-parse", "--short", "HEAD"], {
@@ -22553,14 +22621,14 @@ function collectBatchMetrics(ctx, storyStartTime) {
   });
 }
 async function saveRunMetrics(workdir, runMetrics) {
-  const metricsPath = path2.join(workdir, "nax", "metrics.json");
+  const metricsPath = path2.join(workdir, ".nax", "metrics.json");
   const existing = await loadJsonFile(metricsPath, "metrics");
   const allMetrics = Array.isArray(existing) ? existing : [];
   allMetrics.push(runMetrics);
   await saveJsonFile(metricsPath, allMetrics, "metrics");
 }
 async function loadRunMetrics(workdir) {
-  const metricsPath = path2.join(workdir, "nax", "metrics.json");
+  const metricsPath = path2.join(workdir, ".nax", "metrics.json");
   const content = await loadJsonFile(metricsPath, "metrics");
   return Array.isArray(content) ? content : [];
 }
@@ -24254,10 +24322,18 @@ var init_agents = __esm(() => {
 // src/pipeline/stages/acceptance-setup.ts
 var exports_acceptance_setup = {};
 __export(exports_acceptance_setup, {
+  computeACFingerprint: () => computeACFingerprint,
   acceptanceSetupStage: () => acceptanceSetupStage,
   _acceptanceSetupDeps: () => _acceptanceSetupDeps
 });
 import path5 from "path";
+function computeACFingerprint(criteria) {
+  const sorted = [...criteria].sort().join(`
+`);
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(sorted);
+  return `sha256:${hasher.digest("hex")}`;
+}
 var _acceptanceSetupDeps, acceptanceSetupStage;
 var init_acceptance_setup = __esm(() => {
   init_config();
@@ -24269,6 +24345,27 @@ var init_acceptance_setup = __esm(() => {
     writeFile: async (filePath, content) => {
       await Bun.write(filePath, content);
     },
+    copyFile: async (src, dest) => {
+      const content = await Bun.file(src).text();
+      await Bun.write(dest, content);
+    },
+    deleteFile: async (filePath) => {
+      const { unlink } = await import("fs/promises");
+      await unlink(filePath);
+    },
+    readMeta: async (metaPath) => {
+      const f = Bun.file(metaPath);
+      if (!await f.exists())
+        return null;
+      try {
+        return JSON.parse(await f.text());
+      } catch {
+        return null;
+      }
+    },
+    writeMeta: async (metaPath, meta3) => {
+      await Bun.write(metaPath, JSON.stringify(meta3, null, 2));
+    },
     runTest: async (_testPath, _workdir) => {
       const proc = Bun.spawn(["bun", "test", _testPath], {
         cwd: _workdir,
@@ -24302,11 +24399,22 @@ ${stderr}` };
         return { action: "fail", reason: "[acceptance-setup] featureDir is not set" };
       }
       const testPath = path5.join(ctx.featureDir, "acceptance.test.ts");
-      const fileExists = await _acceptanceSetupDeps.fileExists(testPath);
+      const metaPath = path5.join(ctx.featureDir, "acceptance-meta.json");
+      const allCriteria = ctx.prd.userStories.flatMap((s) => s.acceptanceCriteria);
       let totalCriteria = 0;
       let testableCount = 0;
-      if (!fileExists) {
-        const allCriteria = ctx.prd.userStories.flatMap((s) => s.acceptanceCriteria);
+      const fileExists = await _acceptanceSetupDeps.fileExists(testPath);
+      let shouldGenerate = !fileExists;
+      if (fileExists) {
+        const fingerprint = computeACFingerprint(allCriteria);
+        const meta3 = await _acceptanceSetupDeps.readMeta(metaPath);
+        if (!meta3 || meta3.acFingerprint !== fingerprint) {
+          await _acceptanceSetupDeps.copyFile(testPath, `${testPath}.bak`);
+          await _acceptanceSetupDeps.deleteFile(testPath);
+          shouldGenerate = true;
+        }
+      }
+      if (shouldGenerate) {
         totalCriteria = allCriteria.length;
         const { getAgent: getAgent2 } = await Promise.resolve().then(() => (init_agents(), exports_agents));
         const agent = (ctx.agentGetFn ?? getAgent2)(ctx.config.autoMode.defaultAgent);
@@ -24341,6 +24449,14 @@ ${stderr}` };
           adapter: agent ?? undefined
         });
         await _acceptanceSetupDeps.writeFile(testPath, result.testCode);
+        const fingerprint = computeACFingerprint(allCriteria);
+        await _acceptanceSetupDeps.writeMeta(metaPath, {
+          generatedAt: new Date().toISOString(),
+          acFingerprint: fingerprint,
+          storyCount: ctx.prd.userStories.length,
+          acCount: totalCriteria,
+          generator: "nax"
+        });
       }
       if (ctx.config.acceptance.redGate === false) {
         ctx.acceptanceSetup = { totalCriteria, testableCount, redFailCount: 0 };
@@ -24444,7 +24560,7 @@ function hasScript(packageJson, scriptName) {
     return false;
   return scriptName in scripts;
 }
-async function resolveCommand(check2, config2, executionConfig, workdir) {
+async function resolveCommand(check2, config2, executionConfig, workdir, qualityCommands) {
   if (executionConfig) {
     if (check2 === "lint" && executionConfig.lintCommand !== undefined) {
       return executionConfig.lintCommand;
@@ -24456,6 +24572,10 @@ async function resolveCommand(check2, config2, executionConfig, workdir) {
   if (config2.commands[check2]) {
     return config2.commands[check2] ?? null;
   }
+  const qualityCmd = qualityCommands?.[check2];
+  if (qualityCmd) {
+    return qualityCmd;
+  }
   const packageJson = await loadPackageJson(workdir);
   if (hasScript(packageJson, check2)) {
     return `bun run ${check2}`;
@@ -24553,7 +24673,7 @@ async function getUncommittedFilesImpl(workdir) {
     return [];
   }
 }
-async function runReview(config2, workdir, executionConfig) {
+async function runReview(config2, workdir, executionConfig, qualityCommands) {
   const startTime = Date.now();
   const logger = getSafeLogger();
   const checks3 = [];
@@ -24591,7 +24711,7 @@ Stage and commit these files before running review.`
     };
   }
   for (const checkName of config2.checks) {
-    const command = await resolveCommand(checkName, config2, executionConfig, workdir);
+    const command = await resolveCommand(checkName, config2, executionConfig, workdir, qualityCommands);
     if (command === null) {
       getSafeLogger()?.warn("review", `Skipping ${checkName} check (command not configured or disabled)`);
       continue;
@@ -24653,9 +24773,9 @@ async function getChangedFiles(workdir, baseRef) {
 }
 
 class ReviewOrchestrator {
-  async review(reviewConfig, workdir, executionConfig, plugins, storyGitRef, scopePrefix) {
+  async review(reviewConfig, workdir, executionConfig, plugins, storyGitRef, scopePrefix, qualityCommands) {
     const logger = getSafeLogger();
-    const builtIn = await runReview(reviewConfig, workdir, executionConfig);
+    const builtIn = await runReview(reviewConfig, workdir, executionConfig, qualityCommands);
     if (!builtIn.success) {
       return { builtIn, success: false, failureReason: builtIn.failureReason, pluginFailed: false };
     }
@@ -24745,7 +24865,7 @@ var init_review = __esm(() => {
       const effectiveConfig = ctx.effectiveConfig ?? ctx.config;
       logger.info("review", "Running review phase", { storyId: ctx.story.id });
       const effectiveWorkdir = ctx.story.workdir ? join17(ctx.workdir, ctx.story.workdir) : ctx.workdir;
-      const result = await reviewOrchestrator.review(effectiveConfig.review, effectiveWorkdir, effectiveConfig.execution, ctx.plugins, ctx.storyGitRef, ctx.story.workdir);
+      const result = await reviewOrchestrator.review(effectiveConfig.review, effectiveWorkdir, effectiveConfig.execution, ctx.plugins, ctx.storyGitRef, ctx.story.workdir, effectiveConfig.quality?.commands);
       ctx.reviewResult = result.builtIn;
       if (!result.success) {
         const allFindings = result.builtIn.pluginReviewers?.flatMap((pr) => pr.findings ?? []) ?? [];
@@ -25962,7 +26082,7 @@ function hookCtx(feature, opts) {
   };
 }
 async function loadPackageContextMd(packageWorkdir) {
-  const contextPath = `${packageWorkdir}/nax/context.md`;
+  const contextPath = `${packageWorkdir}/.nax/context.md`;
   const file2 = Bun.file(contextPath);
   if (!await file2.exists())
     return null;
@@ -27144,6 +27264,11 @@ function buildIsolationSection(roleOrMode, mode, testCommand) {
   const footer = `
 
 ${buildTestFilterRule(testCmd)}`;
+  if (role === "no-test") {
+    return `${header}
+
+isolation scope: Implement changes in src/ and other non-test directories. Do NOT create or modify any files in the test/ directory.${footer}`;
+  }
   if (role === "test-writer") {
     const m = mode ?? "strict";
     if (m === "strict") {
@@ -27191,13 +27316,26 @@ function buildTestFrameworkHint(testCommand) {
     return "Use Jest (describe/test/expect)";
   return "Use your project's test framework";
 }
-function buildRoleTaskSection(roleOrVariant, variant, testCommand, isolation) {
+function buildRoleTaskSection(roleOrVariant, variant, testCommand, isolation, noTestJustification) {
   if ((roleOrVariant === "standard" || roleOrVariant === "lite") && variant === undefined) {
     return buildRoleTaskSection("implementer", roleOrVariant, testCommand, isolation);
   }
   const role = roleOrVariant;
   const testCmd = testCommand ?? DEFAULT_TEST_CMD2;
   const frameworkHint = buildTestFrameworkHint(testCmd);
+  if (role === "no-test") {
+    const justification = noTestJustification ?? "No behavioral changes \u2014 tests not required";
+    return `# Role: Implementer (No Tests)
+
+Your task: implement the change as described. This story has no behavioral changes and does not require test modifications.
+
+Instructions:
+- Implement the change as described in the story
+- Do NOT create or modify test files
+- Justification for no tests: ${justification}
+- When done, stage and commit ALL changed files with: git commit -m 'feat: <description>'
+- Goal: change implemented, no test files created or modified, all changes committed`;
+  }
   if (role === "implementer") {
     const v = variant ?? "standard";
     if (v === "standard") {
@@ -27472,6 +27610,7 @@ class PromptBuilder {
   _loaderConfig;
   _testCommand;
   _hermeticConfig;
+  _noTestJustification;
   constructor(role, options = {}) {
     this._role = role;
     this._options = options;
@@ -27515,6 +27654,10 @@ class PromptBuilder {
     this._hermeticConfig = config2;
     return this;
   }
+  noTestJustification(justification) {
+    this._noTestJustification = justification;
+    return this;
+  }
   async build() {
     const sections = [];
     if (this._constitution) {
@@ -27574,7 +27717,7 @@ ${this._contextMd}
     }
     const variant = this._options.variant;
     const isolation = this._options.isolation;
-    return buildRoleTaskSection(this._role, variant, this._testCommand, isolation);
+    return buildRoleTaskSection(this._role, variant, this._testCommand, isolation, this._noTestJustification);
   }
 }
 var SECTION_SEP2 = `
@@ -28777,8 +28920,8 @@ var init_prompt = __esm(() => {
         const builder = PromptBuilder.for("batch").withLoader(ctx.workdir, ctx.config).stories(ctx.stories).context(ctx.contextMarkdown).constitution(ctx.constitution?.content).testCommand(effectiveConfig.quality?.commands?.test).hermeticConfig(effectiveConfig.quality?.testing);
         prompt = await builder.build();
       } else {
-        const role = "tdd-simple";
-        const builder = PromptBuilder.for(role).withLoader(ctx.workdir, ctx.config).story(ctx.story).context(ctx.contextMarkdown).constitution(ctx.constitution?.content).testCommand(effectiveConfig.quality?.commands?.test).hermeticConfig(effectiveConfig.quality?.testing);
+        const role = ctx.routing.testStrategy === "no-test" ? "no-test" : "tdd-simple";
+        const builder = PromptBuilder.for(role).withLoader(ctx.workdir, ctx.config).story(ctx.story).context(ctx.contextMarkdown).constitution(ctx.constitution?.content).testCommand(effectiveConfig.quality?.commands?.test).hermeticConfig(effectiveConfig.quality?.testing).noTestJustification(ctx.story.routing?.noTestJustification);
         prompt = await builder.build();
       }
       ctx.prompt = prompt;
@@ -30411,8 +30554,7 @@ function generatePackageContextTemplate(packagePath) {
 }
 async function initPackage(repoRoot, packagePath, force = false) {
   const logger = getLogger();
-  const packageDir = join31(repoRoot, packagePath);
-  const naxDir = join31(packageDir, "nax");
+  const naxDir = join31(repoRoot, ".nax", "mono", packagePath);
   const contextPath = join31(naxDir, "context.md");
   if (existsSync20(contextPath) && !force) {
     logger.info("init", "Package context.md already exists (use --force to overwrite)", { path: contextPath });
@@ -30427,7 +30569,7 @@ async function initPackage(repoRoot, packagePath, force = false) {
 }
 async function initContext(projectRoot, options = {}) {
   const logger = getLogger();
-  const naxDir = join31(projectRoot, "nax");
+  const naxDir = join31(projectRoot, ".nax");
   const contextPath = join31(naxDir, "context.md");
   if (existsSync20(contextPath) && !options.force) {
     logger.info("init", "context.md already exists, skipping (use --force to overwrite)", { path: contextPath });
@@ -30444,7 +30586,7 @@ async function initContext(projectRoot, options = {}) {
     content = generateContextTemplate(scan);
   }
   await Bun.write(contextPath, content);
-  logger.info("init", "Generated nax/context.md template from project scan", { path: contextPath });
+  logger.info("init", "Generated .nax/context.md template from project scan", { path: contextPath });
 }
 var _deps6;
 var init_init_context = __esm(() => {
@@ -31015,18 +31157,18 @@ var NAX_RUNTIME_PATTERNS;
 var init_checks_git = __esm(() => {
   NAX_RUNTIME_PATTERNS = [
     /^.{2} nax\.lock$/,
-    /^.{2} nax\/$/,
-    /^.{2} nax\/metrics\.json$/,
-    /^.{2} nax\/features\/$/,
-    /^.{2} nax\/features\/[^/]+\/$/,
-    /^.{2} nax\/features\/[^/]+\/status\.json$/,
-    /^.{2} nax\/features\/[^/]+\/prd\.json$/,
-    /^.{2} nax\/features\/[^/]+\/runs\//,
-    /^.{2} nax\/features\/[^/]+\/plan\//,
-    /^.{2} nax\/features\/[^/]+\/acp-sessions\.json$/,
-    /^.{2} nax\/features\/[^/]+\/interactions\//,
-    /^.{2} nax\/features\/[^/]+\/progress\.txt$/,
-    /^.{2} nax\/features\/[^/]+\/acceptance-refined\.json$/,
+    /^.{2} \.nax\/$/,
+    /^.{2} \.nax\/metrics\.json$/,
+    /^.{2} \.nax\/features\/$/,
+    /^.{2} \.nax\/features\/[^/]+\/$/,
+    /^.{2} \.nax\/features\/[^/]+\/status\.json$/,
+    /^.{2} \.nax\/features\/[^/]+\/prd\.json$/,
+    /^.{2} \.nax\/features\/[^/]+\/runs\//,
+    /^.{2} \.nax\/features\/[^/]+\/plan\//,
+    /^.{2} \.nax\/features\/[^/]+\/acp-sessions\.json$/,
+    /^.{2} \.nax\/features\/[^/]+\/interactions\//,
+    /^.{2} \.nax\/features\/[^/]+\/progress\.txt$/,
+    /^.{2} \.nax\/features\/[^/]+\/acceptance-refined\.json$/,
     /^.{2} \.nax-verifier-verdict\.json$/,
     /^.{2} \.nax-pids$/,
     /^.{2} \.nax-wt\//
@@ -31337,9 +31479,9 @@ async function checkGitignoreCoversNax(workdir) {
   const content = await file2.text();
   const patterns = [
     "nax.lock",
-    "nax/**/runs/",
-    "nax/metrics.json",
-    "nax/features/*/status.json",
+    ".nax/**/runs/",
+    ".nax/metrics.json",
+    ".nax/features/*/status.json",
     ".nax-pids",
     ".nax-wt/"
   ];
@@ -32188,12 +32330,20 @@ var init_crash_recovery = __esm(() => {
 var exports_acceptance_loop = {};
 __export(exports_acceptance_loop, {
   runAcceptanceLoop: () => runAcceptanceLoop,
+  isTestLevelFailure: () => isTestLevelFailure,
   isStubTestFile: () => isStubTestFile
 });
-import path14 from "path";
+import path14, { join as join45 } from "path";
 function isStubTestFile(content) {
   return /expect\s*\(\s*true\s*\)\s*\.\s*toBe\s*\(\s*(?:false|true)\s*\)/.test(content);
 }
+function isTestLevelFailure(failedACs, totalACs) {
+  if (failedACs.includes("AC-ERROR"))
+    return true;
+  if (totalACs === 0)
+    return false;
+  return failedACs.length / totalACs > 0.8;
+}
 async function loadSpecContent(featureDir) {
   if (!featureDir)
     return "";
@@ -32213,6 +32363,7 @@ async function generateAndAddFixStories(ctx, failures, prd) {
     return null;
   }
   const modelDef = resolveModel(ctx.config.models[ctx.config.analyze.model]);
+  const testFilePath = ctx.featureDir ? path14.join(ctx.featureDir, "acceptance.test.ts") : undefined;
   const fixStories = await generateFixStories(agent, {
     failedACs: failures.failedACs,
     testOutput: failures.testOutput,
@@ -32220,7 +32371,8 @@ async function generateAndAddFixStories(ctx, failures, prd) {
     specContent: await loadSpecContent(ctx.featureDir),
     workdir: ctx.workdir,
     modelDef,
-    config: ctx.config
+    config: ctx.config,
+    testFilePath
   });
   if (fixStories.length === 0) {
     logger?.error("acceptance", "Failed to generate fix stories");
@@ -32244,9 +32396,10 @@ async function executeFixStory(ctx, story, prd, iterations) {
     agent: ctx.config.autoMode.defaultAgent,
     iteration: iterations
   }), ctx.workdir);
+  const fixEffectiveConfig = story.workdir ? await loadConfigForWorkdir(join45(ctx.workdir, ".nax", "config.json"), story.workdir) : ctx.config;
   const fixContext = {
     config: ctx.config,
-    effectiveConfig: ctx.config,
+    effectiveConfig: fixEffectiveConfig,
     prd,
     story,
     stories: [story],
@@ -32266,6 +32419,23 @@ async function executeFixStory(ctx, story, prd, iterations) {
     metrics: result.context.storyMetrics
   };
 }
+async function regenerateAcceptanceTest(testPath, acceptanceContext) {
+  const logger = getSafeLogger();
+  const bakPath = `${testPath}.bak`;
+  const content = await Bun.file(testPath).text();
+  await Bun.write(bakPath, content);
+  logger?.info("acceptance", `Backed up acceptance test -> ${bakPath}`);
+  const { unlink: unlink3 } = await import("fs/promises");
+  await unlink3(testPath);
+  const { acceptanceSetupStage: acceptanceSetupStage2 } = await Promise.resolve().then(() => (init_acceptance_setup(), exports_acceptance_setup));
+  await acceptanceSetupStage2.execute(acceptanceContext);
+  if (!await Bun.file(testPath).exists()) {
+    logger?.error("acceptance", "Acceptance test regeneration failed \u2014 manual intervention required");
+    return false;
+  }
+  logger?.info("acceptance", "Acceptance test regenerated successfully");
+  return true;
+}
 async function runAcceptanceLoop(ctx) {
   const logger = getSafeLogger();
   const maxRetries = ctx.config.acceptance.maxRetries;
@@ -32343,9 +32513,23 @@ async function runAcceptanceLoop(ctx) {
             logger?.error("acceptance", "Acceptance test generation failed after retry \u2014 manual implementation required");
             return buildResult(false, prd, totalCost, iterations, storiesCompleted, prdDirty);
           }
+          continue;
         }
       }
     }
+    const totalACs = prd.userStories.filter((s) => !s.id.startsWith("US-FIX-")).flatMap((s) => s.acceptanceCriteria).length;
+    if (ctx.featureDir && isTestLevelFailure(failures.failedACs, totalACs)) {
+      logger?.warn("acceptance", `Test-level failure detected (${failures.failedACs.length}/${totalACs} ACs failed) \u2014 regenerating acceptance test`);
+      const testPath = path14.join(ctx.featureDir, "acceptance.test.ts");
+      const testFile = Bun.file(testPath);
+      if (await testFile.exists()) {
+        const regenerated = await regenerateAcceptanceTest(testPath, acceptanceContext);
+        if (!regenerated) {
+          return buildResult(false, prd, totalCost, iterations, storiesCompleted, prdDirty);
+        }
+        continue;
+      }
+    }
     logger?.info("acceptance", "Generating fix stories...");
     const fixStories = await generateAndAddFixStories(ctx, failures, prd);
     if (!fixStories) {
@@ -32376,6 +32560,7 @@ async function runAcceptanceLoop(ctx) {
 }
 var init_acceptance_loop = __esm(() => {
   init_acceptance();
+  init_loader2();
   init_schema();
   init_hooks();
   init_logger2();
@@ -32810,12 +32995,12 @@ __export(exports_manager, {
   WorktreeManager: () => WorktreeManager
 });
 import { existsSync as existsSync32, symlinkSync } from "fs";
-import { join as join45 } from "path";
+import { join as join46 } from "path";
 
 class WorktreeManager {
   async create(projectRoot, storyId) {
     validateStoryId(storyId);
-    const worktreePath = join45(projectRoot, ".nax-wt", storyId);
+    const worktreePath = join46(projectRoot, ".nax-wt", storyId);
     const branchName = `nax/${storyId}`;
     try {
       const proc = Bun.spawn(["git", "worktree", "add", worktreePath, "-b", branchName], {
@@ -32840,9 +33025,9 @@ class WorktreeManager {
       }
       throw new Error(`Failed to create worktree: ${String(error48)}`);
     }
-    const nodeModulesSource = join45(projectRoot, "node_modules");
+    const nodeModulesSource = join46(projectRoot, "node_modules");
     if (existsSync32(nodeModulesSource)) {
-      const nodeModulesTarget = join45(worktreePath, "node_modules");
+      const nodeModulesTarget = join46(worktreePath, "node_modules");
       try {
         symlinkSync(nodeModulesSource, nodeModulesTarget, "dir");
       } catch (error48) {
@@ -32850,9 +33035,9 @@ class WorktreeManager {
         throw new Error(`Failed to symlink node_modules: ${errorMessage(error48)}`);
       }
     }
-    const envSource = join45(projectRoot, ".env");
+    const envSource = join46(projectRoot, ".env");
     if (existsSync32(envSource)) {
-      const envTarget = join45(worktreePath, ".env");
+      const envTarget = join46(worktreePath, ".env");
       try {
         symlinkSync(envSource, envTarget, "file");
       } catch (error48) {
@@ -32863,7 +33048,7 @@ class WorktreeManager {
   }
   async remove(projectRoot, storyId) {
     validateStoryId(storyId);
-    const worktreePath = join45(projectRoot, ".nax-wt", storyId);
+    const worktreePath = join46(projectRoot, ".nax-wt", storyId);
     const branchName = `nax/${storyId}`;
     try {
       const proc = Bun.spawn(["git", "worktree", "remove", worktreePath, "--force"], {
@@ -33254,7 +33439,7 @@ var init_parallel_worker = __esm(() => {
 
 // src/execution/parallel-coordinator.ts
 import os3 from "os";
-import { join as join46 } from "path";
+import { join as join47 } from "path";
 function groupStoriesByDependencies(stories) {
   const batches = [];
   const processed = new Set;
@@ -33333,7 +33518,7 @@ async function executeParallel(stories, prdPath, projectRoot, config2, hooks, pl
     };
     const worktreePaths = new Map;
     for (const story of batch) {
-      const worktreePath = join46(projectRoot, ".nax-wt", story.id);
+      const worktreePath = join47(projectRoot, ".nax-wt", story.id);
       try {
         await worktreeManager.create(projectRoot, story.id);
         worktreePaths.set(story.id, worktreePath);
@@ -33382,7 +33567,7 @@ async function executeParallel(stories, prdPath, projectRoot, config2, hooks, pl
           });
           logger?.warn("parallel", "Worktree preserved for manual conflict resolution", {
             storyId: mergeResult.storyId,
-            worktreePath: join46(projectRoot, ".nax-wt", mergeResult.storyId)
+            worktreePath: join47(projectRoot, ".nax-wt", mergeResult.storyId)
           });
         }
       }
@@ -33842,12 +34027,12 @@ var init_parallel_executor = __esm(() => {
 // src/pipeline/subscribers/events-writer.ts
 import { appendFile as appendFile2, mkdir as mkdir2 } from "fs/promises";
 import { homedir as homedir7 } from "os";
-import { basename as basename5, join as join47 } from "path";
+import { basename as basename5, join as join48 } from "path";
 function wireEventsWriter(bus, feature, runId, workdir) {
   const logger = getSafeLogger();
   const project = basename5(workdir);
-  const eventsDir = join47(homedir7(), ".nax", "events", project);
-  const eventsFile = join47(eventsDir, "events.jsonl");
+  const eventsDir = join48(homedir7(), ".nax", "events", project);
+  const eventsFile = join48(eventsDir, "events.jsonl");
   let dirReady = false;
   const write = (line) => {
     (async () => {
@@ -34021,12 +34206,12 @@ var init_interaction2 = __esm(() => {
 // src/pipeline/subscribers/registry.ts
 import { mkdir as mkdir3, writeFile } from "fs/promises";
 import { homedir as homedir8 } from "os";
-import { basename as basename6, join as join48 } from "path";
+import { basename as basename6, join as join49 } from "path";
 function wireRegistry(bus, feature, runId, workdir) {
   const logger = getSafeLogger();
   const project = basename6(workdir);
-  const runDir = join48(homedir8(), ".nax", "runs", `${project}-${feature}-${runId}`);
-  const metaFile = join48(runDir, "meta.json");
+  const runDir = join49(homedir8(), ".nax", "runs", `${project}-${feature}-${runId}`);
+  const metaFile = join49(runDir, "meta.json");
   const unsub = bus.on("run:started", (_ev) => {
     (async () => {
       try {
@@ -34036,8 +34221,8 @@ function wireRegistry(bus, feature, runId, workdir) {
           project,
           feature,
           workdir,
-          statusPath: join48(workdir, "nax", "features", feature, "status.json"),
-          eventsDir: join48(workdir, "nax", "features", feature, "runs"),
+          statusPath: join49(workdir, ".nax", "features", feature, "status.json"),
+          eventsDir: join49(workdir, ".nax", "features", feature, "runs"),
           registeredAt: new Date().toISOString()
         };
         await writeFile(metaFile, JSON.stringify(meta3, null, 2));
@@ -34464,7 +34649,7 @@ async function handleTierEscalation(ctx) {
   }
   for (const s of storiesToEscalate) {
     const currentTestStrategy = s.routing?.testStrategy ?? ctx.routing.testStrategy;
-    const shouldSwitchToTestAfter = escalateRetryAsTestAfter && currentTestStrategy !== "test-after";
+    const shouldSwitchToTestAfter = escalateRetryAsTestAfter && currentTestStrategy !== "test-after" && currentTestStrategy !== "no-test";
     if (shouldSwitchToTestAfter) {
       logger?.warn("escalation", "Switching strategy to test-after (greenfield-no-tests fallback)", {
         storyId: s.id,
@@ -34488,7 +34673,7 @@ async function handleTierEscalation(ctx) {
       if (!shouldEscalate)
         return s;
       const currentTestStrategy = s.routing?.testStrategy ?? ctx.routing.testStrategy;
-      const shouldSwitchToTestAfter = escalateRetryAsTestAfter && currentTestStrategy !== "test-after";
+      const shouldSwitchToTestAfter = escalateRetryAsTestAfter && currentTestStrategy !== "test-after" && currentTestStrategy !== "no-test";
       const baseRouting = s.routing ?? { ...ctx.routing };
       const updatedRouting = {
         ...baseRouting,
@@ -34690,7 +34875,7 @@ var init_pipeline_result_handler = __esm(() => {
 });
 
 // src/execution/iteration-runner.ts
-import { join as join49 } from "path";
+import { join as join50 } from "path";
 async function runIteration(ctx, prd, selection, iterations, totalCost, allStoryMetrics) {
   const logger = getSafeLogger();
   const { story, storiesToExecute, routing, isBatchExecution } = selection;
@@ -34716,7 +34901,7 @@ async function runIteration(ctx, prd, selection, iterations, totalCost, allStory
   const storyStartTime = Date.now();
   const storyGitRef = await captureGitRef(ctx.workdir);
   const accumulatedAttemptCost = (story.priorFailures || []).reduce((sum, f) => sum + (f.cost || 0), 0);
-  const effectiveConfig = story.workdir ? await _iterationRunnerDeps.loadConfigForWorkdir(join49(ctx.workdir, "nax", "config.json"), story.workdir) : ctx.config;
+  const effectiveConfig = story.workdir ? await _iterationRunnerDeps.loadConfigForWorkdir(join50(ctx.workdir, ".nax", "config.json"), story.workdir) : ctx.config;
   const pipelineContext = {
     config: ctx.config,
     effectiveConfig,
@@ -35082,7 +35267,7 @@ async function writeStatusFile(filePath, status) {
 var init_status_file = () => {};
 
 // src/execution/status-writer.ts
-import { join as join50 } from "path";
+import { join as join51 } from "path";
 
 class StatusWriter {
   statusFile;
@@ -35150,7 +35335,7 @@ class StatusWriter {
     if (!this._prd)
       return;
     const safeLogger = getSafeLogger();
-    const featureStatusPath = join50(featureDir, "status.json");
+    const featureStatusPath = join51(featureDir, "status.json");
     try {
       const base = this.getSnapshot(totalCost, iterations);
       if (!base) {
@@ -35358,7 +35543,7 @@ __export(exports_run_initialization, {
   initializeRun: () => initializeRun,
   _reconcileDeps: () => _reconcileDeps
 });
-import { join as join51 } from "path";
+import { join as join52 } from "path";
 async function reconcileState(prd, prdPath, workdir, config2) {
   const logger = getSafeLogger();
   let reconciledCount = 0;
@@ -35370,7 +35555,7 @@ async function reconcileState(prd, prdPath, workdir, config2) {
     if (!hasCommits)
       continue;
     if (story.failureStage === "review" || story.failureStage === "autofix") {
-      const effectiveWorkdir = story.workdir ? join51(workdir, story.workdir) : workdir;
+      const effectiveWorkdir = story.workdir ? join52(workdir, story.workdir) : workdir;
       try {
         const reviewResult = await _reconcileDeps.runReview(config2.review, effectiveWorkdir, config2.execution);
         if (!reviewResult.success) {
@@ -35551,7 +35736,7 @@ async function setupRun(options) {
   }
   try {
     const globalPluginsDir = path18.join(os5.homedir(), ".nax", "plugins");
-    const projectPluginsDir = path18.join(workdir, "nax", "plugins");
+    const projectPluginsDir = path18.join(workdir, ".nax", "plugins");
     const configPlugins = config2.plugins || [];
     const pluginRegistry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir, config2.disabledPlugins);
     logger?.info("plugins", `Loaded ${pluginRegistry.plugins.length} plugins`, {
@@ -66504,7 +66689,7 @@ var require_jsx_dev_runtime = __commonJS((exports, module) => {
 init_source();
 import { existsSync as existsSync34, mkdirSync as mkdirSync6 } from "fs";
 import { homedir as homedir10 } from "os";
-import { join as join52 } from "path";
+import { join as join53 } from "path";
 
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
@@ -67200,7 +67385,7 @@ function formatMetadataSection(metadata) {
 // src/context/generators/aider.ts
 function generateAiderConfig(context) {
   const header = `# Aider Configuration
-# Auto-generated from nax/context.md \u2014 run \`nax generate\` to regenerate.
+# Auto-generated from .nax/context.md \u2014 run \`nax generate\` to regenerate.
 # DO NOT EDIT MANUALLY
 
 # Project instructions
@@ -67224,7 +67409,7 @@ var aiderGenerator = {
 function generateClaudeConfig(context) {
   const header = `# Project Context
 
-This file is auto-generated from \`nax/context.md\`.
+This file is auto-generated from \`.nax/context.md\`.
 DO NOT EDIT MANUALLY \u2014 run \`nax generate\` to regenerate.
 
 ---
@@ -67243,7 +67428,7 @@ var claudeGenerator = {
 function generateCodexConfig(context) {
   const header = `# Codex Instructions
 
-This file is auto-generated from \`nax/context.md\`.
+This file is auto-generated from \`.nax/context.md\`.
 DO NOT EDIT MANUALLY \u2014 run \`nax generate\` to regenerate.
 
 ---
@@ -67262,7 +67447,7 @@ var codexGenerator = {
 function generateCursorRules(context) {
   const header = `# Project Rules
 
-Auto-generated from nax/context.md \u2014 run \`nax generate\` to regenerate.
+Auto-generated from .nax/context.md \u2014 run \`nax generate\` to regenerate.
 DO NOT EDIT MANUALLY
 
 ---
@@ -67281,7 +67466,7 @@ var cursorGenerator = {
 function generateGeminiConfig(context) {
   const header = `# Gemini CLI Context
 
-This file is auto-generated from \`nax/context.md\`.
+This file is auto-generated from \`.nax/context.md\`.
 DO NOT EDIT MANUALLY \u2014 run \`nax generate\` to regenerate.
 
 ---
@@ -67300,7 +67485,7 @@ var geminiGenerator = {
 function generateOpencodeConfig(context) {
   const header = `# Agent Instructions
 
-This file is auto-generated from \`nax/context.md\`.
+This file is auto-generated from \`.nax/context.md\`.
 DO NOT EDIT MANUALLY \u2014 run \`nax generate\` to regenerate.
 
 These instructions apply to all AI coding agents in this project.
@@ -67321,7 +67506,7 @@ var opencodeGenerator = {
 function generateWindsurfRules(context) {
   const header = `# Windsurf Project Rules
 
-Auto-generated from nax/context.md \u2014 run \`nax generate\` to regenerate.
+Auto-generated from .nax/context.md \u2014 run \`nax generate\` to regenerate.
 DO NOT EDIT MANUALLY
 
 ---
@@ -67398,10 +67583,10 @@ async function generateAll(options, config2, agentFilter) {
 async function discoverPackages(repoRoot) {
   const packages = [];
   const seen = new Set;
-  for (const pattern of ["*/nax/context.md", "*/*/nax/context.md"]) {
+  for (const pattern of [".nax/mono/*/context.md", ".nax/mono/*/*/context.md"]) {
     const glob = new Bun.Glob(pattern);
-    for await (const match of glob.scan(repoRoot)) {
-      const pkgRelative = match.replace(/\/nax\/context\.md$/, "");
+    for await (const match of glob.scan({ cwd: repoRoot, dot: true })) {
+      const pkgRelative = match.replace(/^\.nax\/mono\//, "").replace(/\/context\.md$/, "");
       const pkgAbsolute = join11(repoRoot, pkgRelative);
       if (!seen.has(pkgAbsolute)) {
         seen.add(pkgAbsolute);
@@ -67479,7 +67664,7 @@ async function discoverWorkspacePackages(repoRoot) {
   return results.sort();
 }
 async function generateForPackage(packageDir, config2, dryRun = false) {
-  const contextPath = join11(packageDir, "nax", "context.md");
+  const contextPath = join11(packageDir, ".nax", "context.md");
   if (!existsSync10(contextPath)) {
     return [
       {
@@ -67596,6 +67781,13 @@ function validateStory(raw, index, allIds) {
   }
   const rawTestStrategy = routing.testStrategy ?? s.testStrategy;
   const testStrategy = resolveTestStrategy(typeof rawTestStrategy === "string" ? rawTestStrategy : undefined);
+  const rawJustification = routing.noTestJustification ?? s.noTestJustification;
+  if (testStrategy === "no-test") {
+    if (!rawJustification || typeof rawJustification !== "string" || rawJustification.trim() === "") {
+      throw new Error(`[schema] story[${index}].routing.noTestJustification is required when testStrategy is "no-test"`);
+    }
+  }
+  const noTestJustification = typeof rawJustification === "string" && rawJustification.trim() !== "" ? rawJustification.trim() : undefined;
   const rawDeps = s.dependencies;
   const dependencies = Array.isArray(rawDeps) ? rawDeps : [];
   for (const dep of dependencies) {
@@ -67635,7 +67827,8 @@ function validateStory(raw, index, allIds) {
     routing: {
       complexity,
       testStrategy,
-      reasoning: "validated from LLM output"
+      reasoning: "validated from LLM output",
+      ...noTestJustification !== undefined ? { noTestJustification } : {}
     },
     ...workdir !== undefined ? { workdir } : {},
     ...contextFiles.length > 0 ? { contextFiles } : {}
@@ -67702,9 +67895,9 @@ var _deps2 = {
   createInteractionBridge: () => createCliInteractionBridge()
 };
 async function planCommand(workdir, config2, options) {
-  const naxDir = join12(workdir, "nax");
+  const naxDir = join12(workdir, ".nax");
   if (!existsSync11(naxDir)) {
-    throw new Error(`nax directory not found. Run 'nax init' first in ${workdir}`);
+    throw new Error(`.nax directory not found. Run 'nax init' first in ${workdir}`);
   }
   const logger = getLogger();
   logger?.info("plan", "Reading spec", { from: options.from });
@@ -68000,7 +68193,8 @@ Generate a JSON object with this exact structure (no markdown, no explanation \u
       "passes": false,
       "routing": {
         "complexity": "simple | medium | complex | expert",
-        "testStrategy": "tdd-simple | three-session-tdd-lite | three-session-tdd | test-after",
+        "testStrategy": "no-test | tdd-simple | three-session-tdd-lite | three-session-tdd | test-after",
+        "noTestJustification": "string \u2014 REQUIRED when testStrategy is no-test, explains why tests are unnecessary",
         "reasoning": "string \u2014 brief classification rationale"
       },
       "escalations": [],
@@ -68038,7 +68232,7 @@ async function acceptCommand(options) {
     logger.error("cli", "Invalid project directory", { error: err.message });
     throw new NaxError("Invalid project directory", "INVALID_DIRECTORY", { error: err.message });
   }
-  const featureDir = path.join(projectDir, "nax", "features", feature);
+  const featureDir = path.join(projectDir, ".nax", "features", feature);
   const prdPath = path.join(featureDir, "prd.json");
   const prdFile = Bun.file(prdPath);
   if (!await prdFile.exists()) {
@@ -68174,29 +68368,29 @@ function resolveProject(options = {}) {
   let configPath;
   if (dir) {
     projectRoot = realpathSync3(resolve6(dir));
-    naxDir = join13(projectRoot, "nax");
+    naxDir = join13(projectRoot, ".nax");
     if (!existsSync12(naxDir)) {
       throw new NaxError(`Directory does not contain a nax project: ${projectRoot}
 Expected to find: ${naxDir}`, "NAX_DIR_NOT_FOUND", { projectRoot, naxDir });
     }
     configPath = join13(naxDir, "config.json");
     if (!existsSync12(configPath)) {
-      throw new NaxError(`nax directory found but config.json is missing: ${naxDir}
+      throw new NaxError(`.nax directory found but config.json is missing: ${naxDir}
 Expected to find: ${configPath}`, "CONFIG_NOT_FOUND", { naxDir, configPath });
     }
   } else {
     const found = findProjectRoot(process.cwd());
     if (!found) {
-      const cwdNaxDir = join13(process.cwd(), "nax");
+      const cwdNaxDir = join13(process.cwd(), ".nax");
       if (existsSync12(cwdNaxDir)) {
         const cwdConfigPath = join13(cwdNaxDir, "config.json");
-        throw new NaxError(`nax directory found but config.json is missing: ${cwdNaxDir}
+        throw new NaxError(`.nax directory found but config.json is missing: ${cwdNaxDir}
 Expected to find: ${cwdConfigPath}`, "CONFIG_NOT_FOUND", { naxDir: cwdNaxDir, configPath: cwdConfigPath });
       }
       throw new NaxError("No nax project found. Run this command from within a nax project directory, or use -d flag to specify the project path.", "PROJECT_NOT_FOUND", { cwd: process.cwd() });
     }
     projectRoot = found;
-    naxDir = join13(projectRoot, "nax");
+    naxDir = join13(projectRoot, ".nax");
     configPath = join13(naxDir, "config.json");
   }
   let featureDir;
@@ -68229,7 +68423,7 @@ function findProjectRoot(startDir) {
   let current = resolve6(startDir);
   let depth = 0;
   while (depth < MAX_DIRECTORY_DEPTH) {
-    const naxDir = join13(current, "nax");
+    const naxDir = join13(current, ".nax");
     const configPath = join13(naxDir, "config.json");
     if (existsSync12(configPath)) {
       return realpathSync3(current);
@@ -68268,7 +68462,7 @@ async function loadStatusFile(featureDir) {
   }
 }
 async function loadProjectStatusFile(projectDir) {
-  const statusPath = join15(projectDir, "nax", "status.json");
+  const statusPath = join15(projectDir, ".nax", "status.json");
   if (!existsSync13(statusPath)) {
     return null;
   }
@@ -68334,7 +68528,7 @@ async function getFeatureSummary(featureName, featureDir) {
   return summary;
 }
 async function displayAllFeatures(projectDir) {
-  const featuresDir = join15(projectDir, "nax", "features");
+  const featuresDir = join15(projectDir, ".nax", "features");
   if (!existsSync13(featuresDir)) {
     console.log(source_default.dim("No features found."));
     return;
@@ -68539,7 +68733,7 @@ async function parseRunLog(logPath) {
 async function runsListCommand(options) {
   const logger = getLogger();
   const { feature, workdir } = options;
-  const runsDir = join16(workdir, "nax", "features", feature, "runs");
+  const runsDir = join16(workdir, ".nax", "features", feature, "runs");
   if (!existsSync14(runsDir)) {
     logger.info("cli", "No runs found for feature", { feature, hint: `Directory not found: ${runsDir}` });
     return;
@@ -68577,7 +68771,7 @@ async function runsListCommand(options) {
 async function runsShowCommand(options) {
   const logger = getLogger();
   const { runId, feature, workdir } = options;
-  const logPath = join16(workdir, "nax", "features", feature, "runs", `${runId}.jsonl`);
+  const logPath = join16(workdir, ".nax", "features", feature, "runs", `${runId}.jsonl`);
   if (!existsSync14(logPath)) {
     logger.error("cli", "Run not found", { runId, feature, logPath });
     throw new NaxError("Run not found", "RUN_NOT_FOUND", { runId, feature, logPath });
@@ -68740,9 +68934,9 @@ ${ctx.contextMarkdown}`;
 async function promptsCommand(options) {
   const logger = getLogger();
   const { feature, workdir, config: config2, storyId, outputDir } = options;
-  const naxDir = join29(workdir, "nax");
+  const naxDir = join29(workdir, ".nax");
   if (!existsSync18(naxDir)) {
-    throw new Error(`nax directory not found. Run 'nax init' first in ${workdir}`);
+    throw new Error(`.nax directory not found. Run 'nax init' first in ${workdir}`);
   }
   const featureDir = join29(naxDir, "features", feature);
   const prdPath = join29(featureDir, "prd.json");
@@ -68854,13 +69048,13 @@ var TEMPLATE_HEADER = `<!--
     - Conventions (project coding standards)
 
   To activate overrides, add to your nax/config.json:
-    { "prompts": { "overrides": { "<role>": "nax/templates/<role>.md" } } }
+    { "prompts": { "overrides": { "<role>": ".nax/templates/<role>.md" } } }
 -->
 
 `;
 async function promptsInitCommand(options) {
   const { workdir, force = false, autoWireConfig = true } = options;
-  const templatesDir = join30(workdir, "nax", "templates");
+  const templatesDir = join30(workdir, ".nax", "templates");
   mkdirSync4(templatesDir, { recursive: true });
   const existingFiles = TEMPLATE_ROLES.map((t) => t.file).filter((f) => existsSync19(join30(templatesDir, f)));
   if (existingFiles.length > 0 && !force) {
@@ -68891,11 +69085,11 @@ async function autoWirePromptsConfig(workdir) {
     const exampleConfig = JSON.stringify({
       prompts: {
         overrides: {
-          "test-writer": "nax/templates/test-writer.md",
-          implementer: "nax/templates/implementer.md",
-          verifier: "nax/templates/verifier.md",
-          "single-session": "nax/templates/single-session.md",
-          "tdd-simple": "nax/templates/tdd-simple.md"
+          "test-writer": ".nax/templates/test-writer.md",
+          implementer: ".nax/templates/implementer.md",
+          verifier: ".nax/templates/verifier.md",
+          "single-session": ".nax/templates/single-session.md",
+          "tdd-simple": ".nax/templates/tdd-simple.md"
         }
       }
     }, null, 2);
@@ -68913,11 +69107,11 @@ ${exampleConfig}`);
     return;
   }
   const overrides = {
-    "test-writer": "nax/templates/test-writer.md",
-    implementer: "nax/templates/implementer.md",
-    verifier: "nax/templates/verifier.md",
-    "single-session": "nax/templates/single-session.md",
-    "tdd-simple": "nax/templates/tdd-simple.md"
+    "test-writer": ".nax/templates/test-writer.md",
+    implementer: ".nax/templates/implementer.md",
+    verifier: ".nax/templates/verifier.md",
+    "single-session": ".nax/templates/single-session.md",
+    "tdd-simple": ".nax/templates/tdd-simple.md"
   };
   if (!config2.prompts) {
     config2.prompts = {};
@@ -68989,7 +69183,7 @@ import * as os2 from "os";
 import * as path13 from "path";
 async function pluginsListCommand(config2, workdir, overrideGlobalPluginsDir) {
   const globalPluginsDir = overrideGlobalPluginsDir ?? path13.join(os2.homedir(), ".nax", "plugins");
-  const projectPluginsDir = path13.join(workdir, "nax", "plugins");
+  const projectPluginsDir = path13.join(workdir, ".nax", "plugins");
   const configPlugins = config2.plugins || [];
   const registry2 = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir, config2.disabledPlugins);
   const plugins = registry2.plugins;
@@ -68998,8 +69192,8 @@ async function pluginsListCommand(config2, workdir, overrideGlobalPluginsDir) {
     console.log(`
 To install plugins:`);
     console.log("  \u2022 Add to global directory: ~/.nax/plugins/");
-    console.log("  \u2022 Add to project directory: ./nax/plugins/");
-    console.log("  \u2022 Configure in nax/config.json");
+    console.log("  \u2022 Add to project directory: ./.nax/plugins/");
+    console.log("  \u2022 Configure in .nax/config.json");
     console.log(`
 See https://github.com/nax/nax#plugins for more details.`);
     return;
@@ -69250,7 +69444,7 @@ function isProcessAlive2(pid) {
   }
 }
 async function loadStatusFile2(workdir) {
-  const statusPath = join34(workdir, "nax", "status.json");
+  const statusPath = join34(workdir, ".nax", "status.json");
   if (!existsSync21(statusPath))
     return null;
   try {
@@ -69297,7 +69491,7 @@ async function diagnoseCommand(options = {}) {
   const workdir = options.workdir ?? process.cwd();
   const naxSubdir = findProjectDir(workdir);
   let projectDir = naxSubdir ? join34(naxSubdir, "..") : null;
-  if (!projectDir && existsSync21(join34(workdir, "nax"))) {
+  if (!projectDir && existsSync21(join34(workdir, ".nax"))) {
     projectDir = workdir;
   }
   if (!projectDir)
@@ -69308,7 +69502,7 @@ async function diagnoseCommand(options = {}) {
     if (status2) {
       feature = status2.run.feature;
     } else {
-      const featuresDir = join34(projectDir, "nax", "features");
+      const featuresDir = join34(projectDir, ".nax", "features");
       if (!existsSync21(featuresDir))
         throw new Error("No features found in project");
       const features = readdirSync5(featuresDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
@@ -69318,7 +69512,7 @@ async function diagnoseCommand(options = {}) {
       logger.info("diagnose", "No feature specified, using first found", { feature });
     }
   }
-  const featureDir = join34(projectDir, "nax", "features", feature);
+  const featureDir = join34(projectDir, ".nax", "features", feature);
   const prdPath = join34(featureDir, "prd.json");
   if (!existsSync21(prdPath))
     throw new Error(`Feature not found: ${feature}`);
@@ -69377,10 +69571,10 @@ async function generateCommand(options) {
     if (dryRun) {
       console.log(source_default.yellow("\u26A0 Dry run \u2014 no files will be written"));
     }
-    console.log(source_default.blue("\u2192 Discovering packages with nax/context.md..."));
+    console.log(source_default.blue("\u2192 Discovering packages with .nax/mono/*/context.md..."));
     const packages = await discoverPackages(workdir);
     if (packages.length === 0) {
-      console.log(source_default.yellow("  No packages found (no */nax/context.md or */*/nax/context.md)"));
+      console.log(source_default.yellow("  No packages found (no .nax/mono/*/context.md or .nax/mono/*/*/context.md)"));
       return;
     }
     console.log(source_default.blue(`\u2192 Generating agent files for ${packages.length} package(s)...`));
@@ -69425,12 +69619,12 @@ async function generateCommand(options) {
       process.exit(1);
     return;
   }
-  const contextPath = options.context ? join35(workdir, options.context) : join35(workdir, "nax/context.md");
+  const contextPath = options.context ? join35(workdir, options.context) : join35(workdir, ".nax/context.md");
   const outputDir = options.output ? join35(workdir, options.output) : workdir;
   const autoInject = !options.noAutoInject;
   if (!existsSync22(contextPath)) {
     console.error(source_default.red(`\u2717 Context file not found: ${contextPath}`));
-    console.error(source_default.yellow("  Create nax/context.md first, or run `nax init` to scaffold it."));
+    console.error(source_default.yellow("  Create .nax/context.md first, or run `nax init` to scaffold it."));
     process.exit(1);
   }
   if (options.agent && !VALID_AGENTS.includes(options.agent)) {
@@ -69496,7 +69690,7 @@ async function generateCommand(options) {
       const packages = await discoverPackages(workdir);
       if (packages.length > 0) {
         console.log(source_default.blue(`
-\u2192 Discovered ${packages.length} package(s) with nax/context.md \u2014 generating agent files...`));
+\u2192 Discovered ${packages.length} package(s) with context.md \u2014 generating agent files...`));
         let pkgErrorCount = 0;
         for (const pkgDir of packages) {
           const pkgResults = await generateForPackage(pkgDir, config2, dryRun);
@@ -70272,7 +70466,7 @@ async function logsCommand(options) {
     return;
   }
   const resolved = resolveProject({ dir: options.dir });
-  const naxDir = join40(resolved.projectDir, "nax");
+  const naxDir = join40(resolved.projectDir, ".nax");
   const configPath = resolved.configPath;
   const configFile = Bun.file(configPath);
   const config2 = await configFile.json();
@@ -70322,7 +70516,7 @@ async function precheckCommand(options) {
       process.exit(1);
     }
   }
-  const naxDir = join41(resolved.projectDir, "nax");
+  const naxDir = join41(resolved.projectDir, ".nax");
   const featureDir = join41(naxDir, "features", featureName);
   const prdPath = join41(featureDir, "prd.json");
   if (!existsSync31(featureDir)) {
@@ -70638,7 +70832,14 @@ function precomputeBatchPlan(stories, maxBatchSize = DEFAULT_MAX_BATCH_SIZE) {
   let currentBatch = [];
   for (const story of stories) {
     const isSimple = story.routing?.complexity === "simple" && story.routing?.testStrategy === "test-after";
-    if (isSimple && currentBatch.length < maxBatchSize) {
+    const isNoTest = story.routing?.testStrategy === "no-test";
+    const isBatchable = isSimple || isNoTest;
+    if (isBatchable && currentBatch.length < maxBatchSize) {
+      const batchIsNoTest = currentBatch.length > 0 && currentBatch[0]?.routing?.testStrategy === "no-test";
+      if (currentBatch.length > 0 && batchIsNoTest !== isNoTest) {
+        batches.push({ stories: [...currentBatch], isBatch: currentBatch.length > 1 });
+        currentBatch = [];
+      }
       currentBatch.push(story);
     } else {
       if (currentBatch.length > 0) {
@@ -70648,11 +70849,8 @@ function precomputeBatchPlan(stories, maxBatchSize = DEFAULT_MAX_BATCH_SIZE) {
         });
         currentBatch = [];
       }
-      if (!isSimple) {
-        batches.push({
-          stories: [story],
-          isBatch: false
-        });
+      if (!isBatchable) {
+        batches.push({ stories: [story], isBatch: false });
       } else {
         currentBatch.push(story);
       }
@@ -78331,15 +78529,15 @@ Next: nax generate --package ${options.package}`));
     }
     return;
   }
-  const naxDir = join52(workdir, "nax");
+  const naxDir = join53(workdir, "nax");
   if (existsSync34(naxDir) && !options.force) {
     console.log(source_default.yellow("nax already initialized. Use --force to overwrite."));
     return;
   }
-  mkdirSync6(join52(naxDir, "features"), { recursive: true });
-  mkdirSync6(join52(naxDir, "hooks"), { recursive: true });
-  await Bun.write(join52(naxDir, "config.json"), JSON.stringify(DEFAULT_CONFIG, null, 2));
-  await Bun.write(join52(naxDir, "hooks.json"), JSON.stringify({
+  mkdirSync6(join53(naxDir, "features"), { recursive: true });
+  mkdirSync6(join53(naxDir, "hooks"), { recursive: true });
+  await Bun.write(join53(naxDir, "config.json"), JSON.stringify(DEFAULT_CONFIG, null, 2));
+  await Bun.write(join53(naxDir, "hooks.json"), JSON.stringify({
     hooks: {
       "on-start": { command: 'echo "nax started: $NAX_FEATURE"', enabled: false },
       "on-complete": { command: 'echo "nax complete: $NAX_FEATURE"', enabled: false },
@@ -78347,12 +78545,12 @@ Next: nax generate --package ${options.package}`));
       "on-error": { command: 'echo "nax error: $NAX_REASON"', enabled: false }
     }
   }, null, 2));
-  await Bun.write(join52(naxDir, ".gitignore"), `# nax temp files
+  await Bun.write(join53(naxDir, ".gitignore"), `# nax temp files
 *.tmp
 .paused.json
 .nax-verifier-verdict.json
 `);
-  await Bun.write(join52(naxDir, "context.md"), `# Project Context
+  await Bun.write(join53(naxDir, "context.md"), `# Project Context
 
 This document defines coding standards, architectural decisions, and forbidden patterns for this project.
 Run \`nax generate\` to regenerate agent config files (CLAUDE.md, AGENTS.md, .cursorrules, etc.) from this file.
@@ -78478,8 +78676,8 @@ program2.command("run").description("Run the orchestration loop for a feature").
     console.error(source_default.red("nax not initialized. Run: nax init"));
     process.exit(1);
   }
-  const featureDir = join52(naxDir, "features", options.feature);
-  const prdPath = join52(featureDir, "prd.json");
+  const featureDir = join53(naxDir, "features", options.feature);
+  const prdPath = join53(featureDir, "prd.json");
   if (options.plan && options.from) {
     if (existsSync34(prdPath) && !options.force) {
       console.error(source_default.red(`Error: prd.json already exists for feature "${options.feature}".`));
@@ -78501,10 +78699,10 @@ program2.command("run").description("Run the orchestration loop for a feature").
       }
     }
     try {
-      const planLogDir = join52(featureDir, "plan");
+      const planLogDir = join53(featureDir, "plan");
       mkdirSync6(planLogDir, { recursive: true });
       const planLogId = new Date().toISOString().replace(/:/g, "-").replace(/\..+/, "");
-      const planLogPath = join52(planLogDir, `${planLogId}.jsonl`);
+      const planLogPath = join53(planLogDir, `${planLogId}.jsonl`);
       initLogger({ level: "info", filePath: planLogPath, useChalk: false, headless: true });
       console.log(source_default.dim(`   [Plan log: ${planLogPath}]`));
       console.log(source_default.dim("   [Planning phase: generating PRD from spec]"));
@@ -78542,10 +78740,10 @@ program2.command("run").description("Run the orchestration loop for a feature").
     process.exit(1);
   }
   resetLogger();
-  const runsDir = join52(featureDir, "runs");
+  const runsDir = join53(featureDir, "runs");
   mkdirSync6(runsDir, { recursive: true });
   const runId = new Date().toISOString().replace(/:/g, "-").replace(/\..+/, "");
-  const logFilePath = join52(runsDir, `${runId}.jsonl`);
+  const logFilePath = join53(runsDir, `${runId}.jsonl`);
   const isTTY = process.stdout.isTTY ?? false;
   const headlessFlag = options.headless ?? false;
   const headlessEnv = process.env.NAX_HEADLESS === "1";
@@ -78561,7 +78759,7 @@ program2.command("run").description("Run the orchestration loop for a feature").
     config2.autoMode.defaultAgent = options.agent;
   }
   config2.execution.maxIterations = Number.parseInt(options.maxIterations, 10);
-  const globalNaxDir = join52(homedir10(), ".nax");
+  const globalNaxDir = join53(homedir10(), ".nax");
   const hooks = await loadHooksConfig(naxDir, globalNaxDir);
   const eventEmitter = new PipelineEventEmitter;
   let tuiInstance;
@@ -78584,7 +78782,7 @@ program2.command("run").description("Run the orchestration loop for a feature").
   } else {
     console.log(source_default.dim("   [Headless mode \u2014 pipe output]"));
   }
-  const statusFilePath = join52(workdir, "nax", "status.json");
+  const statusFilePath = join53(workdir, "nax", "status.json");
   let parallel;
   if (options.parallel !== undefined) {
     parallel = Number.parseInt(options.parallel, 10);
@@ -78610,7 +78808,7 @@ program2.command("run").description("Run the orchestration loop for a feature").
     headless: useHeadless,
     skipPrecheck: options.skipPrecheck ?? false
   });
-  const latestSymlink = join52(runsDir, "latest.jsonl");
+  const latestSymlink = join53(runsDir, "latest.jsonl");
   try {
     if (existsSync34(latestSymlink)) {
       Bun.spawnSync(["rm", latestSymlink]);
@@ -78648,34 +78846,42 @@ features.command("create <name>").description("Create a new feature").option("-d
     console.error(source_default.red("nax not initialized. Run: nax init"));
     process.exit(1);
   }
-  const featureDir = join52(naxDir, "features", name);
+  const featureDir = join53(naxDir, "features", name);
   mkdirSync6(featureDir, { recursive: true });
-  await Bun.write(join52(featureDir, "spec.md"), `# Feature: ${name}
+  await Bun.write(join53(featureDir, "spec.md"), `# Feature: ${name}
 
 ## Overview
 
-## Requirements
+<!-- One paragraph describing what this feature does and why it's needed. -->
 
-## Acceptance Criteria
-`);
-  await Bun.write(join52(featureDir, "plan.md"), `# Plan: ${name}
+## Background / Context
 
-## Architecture
+<!-- Optional: relevant background, existing behaviour, or constraints. -->
 
-## Phases
+## User Stories
 
-## Dependencies
-`);
-  await Bun.write(join52(featureDir, "tasks.md"), `# Tasks: ${name}
+<!-- Describe what users need. Each story becomes a unit of work for nax.
+     Be specific \u2014 the more detail here, the better the generated plan. -->
 
-## US-001: [Title]
+- As a [user], I want to [goal] so that [benefit].
 
-### Description
+## Technical Requirements
 
-### Acceptance Criteria
-- [ ] Criterion 1
+<!-- Optional: specific technical constraints, patterns to follow, APIs to use, etc. -->
+
+## Acceptance Criteria
+
+<!-- These are parsed by nax to generate acceptance tests.
+     Use clear, testable statements. Each criterion = one AC test. -->
+
+- [ ] [Describe observable outcome 1]
+- [ ] [Describe observable outcome 2]
+
+## Out of Scope
+
+<!-- What this feature explicitly does NOT cover. -->
 `);
-  await Bun.write(join52(featureDir, "progress.txt"), `# Progress: ${name}
+  await Bun.write(join53(featureDir, "progress.txt"), `# Progress: ${name}
 
 Created: ${new Date().toISOString()}
 
@@ -78684,11 +78890,9 @@ Created: ${new Date().toISOString()}
   console.log(source_default.green(`\u2705 Created feature: ${name}`));
   console.log(source_default.dim(`   ${featureDir}/`));
   console.log(source_default.dim("   \u251C\u2500\u2500 spec.md"));
-  console.log(source_default.dim("   \u251C\u2500\u2500 plan.md"));
-  console.log(source_default.dim("   \u251C\u2500\u2500 tasks.md"));
   console.log(source_default.dim("   \u2514\u2500\u2500 progress.txt"));
   console.log(source_default.dim(`
-Next: Edit spec.md and tasks.md, then: nax plan -f ${name} --from spec.md --auto`));
+Next: Edit spec.md, then: nax plan -f ${name} --from spec.md --auto`));
 });
 features.command("list").description("List all features").option("-d, --dir <path>", "Project directory", process.cwd()).action(async (options) => {
   let workdir;
@@ -78703,7 +78907,7 @@ features.command("list").description("List all features").option("-d, --dir <pat
     console.error(source_default.red("nax not initialized."));
     process.exit(1);
   }
-  const featuresDir = join52(naxDir, "features");
+  const featuresDir = join53(naxDir, "features");
   if (!existsSync34(featuresDir)) {
     console.log(source_default.dim("No features yet."));
     return;
@@ -78718,7 +78922,7 @@ features.command("list").description("List all features").option("-d, --dir <pat
 Features:
 `));
   for (const name of entries) {
-    const prdPath = join52(featuresDir, name, "prd.json");
+    const prdPath = join53(featuresDir, name, "prd.json");
     if (existsSync34(prdPath)) {
       const prd = await loadPRD(prdPath);
       const c = countStories(prd);
@@ -78749,10 +78953,10 @@ Use: nax plan -f <feature> --from <spec>`));
     process.exit(1);
   }
   const config2 = await loadConfig(workdir);
-  const featureLogDir = join52(naxDir, "features", options.feature, "plan");
+  const featureLogDir = join53(naxDir, "features", options.feature, "plan");
   mkdirSync6(featureLogDir, { recursive: true });
   const planLogId = new Date().toISOString().replace(/:/g, "-").replace(/\..+/, "");
-  const planLogPath = join52(featureLogDir, `${planLogId}.jsonl`);
+  const planLogPath = join53(featureLogDir, `${planLogId}.jsonl`);
   initLogger({ level: "info", filePath: planLogPath, useChalk: false, headless: true });
   console.log(source_default.dim(`   [Plan log: ${planLogPath}]`));
   try {
@@ -78789,7 +78993,7 @@ program2.command("analyze").description("(deprecated) Parse spec.md into prd.jso
     console.error(source_default.red("nax not initialized. Run: nax init"));
     process.exit(1);
   }
-  const featureDir = join52(naxDir, "features", options.feature);
+  const featureDir = join53(naxDir, "features", options.feature);
   if (!existsSync34(featureDir)) {
     console.error(source_default.red(`Feature "${options.feature}" not found.`));
     process.exit(1);
@@ -78805,7 +79009,7 @@ program2.command("analyze").description("(deprecated) Parse spec.md into prd.jso
       specPath: options.from,
       reclassify: options.reclassify
     });
-    const prdPath = join52(featureDir, "prd.json");
+    const prdPath = join53(featureDir, "prd.json");
     await Bun.write(prdPath, JSON.stringify(prd, null, 2));
     const c = countStories(prd);
     console.log(source_default.green(`