claude-code-modes 0.3.4 → 0.4.1

package/README.md

@@ -150,7 +150,7 @@ prompts/
   modifiers/    Behavioral layers (bold, debug, methodical, director, readonly, context-pacing, speak-plain, tdd, muse, flow, playful)
 ```
 
-Each base has a `base.json` manifest — a flat JSON array declaring fragment order with `"axes"` and `"modifiers"` as reserved insertion points. The standard base is validated against Claude Code **v2.1.197**.
+Each base has a `base.json` manifest — a flat JSON array declaring fragment order with `"axes"` and `"modifiers"` as reserved insertion points. The standard base is validated against Claude Code **v2.1.217**.
 
 The behavioral layer is composed from three independent axes — **agency** (how much initiative), **quality** (what code standard), and **scope** (how far beyond the request). Presets are just named combinations of these three values.
 
@@ -198,9 +198,12 @@ claude-mode create --append-system-prompt "Use Rust, not TypeScript"
 Pass flags through to Claude Code:
 
 ```bash
-claude-mode create -- --verbose --model sonnet
+claude-mode create --model sonnet          # model choice also lands in the prompt's environment info
+claude-mode create -- --verbose            # anything after -- goes to claude verbatim
 ```
 
+The environment section of the assembled prompt reports the model claude will actually run: from `--model` (before or after `--`), else the `ANTHROPIC_MODEL` env var, else Claude settings files (`.claude/settings.local.json`, `.claude/settings.json`, `~/.claude/settings.json`), else the newest known model.
+
 Debug the assembled prompt:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-modes",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "description": "Behaviorally-tuned system prompts for Claude Code",
   "license": "MIT",
   "type": "module",

package/prompts/base/actions.md

@@ -8,4 +8,4 @@ Examples of the kind of risky actions that warrant user confirmation:
 - Actions visible to others or that affect shared state: pushing code, creating/closing/commenting on PRs or issues, sending messages (Slack, email, GitHub), posting to external services, modifying shared infrastructure or permissions
 - Uploading content to third-party web tools (diagram renderers, pastebins, gists) publishes it - consider whether it could be sensitive before sending, since it may be cached or indexed even if later deleted.
 
-When you encounter an obstacle, do not use destructive actions as a shortcut to simply make it go away. For instance, try to identify root causes and fix underlying issues rather than bypassing safety checks (e.g. --no-verify). If you discover unexpected state like unfamiliar files, branches, or configuration, investigate before deleting or overwriting, as it may represent the user's in-progress work. For example, typically resolve merge conflicts rather than discarding changes; similarly, if a lock file exists, investigate what process holds it rather than deleting it. In short: only take risky actions carefully, and when in doubt, ask before acting. Follow both the spirit and letter of these instructions - measure twice, cut once.
+When you encounter an obstacle, do not use destructive actions as a shortcut to simply make it go away. For instance, try to identify root causes and fix underlying issues rather than bypassing safety checks (e.g. --no-verify). If you discover unexpected state like unfamiliar files, branches, or configuration, investigate before deleting or overwriting, as it may represent the user's in-progress work. If you're unsure whether the user would want something kept, prefer a reversible step (move it aside, rename it, or stash it) over deleting; files you created yourself this session (scratch outputs, experiment intermediates) are yours to clean up freely. For example, typically resolve merge conflicts rather than discarding changes; similarly, if a lock file exists, investigate what process holds it rather than deleting it. In a git repository, run `git status` before any command that could discard uncommitted work (git checkout/restore/reset/clean, rm -rf on a repo path, restoring from a snapshot), and stash (with `-u` for untracked) or commit anything you find first. And when staging or committing: review what's included (`git status` after a broad `git add`), and if you see anything suspicious that might reveal secrets — even if the filename looks innocuous — double-check the file's contents before pushing. In short: only take risky actions carefully, and when in doubt, ask before acting. Follow both the spirit and letter of these instructions - measure twice, cut once.

package/prompts/style/declaudified.md

@@ -0,0 +1,16 @@
+# Style: Declaudified
+
+How to write everything the user reads — answers, summaries, explanations, commit messages, docs.
+
+- Lead with the answer. State the point first, then support it.
+- Cut filler and metadiscourse — language that narrates the communicating instead of communicating: "let me lay out," "it's worth noting," "as mentioned above." Say the thing; don't say you're about to say it.
+- Delete your opening sentence. The real first sentence is usually the second or third — cut the runway that sets up the answer instead of giving it.
+- Do add relevant surrounding context that hasn't already been established in the conversation — don't assume the user has perfect repo or domain knowledge. Adding context they lack is welcome; restating what they just told you is not.
+- Don't signpost structure. A list or table is self-evident; don't preface it with "here's a table of."
+- Plain language: real names for real things, minimal jargon, no padding adjectives. Use real terminology; don't invent labels ("status," not "milestones").
+- Drop dead tech-metaphors and stock phrases ("ship," "load-bearing," "first-class," "surface" as a verb, "seamless," "leverage," "robust"). Use the plain word or cut it; keep "ship" only for releasing software (else deliver / finish / send / hand off).
+- Don't state a cause without evidence — label speculation or leave it out.
+
+In short: say the thing; don't say you're about to say it, and don't say you understood the question.
+
+References: George Orwell, "Politics and the English Language" (his plain-English rules); Strunk & White, *The Elements of Style* ("omit needless words"); Joseph Williams, *Style: Toward Clarity and Grace* (on cutting metadiscourse).

package/src/args.ts

@@ -3,6 +3,7 @@ import { parseArgs } from "node:util";
 export interface ParsedArgs {
   base?: string;
   preset: string | null;
+  style?: string;
   overrides: {
     agency?: string;
     quality?: string;
@@ -17,10 +18,22 @@ export interface ParsedArgs {
   forwarded: {
     appendSystemPrompt?: string;
     appendSystemPromptFile?: string;
+    model?: string;
   };
+  /** Model claude will run — from --model, or peeked from after `--`; drives env detection */
+  modelHint: string | null;
   passthroughArgs: string[];
 }
 
+// After `--` everything is passed verbatim, but the model choice still shapes
+// the environment section — peek without disturbing the passthrough list
+function peekModelAfterDashDash(args: string[]): string | null {
+  const flagIdx = args.indexOf("--model");
+  if (flagIdx >= 0 && flagIdx + 1 < args.length) return args[flagIdx + 1];
+  const inline = args.find((arg) => arg.startsWith("--model="));
+  return inline ? inline.slice("--model=".length) : null;
+}
+
 export function parseCliArgs(argv: string[]): ParsedArgs {
   // Split at -- separator
   const dashDashIdx = argv.indexOf("--");
@@ -34,12 +47,14 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
       agency: { type: "string" },
       quality: { type: "string" },
       scope: { type: "string" },
+      style: { type: "string" },
       modifier: { type: "string", multiple: true },
       readonly: { type: "boolean" },
       print: { type: "boolean" },
       "context-pacing": { type: "boolean" },
       "append-system-prompt": { type: "string" },
       "append-system-prompt-file": { type: "string" },
+      model: { type: "string" },
       "system-prompt": { type: "string" },
       "system-prompt-file": { type: "string" },
       help: { type: "boolean" },
@@ -78,8 +93,8 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
 
   // Collect unknown flags for passthrough
   const knownFlags = new Set([
-    "base", "agency", "quality", "scope", "modifier", "readonly", "print", "context-pacing",
-    "append-system-prompt", "append-system-prompt-file",
+    "base", "agency", "quality", "scope", "style", "modifier", "readonly", "print", "context-pacing",
+    "append-system-prompt", "append-system-prompt-file", "model",
     "system-prompt", "system-prompt-file", "help", "version",
   ]);
   const unknownPassthrough: string[] = [];
@@ -102,6 +117,7 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
   return {
     base: values.base as string | undefined,
     preset,
+    style: values.style as string | undefined,
     overrides,
     modifiers: {
       readonly: values.readonly === true,
@@ -112,7 +128,9 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
     forwarded: {
       appendSystemPrompt: values["append-system-prompt"] as string | undefined,
       appendSystemPromptFile: values["append-system-prompt-file"] as string | undefined,
+      model: values.model as string | undefined,
     },
+    modelHint: (values.model as string | undefined) ?? peekModelAfterDashDash(afterDashDash),
     passthroughArgs,
   };
 }

package/src/assemble.ts

@@ -116,6 +116,15 @@ export function getFragmentOrder(mode: ModeConfig, promptsDir: string): string[]
           }
         }
       }
+      // Style fragment rides the axes insertion point but applies even in
+      // none mode — an explicit --style is honored like explicit modifiers
+      if (mode.style) {
+        if (isAbsolute(mode.style)) {
+          fragments.push(mode.style);
+        } else {
+          fragments.push(`style/${mode.style}.md`);
+        }
+      }
     } else if (entry === "modifiers") {
       // All modifiers are fragment paths — just add them
       for (const modPath of mode.modifiers) {

package/src/build-info.ts

@@ -12,6 +12,6 @@ export interface BuildInfo {
 export const BUILD_INFO: BuildInfo = {
   "repo": "https://github.com/nklisch/claude-code-modes",
   "branch": null,
-  "commit": "370493c",
+  "commit": "6303b59",
   "dirty": false
 };

package/src/build-prompt.ts

@@ -98,7 +98,7 @@ function main(): void {
   }
 
   // Detect environment and build template vars
-  const env = detectEnv();
+  const env = detectEnv(parsed.modelHint);
   const templateVars = buildTemplateVars(env);
 
   // Assemble the prompt
@@ -127,6 +127,9 @@ function main(): void {
   if (parsed.forwarded.appendSystemPromptFile) {
     claudeArgs.push("--append-system-prompt-file", parsed.forwarded.appendSystemPromptFile);
   }
+  if (parsed.forwarded.model) {
+    claudeArgs.push("--model", parsed.forwarded.model);
+  }
 
   // Add passthrough args
   claudeArgs.push(...parsed.passthroughArgs);

package/src/cli.ts

@@ -119,7 +119,7 @@ async function main(): Promise<void> {
   }
 
   // Detect environment and build template vars
-  const env = detectEnv();
+  const env = detectEnv(parsed.modelHint);
   const templateVars = buildTemplateVars(env);
 
   // Assemble the prompt
@@ -150,6 +150,9 @@ async function main(): Promise<void> {
   if (parsed.forwarded.appendSystemPromptFile) {
     claudeArgs.push("--append-system-prompt-file", parsed.forwarded.appendSystemPromptFile);
   }
+  if (parsed.forwarded.model) {
+    claudeArgs.push("--model", parsed.forwarded.model);
+  }
 
   // Add passthrough args
   claudeArgs.push(...parsed.passthroughArgs);

package/src/config-cli.ts

@@ -8,6 +8,7 @@ import {
   checkModifierNameCollision,
   checkPresetNameCollision,
   checkAxisValueCollision,
+  checkStyleNameCollision,
 } from "./config.js";
 import { AXIS_BUILTINS } from "./types.js";
 const VALID_AXES = Object.keys(AXIS_BUILTINS) as Array<"agency" | "quality" | "scope">;
@@ -120,6 +121,33 @@ function configRemoveModifier(configPath: string, name: string): void {
   );
 }
 
+function configAddStyle(configPath: string, name: string, mdPath: string): void {
+  checkStyleNameCollision(name);
+  const config = readConfig(configPath);
+  config.styles = { ...config.styles, [name]: mdPath };
+  writeConfig(configPath, config);
+  process.stdout.write(
+    `Registered style "${name}" in ${configFileName(configPath)}\n`
+  );
+}
+
+function configRemoveStyle(configPath: string, name: string): void {
+  const config = readConfig(configPath);
+  const styles = config.styles ?? {};
+  if (!(name in styles)) {
+    throw new Error(
+      `Style "${name}" not found in ${configFileName(configPath)}`
+    );
+  }
+  const updated = { ...styles };
+  delete updated[name];
+  config.styles = updated;
+  writeConfig(configPath, config);
+  process.stdout.write(
+    `Unregistered style "${name}" from ${configFileName(configPath)}\n`
+  );
+}
+
 function configAddAxis(configPath: string, axis: string, name: string, mdPath: string): void {
   if (!VALID_AXES.includes(axis as ValidAxis)) {
     throw new Error(
@@ -173,6 +201,7 @@ function configAddPreset(configPath: string, name: string, flags: string[]): voi
       agency: { type: "string" },
       quality: { type: "string" },
       scope: { type: "string" },
+      style: { type: "string" },
       modifier: { type: "string", multiple: true },
       readonly: { type: "boolean" },
       "context-pacing": { type: "boolean" },
@@ -184,6 +213,7 @@ function configAddPreset(configPath: string, name: string, flags: string[]): voi
   if (values.agency !== undefined) presetDef.agency = values.agency;
   if (values.quality !== undefined) presetDef.quality = values.quality;
   if (values.scope !== undefined) presetDef.scope = values.scope;
+  if (values.style !== undefined) presetDef.style = values.style;
   if (values.modifier !== undefined && values.modifier.length > 0) {
     presetDef.modifiers = values.modifier as string[];
   }
@@ -238,6 +268,8 @@ Subcommands:
   remove-default <name>             Remove from defaultModifiers
   add-modifier <name> <path>        Register a named modifier
   remove-modifier <name>            Unregister a named modifier
+  add-style <name> <path>           Register a named style
+  remove-style <name>               Unregister a named style
   add-axis <axis> <name> <path>     Register custom axis value
   remove-axis <axis> <name>         Unregister custom axis value
   add-preset <name> [flags]         Create a custom preset
@@ -247,6 +279,7 @@ Flags for add-preset:
   --agency <value>
   --quality <value>
   --scope <value>
+  --style <value>
   --modifier <name> (repeatable)
   --readonly
   --context-pacing`;
