claude-code-modes 0.1.0

package/src/types.ts

@@ -0,0 +1,99 @@
+export const AGENCY_VALUES = ["autonomous", "collaborative", "surgical"] as const;
+export type Agency = (typeof AGENCY_VALUES)[number];
+
+export const QUALITY_VALUES = ["architect", "pragmatic", "minimal"] as const;
+export type Quality = (typeof QUALITY_VALUES)[number];
+
+export const SCOPE_VALUES = ["unrestricted", "adjacent", "narrow"] as const;
+export type Scope = (typeof SCOPE_VALUES)[number];
+
+export const PRESET_NAMES = [
+  "create",
+  "extend",
+  "safe",
+  "refactor",
+  "explore",
+  "none",
+] as const;
+export type PresetName = (typeof PRESET_NAMES)[number];
+export function isPresetName(value: string): value is PresetName {
+  return (PRESET_NAMES as readonly string[]).includes(value);
+}
+
+// Built-in modifier names — used for collision checking in config validation
+export const BUILTIN_MODIFIER_NAMES = ["readonly", "context-pacing"] as const;
+export type BuiltinModifier = (typeof BUILTIN_MODIFIER_NAMES)[number];
+export function isBuiltinModifier(value: string): value is BuiltinModifier {
+  return (BUILTIN_MODIFIER_NAMES as readonly string[]).includes(value);
+}
+
+// Built-in base names — "standard" is the existing base, "chill" is the new alternative
+export const BUILTIN_BASE_NAMES = ["standard", "chill"] as const;
+export type BuiltinBaseName = (typeof BUILTIN_BASE_NAMES)[number];
+export function isBuiltinBase(value: string): value is BuiltinBaseName {
+  return (BUILTIN_BASE_NAMES as readonly string[]).includes(value);
+}
+
+// Reserved manifest entries — "axes" and "modifiers" trigger insertion
+export const MANIFEST_RESERVED = ["axes", "modifiers"] as const;
+export type ManifestReserved = (typeof MANIFEST_RESERVED)[number];
+
+// A manifest is a flat array of strings
+export type BaseManifest = string[];
+
+/** Maps each axis to its built-in values — single source of truth for collision checks */
+export const AXIS_BUILTINS: Record<"agency" | "quality" | "scope", readonly string[]> = {
+  agency: AGENCY_VALUES,
+  quality: QUALITY_VALUES,
+  scope: SCOPE_VALUES,
+};
+export function isBuiltinAxisValue(axis: "agency" | "quality" | "scope", value: string): boolean {
+  return (AXIS_BUILTINS[axis] as readonly string[]).includes(value);
+}
+
+// Axis values are strings: either a built-in name or an absolute path to a custom fragment
+export interface AxisConfig {
+  agency: string;
+  quality: string;
+  scope: string;
+}
+
+export interface ModeConfig {
+  base: string; // built-in name ("standard", "chill") or absolute path to base directory
+  axes: AxisConfig | null; // null for "none" mode
+  modifiers: {
+    readonly: boolean;
+    contextPacing: boolean;
+    custom: string[]; // ordered list of absolute paths to custom modifier files
+  };
+}
+
+export interface EnvInfo {
+  cwd: string;
+  isGit: boolean;
+  gitBranch: string | null;
+  gitStatus: string | null;
+  gitLog: string | null;
+  platform: string;
+  shell: string;
+  osVersion: string;
+}
+
+/** Template variables for env.md substitution */
+export interface TemplateVars {
+  CWD: string;
+  IS_GIT: string;
+  PLATFORM: string;
+  SHELL: string;
+  OS_VERSION: string;
+  MODEL_NAME: string;
+  MODEL_ID: string;
+  KNOWLEDGE_CUTOFF: string;
+  GIT_STATUS: string;
+}
+
+export interface AssembleOptions {
+  mode: ModeConfig;
+  templateVars: TemplateVars;
+  promptsDir: string; // path to prompts/ directory
+}

package/src/usage.ts

@@ -0,0 +1,51 @@
+export function printUsage(): void {
+  const usage = `Usage: claude-mode [preset] [options] [-- claude-args...]
+
+Subcommands:
+  config            Manage configuration
+  inspect [--print] Show prompt assembly plan with provenance and warnings
+
+Presets:
+  create          autonomous / architect / unrestricted
+  extend          autonomous / pragmatic / adjacent
+  safe            collaborative / minimal / narrow
+  refactor        autonomous / pragmatic / unrestricted
+  explore         collaborative / architect / narrow (readonly)
+  none            no behavioral instructions
+
+Base:
+  --base <name|path>      Built-in: standard, chill
+  Base can also be a config-defined name or a directory path.
+
+Axis overrides:
+  --agency <value>        Built-in: autonomous, collaborative, surgical
+  --quality <value>       Built-in: architect, pragmatic, minimal
+  --scope <value>         Built-in: unrestricted, adjacent, narrow
+  Axis values can also be config-defined names or file paths (.md files).
+
+Modifiers:
+  --readonly              Prevent file modifications
+  --context-pacing        Include context pacing prompt
+  --modifier <name|path>  Add a custom modifier (repeatable)
+  --print                 Print assembled prompt instead of launching claude
+
+Forwarded to claude:
+  --append-system-prompt <text>
+  --append-system-prompt-file <path>
+
+Config: .claude-mode.json (project) or ~/.config/claude-mode/config.json (global)
+
+Everything after -- is passed to claude verbatim.
+
+Examples:
+  claude-mode create
+  claude-mode create --base chill             # use the chill base
+  claude-mode create --quality pragmatic
+  claude-mode create --modifier ./my-rules.md
+  claude-mode --agency autonomous --quality ./team-quality.md
+  claude-mode team-default                    # custom preset from config
+  claude-mode explore --print
+  claude-mode create -- --verbose --model sonnet`;
+
+  process.stdout.write(usage + "\n");
+}