@nathapp/nax 0.36.1 → 0.37.0

package/README.md

@@ -317,6 +317,25 @@ If `testScoped` is not configured, nax falls back to a heuristic that replaces t
 
 ---
 
+## Customization
+
+### Prompt Customization
+
+Customize the instructions sent to each agent role for your project's specific needs. Override prompts to enforce coding style, domain knowledge, or architectural constraints.
+
+**Quick start:**
+
+```bash
+nax prompts --init              # Create default templates
+# Edit nax/templates/*.md
+nax prompts --export test-writer # Preview a role's prompt
+nax run -f my-feature           # Uses your custom prompts
+```
+
+**Full guide:** See [Prompt Customization Guide](docs/prompt-customization.md) for detailed instructions, role reference, and best practices.
+
+---
+
 ## Test Strategies
 
 nax selects a test strategy per story based on complexity and tags:

package/bin/nax.ts

@@ -51,6 +51,7 @@ import {
   displayFeatureStatus,
   displayLastRunMetrics,
   displayModelEfficiency,
+  exportPromptCommand,
   planCommand,
   pluginsListCommand,
   promptsCommand,
@@ -191,13 +192,31 @@ Run \`nax generate\` to regenerate agent config files (CLAUDE.md, AGENTS.md, .cu
 `,
     );
 
+    // Initialize prompt templates (final step, don't auto-wire config)
+    try {
+      await promptsInitCommand({
+        workdir,
+        force: options.force,
+        autoWireConfig: false,
+      });
+    } catch (err) {
+      console.error(chalk.red(`Failed to initialize templates: ${(err as Error).message}`));
+      process.exit(1);
+    }
+
     console.log(chalk.green("✅ Initialized nax"));
     console.log(chalk.dim(`   ${naxDir}/`));
     console.log(chalk.dim("   ├── config.json"));
     console.log(chalk.dim("   ├── context.md"));
     console.log(chalk.dim("   ├── hooks.json"));
     console.log(chalk.dim("   ├── features/"));
-    console.log(chalk.dim("   └── hooks/"));
+    console.log(chalk.dim("   ├── hooks/"));
+    console.log(chalk.dim("   └── templates/"));
+    console.log(chalk.dim("       ├── test-writer.md"));
+    console.log(chalk.dim("       ├── implementer.md"));
+    console.log(chalk.dim("       ├── verifier.md"));
+    console.log(chalk.dim("       ├── single-session.md"));
+    console.log(chalk.dim("       └── tdd-simple.md"));
     console.log(chalk.dim("\nNext: nax features create <name>"));
   });
 
@@ -860,11 +879,12 @@ program
 program
   .command("prompts")
   .description("Assemble or initialize prompts")
-  .option("-f, --feature <name>", "Feature name (required unless using --init)")
+  .option("-f, --feature <name>", "Feature name (required unless using --init or --export)")
   .option("--init", "Initialize default prompt templates", false)
+  .option("--export <role>", "Export default prompt for a role to stdout or --out file")
   .option("--force", "Overwrite existing template files", false)
   .option("--story <id>", "Filter to a single story ID (e.g., US-003)")
-  .option("--out <dir>", "Output directory for prompt files (default: stdout)")
+  .option("--out <path>", "Output file path for --export, or directory for regular prompts (default: stdout)")
   .option("-d, --dir <path>", "Project directory", process.cwd())
   .action(async (options) => {
     // Validate directory path
@@ -890,9 +910,23 @@ program
       return;
     }
 
+    // Handle --export command
+    if (options.export) {
+      try {
+        await exportPromptCommand({
+          role: options.export,
+          out: options.out,
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${(err as Error).message}`));
+        process.exit(1);
+      }
+      return;
+    }
+
     // Handle regular prompts command (requires --feature)
     if (!options.feature) {
-      console.error(chalk.red("Error: --feature is required (unless using --init)"));
+      console.error(chalk.red("Error: --feature is required (unless using --init or --export)"));
       process.exit(1);
     }