@@ -287,6 +320,18 @@ Flags for add-preset:
       break;
     }
 
+    case "add-style": {
+      if (rest.length < 2) throw new Error("add-style requires <name> <path>");
+      configAddStyle(configPath, rest[0], rest[1]);
+      break;
+    }
+
+    case "remove-style": {
+      if (rest.length < 1) throw new Error("remove-style requires <name>");
+      configRemoveStyle(configPath, rest[0]);
+      break;
+    }
+
     case "add-axis": {
       if (rest.length < 3) throw new Error("add-axis requires <axis> <name> <path>");
       configAddAxis(configPath, rest[0], rest[1], rest[2]);

package/src/config.ts

@@ -1,7 +1,7 @@
 import { readFileSync, existsSync } from "node:fs";
 import { join, dirname, resolve, isAbsolute } from "node:path";
 import { homedir } from "node:os";
-import { PRESET_NAMES, BUILTIN_MODIFIER_NAMES, AXIS_BUILTINS, BUILTIN_BASE_NAMES, isBuiltinModifier, isPresetName, isBuiltinBase, isBuiltinAxisValue } from "./types.js";
+import { PRESET_NAMES, BUILTIN_MODIFIER_NAMES, AXIS_BUILTINS, BUILTIN_BASE_NAMES, STYLE_VALUES, isBuiltinModifier, isPresetName, isBuiltinBase, isBuiltinAxisValue, isBuiltinStyle } from "./types.js";
 
 /**
  * Matches paths that reference potentially sensitive files (SSH keys, credentials, etc.).
@@ -33,6 +33,8 @@ function validateConfigDefinedPath(path: string, context: string, configPath: st
 export interface UserConfig {
   defaultBase?: string;
   bases?: Record<string, string>; // name → directory path (relative to config dir)
+  defaultStyle?: string;
+  styles?: Record<string, string>; // name → .md path (relative to config dir)
   defaultModifiers?: string[];
   modifiers?: Record<string, string>;
   axes?: {
@@ -48,6 +50,7 @@ export interface CustomPresetDef {
   agency?: string;
   quality?: string;
   scope?: string;
+  style?: string;
   modifiers?: string[];
   readonly?: boolean;
   contextPacing?: boolean;
@@ -76,6 +79,15 @@ export function checkPresetNameCollision(name: string): void {
   }
 }
 
+/** Throws if name collides with a built-in style name. */
+export function checkStyleNameCollision(name: string): void {
+  if (isBuiltinStyle(name)) {
+    throw new Error(
+      `"${name}" is a built-in style name (${STYLE_VALUES.join(", ")}); choose a different name`
+    );
+  }
+}
+
 /** Throws if name collides with a built-in base name. */
 export function checkBaseNameCollision(name: string): void {
   if (isBuiltinBase(name)) {
@@ -204,6 +216,22 @@ function validateConfig(raw: unknown, configPath: string): UserConfig {
     for (const key of Object.keys(bases)) checkBaseNameCollision(key);
   }
 
+  // Validate defaultStyle
+  if (obj.defaultStyle !== undefined && typeof obj.defaultStyle !== "string") {
+    throw new Error(
+      `Invalid config file ${configPath}: "defaultStyle" must be a string`
+    );
+  }
+
+  // Validate styles map
+  if (obj.styles !== undefined) {
+    const styles = validateStringRecord(obj.styles, "styles", configPath);
+    for (const [key, val] of Object.entries(styles)) {
+      checkStyleNameCollision(key);
+      validateConfigDefinedPath(val, `"styles.${key}"`, configPath);
+    }
+  }
+
   // Validate defaultModifiers
   if (obj.defaultModifiers !== undefined) {
     const defaultModifiers = validateStringArray(obj.defaultModifiers, "defaultModifiers", configPath);
@@ -262,7 +290,7 @@ function validateConfig(raw: unknown, configPath: string): UserConfig {
           `Invalid config file ${configPath}: preset "${presetName}.base" must be a string`
         );
       }
-      for (const field of ["agency", "quality", "scope"] as const) {
+      for (const field of ["agency", "quality", "scope", "style"] as const) {
         if (def[field] !== undefined && typeof def[field] !== "string") {
           throw new Error(
             `Invalid config file ${configPath}: preset "${presetName}.${field}" must be a string`

package/src/embedded-prompts.ts

@@ -45,7 +45,7 @@ Examples of the kind of risky actions that warrant user confirmation:
 - Actions visible to others or that affect shared state: pushing code, creating/closing/commenting on PRs or issues, sending messages (Slack, email, GitHub), posting to external services, modifying shared infrastructure or permissions
 - Uploading content to third-party web tools (diagram renderers, pastebins, gists) publishes it - consider whether it could be sensitive before sending, since it may be cached or indexed even if later deleted.
 
-When you encounter an obstacle, do not use destructive actions as a shortcut to simply make it go away. For instance, try to identify root causes and fix underlying issues rather than bypassing safety checks (e.g. --no-verify). If you discover unexpected state like unfamiliar files, branches, or configuration, investigate before deleting or overwriting, as it may represent the user's in-progress work. For example, typically resolve merge conflicts rather than discarding changes; similarly, if a lock file exists, investigate what process holds it rather than deleting it. In short: only take risky actions carefully, and when in doubt, ask before acting. Follow both the spirit and letter of these instructions - measure twice, cut once.
+When you encounter an obstacle, do not use destructive actions as a shortcut to simply make it go away. For instance, try to identify root causes and fix underlying issues rather than bypassing safety checks (e.g. --no-verify). If you discover unexpected state like unfamiliar files, branches, or configuration, investigate before deleting or overwriting, as it may represent the user's in-progress work. If you're unsure whether the user would want something kept, prefer a reversible step (move it aside, rename it, or stash it) over deleting; files you created yourself this session (scratch outputs, experiment intermediates) are yours to clean up freely. For example, typically resolve merge conflicts rather than discarding changes; similarly, if a lock file exists, investigate what process holds it rather than deleting it. In a git repository, run \`git status\` before any command that could discard uncommitted work (git checkout/restore/reset/clean, rm -rf on a repo path, restoring from a snapshot), and stash (with \`-u\` for untracked) or commit anything you find first. And when staging or committing: review what's included (\`git status\` after a broad \`git add\`), and if you see anything suspicious that might reveal secrets — even if the filename looks innocuous — double-check the file's contents before pushing. In short: only take risky actions carefully, and when in doubt, ask before acting. Follow both the spirit and letter of these instructions - measure twice, cut once.
 `,
   "base/tools.md": `# Using your tools
  - Use your dedicated tools instead of shell equivalents. Read works better than cat or grep. Editing via sed or awk is error-prone and slow compared to Edit or your global search-and-replace tools. Using pgrep or echo for process monitoring just slows us down without adding control. Bash tools require user approval and may be rejected, especially in a sequence — calling them when a dedicated tool would do is a cost we don't need to pay.
@@ -533,6 +533,23 @@ Stay strictly within the bounds of what was requested.
 - Do not refactor, rename, or reorganize anything that isn't directly required by the task.
 - If the request is to change function X, change function X. Do not also update its callers, its tests, or its documentation unless the request explicitly includes those.
 - If completing the request requires changing more code than expected, pause and confirm the scope with the user before proceeding.
+`,
+  "style/declaudified.md": `# Style: Declaudified
+
+How to write everything the user reads — answers, summaries, explanations, commit messages, docs.
+
+- Lead with the answer. State the point first, then support it.
+- Cut filler and metadiscourse — language that narrates the communicating instead of communicating: "let me lay out," "it's worth noting," "as mentioned above." Say the thing; don't say you're about to say it.
+- Delete your opening sentence. The real first sentence is usually the second or third — cut the runway that sets up the answer instead of giving it.
+- Do add relevant surrounding context that hasn't already been established in the conversation — don't assume the user has perfect repo or domain knowledge. Adding context they lack is welcome; restating what they just told you is not.
+- Don't signpost structure. A list or table is self-evident; don't preface it with "here's a table of."
+- Plain language: real names for real things, minimal jargon, no padding adjectives. Use real terminology; don't invent labels ("status," not "milestones").
+- Drop dead tech-metaphors and stock phrases ("ship," "load-bearing," "first-class," "surface" as a verb, "seamless," "leverage," "robust"). Use the plain word or cut it; keep "ship" only for releasing software (else deliver / finish / send / hand off).
+- Don't state a cause without evidence — label speculation or leave it out.
+
+In short: say the thing; don't say you're about to say it, and don't say you understood the question.
+
+References: George Orwell, "Politics and the English Language" (his plain-English rules); Strunk & White, *The Elements of Style* ("omit needless words"); Joseph Williams, *Style: Toward Clarity and Grace* (on cutting metadiscourse).
 `,
   "modifiers/readonly.md": `# Read-only mode
 

package/src/env.ts

@@ -1,6 +1,8 @@
 import { execSync } from "node:child_process";
-import { basename } from "node:path";
-import type { EnvInfo, TemplateVars } from "./types.js";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import type { EnvInfo, ModelInfo, TemplateVars } from "./types.js";
 
 function exec(command: string): string | null {
   try {
@@ -18,7 +20,77 @@ function exec(command: string): string | null {
   }
 }
 
-export function detectEnv(): EnvInfo {
+// Model metadata table extracted from the Claude Code binary — update when Claude Code updates.
+// Extraction: grep the native binary for `{id:"claude-...,display_name:...,knowledge_cutoff:...`
+const MODEL_TABLE: readonly ModelInfo[] = [
+  { id: "claude-fable-5", name: "Fable 5", cutoff: "January 2026" },
+  { id: "claude-mythos-5", name: "Mythos 5", cutoff: "January 2026" },
+  { id: "claude-opus-4-8", name: "Opus 4.8", cutoff: "January 2026" },
+  { id: "claude-opus-4-7", name: "Opus 4.7", cutoff: "January 2026" },
+  { id: "claude-opus-4-6", name: "Opus 4.6", cutoff: "May 2025" },
+  { id: "claude-opus-4-5", name: "Opus 4.5", cutoff: "May 2025" },
+  { id: "claude-opus-4-1", name: "Opus 4.1", cutoff: "January 2025" },
+  { id: "claude-opus-4-0", name: "Opus 4", cutoff: "January 2025" },
+  { id: "claude-sonnet-5", name: "Sonnet 5", cutoff: "January 2026" },
+  { id: "claude-sonnet-4-6", name: "Sonnet 4.6", cutoff: "August 2025" },
+  { id: "claude-sonnet-4-5", name: "Sonnet 4.5", cutoff: "January 2025" },
+  { id: "claude-sonnet-4-0", name: "Sonnet 4", cutoff: "January 2025" },
+  { id: "claude-haiku-4-5", name: "Haiku 4.5", cutoff: "February 2025" },
+] as const;
+
+// Aliases resolve to the newest model of the family; opusplan executes on opus
+const MODEL_ALIASES: Record<string, string> = {
+  opus: "claude-opus-4-8",
+  opusplan: "claude-opus-4-8",
+  sonnet: "claude-sonnet-5",
+  haiku: "claude-haiku-4-5",
+  fable: "claude-fable-5",
+};
+
+const DEFAULT_MODEL: ModelInfo = MODEL_TABLE[0];
+
+export function resolveModel(raw: string | null | undefined): ModelInfo {
+  if (!raw || raw === "default") return DEFAULT_MODEL;
+
+  const has1m = raw.endsWith("[1m]");
+  const base = has1m ? raw.slice(0, -"[1m]".length) : raw;
+  const id = MODEL_ALIASES[base] ?? base;
+
+  // Exact id first, then dated variants like claude-haiku-4-5-20251001
+  const entry =
+    MODEL_TABLE.find((m) => m.id === id) ?? MODEL_TABLE.find((m) => id.startsWith(`${m.id}-`));
+  if (!entry) {
+    // Unknown model — likely newer than the table; surface the id as the name
+    // and keep the newest known cutoff rather than inventing one
+    return { name: id, id: has1m ? `${id}[1m]` : id, cutoff: DEFAULT_MODEL.cutoff };
+  }
+
+  return {
+    name: has1m ? `${entry.name} (1M context)` : entry.name,
+    id: has1m ? `${id}[1m]` : id,
+    cutoff: entry.cutoff,
+  };
+}
+
+// Claude Code reads its model setting from these files, most specific first
+function readConfiguredModel(cwd: string): string | null {
+  const candidates = [
+    join(cwd, ".claude", "settings.local.json"),
+    join(cwd, ".claude", "settings.json"),
+    join(homedir(), ".claude", "settings.json"),
+  ];
+  for (const path of candidates) {
+    try {
+      const settings = JSON.parse(readFileSync(path, "utf8"));
+      if (typeof settings.model === "string" && settings.model !== "") return settings.model;
+    } catch {
+      // Missing or malformed settings file — try the next candidate
+    }
+  }
+  return null;
+}
+
+export function detectEnv(modelArg?: string | null): EnvInfo {
   const cwd = process.cwd();
   const isGit = exec("git rev-parse --is-inside-work-tree") === "true";
 
@@ -39,15 +111,11 @@ export function detectEnv(): EnvInfo {
   const platform = exec("uname -s")?.toLowerCase() ?? "unknown";
   const shell = basename(process.env.SHELL || "bash");
   const osVersion = exec("uname -sr") ?? "unknown";
+  const model = resolveModel(modelArg ?? process.env.ANTHROPIC_MODEL ?? readConfiguredModel(cwd));
 
-  return { cwd, isGit, isWorktree, gitBranch, gitStatus, gitLog, platform, shell, osVersion };
+  return { cwd, isGit, isWorktree, gitBranch, gitStatus, gitLog, platform, shell, osVersion, model };
 }
 
-// Hardcoded model info — update when Claude Code updates
-const MODEL_NAME = "Claude Opus 4.8";
-const MODEL_ID = "claude-opus-4-8";
-const KNOWLEDGE_CUTOFF = "January 2026";
-
 export function buildTemplateVars(env: EnvInfo): TemplateVars {
   let gitStatusBlock = "";
   if (env.isGit) {
@@ -63,7 +131,8 @@ export function buildTemplateVars(env: EnvInfo): TemplateVars {
   }
 
   const worktreeNotice = env.isWorktree
-    ? "\n - This is a git worktree — an isolated copy of the repository. Run all commands from this directory. Do NOT `cd` to the original repository root."
+    ? "\n - This is a git worktree — an isolated copy of the repository. Run all commands from this directory. Do NOT `cd` to the original repository root." +
+      "\n - The git stash stack is shared with the main checkout and all other worktrees, and other Claude sessions may push or pop it concurrently. Never use bare `git stash` / `git stash pop` — you could pop another session's changes. Prefer a temporary WIP commit to set work aside; if you must stash, use `git stash push -u -m \"<unique-tag>\"`, immediately capture your entry's SHA via `git stash list --format='%H %gs'`, restore with `git stash apply <sha>` (not pop), and afterwards drop the entry, re-finding its current `stash@{n}` by tag first."
     : "";
 
   return {
@@ -72,9 +141,9 @@ export function buildTemplateVars(env: EnvInfo): TemplateVars {
     PLATFORM: env.platform,
     SHELL: env.shell,
     OS_VERSION: env.osVersion,
-    MODEL_NAME,
-    MODEL_ID,
-    KNOWLEDGE_CUTOFF,
+    MODEL_NAME: env.model.name,
+    MODEL_ID: env.model.id,
+    KNOWLEDGE_CUTOFF: env.model.cutoff,
     GIT_STATUS: gitStatusBlock,
     WORKTREE_NOTICE: worktreeNotice,
   };

package/src/inspect.ts

@@ -66,6 +66,13 @@ function collectConfigDefinedPaths(loadedConfig: LoadedConfig | null): Set<strin
     }
   }
 
+  // Style definitions
+  if (config.styles) {
+    for (const val of Object.values(config.styles)) {
+      paths.add(resolveConfigPath(configDir, val));
+    }
+  }
+
   // Axis definitions
   if (config.axes) {
     for (const axisName of ["agency", "quality", "scope"] as const) {

package/src/presets.ts

@@ -5,6 +5,7 @@ export interface PresetDefinition {
   axes: AxisConfig | null;
   readonly: boolean;
   base?: string;       // default base for this preset
+  style?: string;      // default style for this preset
   modifiers: string[]; // built-in modifier names to apply
 }
 

package/src/resolve.ts

@@ -7,11 +7,13 @@ import {
   AGENCY_VALUES,
   QUALITY_VALUES,
   SCOPE_VALUES,
+  STYLE_VALUES,
   BUILTIN_MODIFIER_NAMES,
   BUILTIN_BASE_NAMES,
   PRESET_NAMES,
   isBuiltinModifier,
   isBuiltinBase,
+  isBuiltinStyle,
 } from "./types.js";
 import { resolve as pathResolve, isAbsolute } from "node:path";
 
@@ -128,6 +130,51 @@ function applyModifiers(
   }
 }
 
+/**
+ * Resolves a style value to either a built-in name or an absolute path.
+ * Resolution order: built-in values → config-defined names → file path heuristic.
+ * Throws with descriptive error if unresolvable.
+ */
+function resolveStyleValue(raw: string, loadedConfig: LoadedConfig | null): string {
+  // 1. Built-in value
+  if (isBuiltinStyle(raw)) return raw;
+
+  // 2. Config-defined custom name
+  const configStyles = loadedConfig?.config.styles;
+  if (configStyles && raw in configStyles) {
+    return resolveConfigPath(loadedConfig!.configDir, configStyles[raw]);
+  }
+
+  // 3. File path
+  if (looksLikeFilePath(raw)) {
+    return isAbsolute(raw) ? raw : pathResolve(raw);
+  }
+
+  // 4. Unknown
+  const configHint = loadedConfig
+    ? ` Config loaded from: ${loadedConfig.configDir}`
+    : " No config file found.";
+  throw new Error(
+    `Unknown --style value: "${raw}". ` +
+    `Must be one of: ${STYLE_VALUES.join(", ")}, ` +
+    `a name defined in your config, or a file path.${configHint}`
+  );
+}
+
+/**
+ * Resolves the active style, or null when none applies.
+ * Priority: CLI --style > config defaultStyle > preset style > none
+ */
+function resolveStyle(
+  raw: string | undefined,
+  loadedConfig: LoadedConfig | null,
+  presetStyle: string | undefined,
+): string | null {
+  const value = raw ?? loadedConfig?.config.defaultStyle ?? presetStyle;
+  if (value === undefined) return null;
+  return resolveStyleValue(value, loadedConfig);
+}
+
 /**
  * Resolves a base reference to a built-in name or absolute directory path.
  * Priority: CLI --base > config defaultBase > preset base > "standard"
@@ -190,12 +237,14 @@ export function resolveConfig(
   // 3. CLI --modifier flags — appended after defaults
   applyModifiers(parsed.customModifiers, loadedConfig, modifierPaths, "append");
 
-  // Handle "none" preset — resolve base before early return
+  // Handle "none" preset — resolve base before early return.
+  // Explicit --style (or config defaultStyle) still applies, like modifiers.
   if (parsed.preset === "none") {
     const base = resolveBase(parsed.base, loadedConfig, undefined);
     return {
       base,
       axes: null,
+      style: resolveStyle(parsed.style, loadedConfig, undefined),
       modifiers: modifierPaths,
     };
   }
@@ -204,6 +253,7 @@ export function resolveConfig(
   let quality: string;
   let scope: string;
   let presetBase: string | undefined;
+  let presetStyle: string | undefined;
 
   if (parsed.preset) {
     // Check built-in presets first, then config presets
@@ -220,6 +270,7 @@ export function resolveConfig(
         ? resolveAxisValue(parsed.overrides.scope, "scope", SCOPE_VALUES, loadedConfig)
         : preset.axes.scope;
       presetBase = preset.base;
+      presetStyle = preset.style;
 
       // Apply preset's readonly flag as a modifier
       if (preset.readonly) {
@@ -233,6 +284,7 @@ export function resolveConfig(
       // Config-defined preset
       const customPreset = config.presets[parsed.preset];
       presetBase = customPreset.base;
+      presetStyle = customPreset.style;
       agency = parsed.overrides.agency
         ? resolveAxisValue(parsed.overrides.agency, "agency", AGENCY_VALUES, loadedConfig)
         : customPreset.agency
@@ -284,10 +336,12 @@ export function resolveConfig(
   }
 
   const base = resolveBase(parsed.base, loadedConfig, presetBase);
+  const style = resolveStyle(parsed.style, loadedConfig, presetStyle);
 
   return {
     base,
     axes: { agency, quality, scope },
+    style,
     modifiers: modifierPaths,
   };
 }

package/src/types.ts

@@ -7,6 +7,13 @@ export type Quality = (typeof QUALITY_VALUES)[number];
 export const SCOPE_VALUES = ["unrestricted", "adjacent", "narrow"] as const;
 export type Scope = (typeof SCOPE_VALUES)[number];
 
+// Built-in style names — writing styles applied on top of any base/axes
+export const STYLE_VALUES = ["declaudified"] as const;
+export type Style = (typeof STYLE_VALUES)[number];
+export function isBuiltinStyle(value: string): value is Style {
+  return (STYLE_VALUES as readonly string[]).includes(value);
+}
+
 export const PRESET_NAMES = [
   "create",
   "extend",
@@ -69,9 +76,17 @@ export interface AxisConfig {
 export interface ModeConfig {
   base: string; // built-in name ("standard", "chill") or absolute path to base directory
   axes: AxisConfig | null; // null for "none" mode
+  style: string | null; // built-in name or absolute path to a custom fragment; null = no style
   modifiers: string[]; // ordered list of modifier fragment paths (embedded keys or absolute paths)
 }
 
+/** Resolved model metadata for env.md substitution */
+export interface ModelInfo {
+  name: string;
+  id: string;
+  cutoff: string;
+}
+
 export interface EnvInfo {
   cwd: string;
   isGit: boolean;
@@ -82,6 +97,7 @@ export interface EnvInfo {
   platform: string;
   shell: string;
   osVersion: string;
+  model: ModelInfo;
 }
 
 /** Template variables for env.md substitution */

package/src/update.ts

@@ -159,11 +159,13 @@ export function classifyInstall(
   execPath: string = process.execPath,
   buildInfo: BuildInfo = BUILD_INFO,
 ): InstallClassification {
-  // 1. Runtime interpreter → source mode
-  if (SOURCE_EXEC_NAMES.has(basename(execPath))) {
+  // 1. Runtime interpreter → source mode. The npm distribution of bun names
+  // its binary "bun.exe" on every platform, so strip the suffix before matching.
+  const execName = basename(execPath).replace(/\.exe$/, "");
+  if (SOURCE_EXEC_NAMES.has(execName)) {
     return {
       kind: "source",
-      reason: `Running as ${basename(execPath)} runtime (source mode)`,
+      reason: `Running as ${execName} runtime (source mode)`,
     };
   }
 

package/src/usage.ts

@@ -42,6 +42,11 @@ Axis overrides:
   --scope <value>         Built-in: unrestricted, adjacent, narrow
   Axis values can also be config-defined names or file paths (.md files).
 
+Style:
+  --style <value>         Writing style for output. Built-in: declaudified
+  Style can also be a config-defined name or a file path (.md file).
+  No style is applied unless set via --style, config defaultStyle, or a preset.
+
 Modifiers:
   --readonly              Prevent file modifications
   --context-pacing        Include context pacing prompt
@@ -51,6 +56,8 @@ Modifiers:
 Forwarded to claude:
   --append-system-prompt <text>
   --append-system-prompt-file <path>
+  --model <alias|id>      Also sets the model info in the prompt's environment section.
+  Without --model, model info comes from ANTHROPIC_MODEL or Claude settings files.
 
 Config: .claude-mode.json (project) or ~/.config/claude-mode/config.json (global)
 
@@ -60,6 +67,7 @@ Examples:
   claude-mode create
   claude-mode create --base chill             # use the chill base
   claude-mode create --quality pragmatic
+  claude-mode create --style declaudified      # lead-with-the-answer writing, no filler
   claude-mode create --modifier ./my-rules.md
   claude-mode --agency autonomous --quality ./team-quality.md
   claude-mode team-default                    # custom preset from config