{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/jmagly/aiwg/models-config.json",
  "title": "AIWG Model Configuration",
  "description": "Default model mappings for AIWG SDLC framework deployment. Users can customize these values for their specific needs.",
  "version": "1.0.0",
  "lastUpdated": "2026-09-21",

  "claude": {
    "reasoning": {
      "model": "claude-opus-5-5",
      "description": "Claude Opus 5.5 (pinned ID; premium tier) - Best for complex reasoning, architecture design, strategic decisions. Bare aliases inherit the parent session's variant and hit the credit-gated 1M path under a 1M parent (#1442); opt into 1M explicitly with --reasoning-model opus[1m]."
    },
    "coding": {
      "model": "claude-sonnet-5-5",
      "description": "Claude Sonnet 5.5 (pinned ID; standard tier) - Best for code generation, implementation, debugging. Pinned so subagent dispatch never inherits a 1M-context parent (#1442, #2563); opt into 1M explicitly with --coding-model sonnet[1m]."
    },
    "efficiency": {
      "model": "claude-haiku-5-5",
      "description": "Claude Haiku 5.5 (pinned ID; economy tier) - Best for quick tasks, file operations, simple edits. Verified catalog binding as of 2026-10-27."
    }
  },

  "factory": {
    "reasoning": {
      "model": "claude-opus-5",
      "reasoningEffort": "high",
      "description": "Claude Opus 5 - Factory droid 1.0 reasoning model ID"
    },
    "coding": {
      "model": "claude-sonnet-5",
      "reasoningEffort": "medium",
      "description": "Claude Sonnet 5 - Factory droid 1.0 coding model ID"
    },
    "efficiency": {
      "model": "claude-haiku-4-5-20251001",
      "reasoningEffort": "low",
      "description": "Claude Haiku 4.5 - Factory droid 1.0 efficiency model ID"
    }
  },

  "openai": {
    "reasoning": {
      "model": "gpt-6.1-sol",
      "description": "GPT-6.1 Sol - Premium tier; Codex 'latest frontier agentic coding model' (verified catalog 2026-10-27). GPT-6 Astra is the flagship and is user-elected only."
    },
    "coding": {
      "model": "gpt-6.1-terra",
      "description": "GPT-6.1 Terra - Standard tier; 'balanced agentic coding model for everyday work' (verified catalog 2026-10-27)"
    },
    "efficiency": {
      "model": "gpt-6-luna",
      "description": "GPT-6 Luna - Economy tier; 'fast and affordable agentic coding model' (verified catalog 2026-10-27)"
    }
  },

  "windsurf": {
    "_status": "EXPERIMENTAL",
    "reasoning": {
      "model": "claude-opus-5",
      "description": "Windsurf uses Claude models via API (experimental)"
    },
    "coding": {
      "model": "claude-sonnet-5",
      "description": "Windsurf uses Claude models via API (experimental)"
    },
    "efficiency": {
      "model": "claude-haiku-4-5-20251001",
      "description": "Windsurf uses Claude models via API (experimental)"
    }
  },

  "ollama": {
    "_note": "Local model defaults via Ollama. These are reasonable starting points — tune to your hardware.",
    "reasoning": {
      "model": "llama3.3:70b",
      "description": "Llama 3.3 70B — closest to cloud reasoning quality locally, requires 48GB+ VRAM"
    },
    "coding": {
      "model": "qwen2.5-coder:14b",
      "description": "Qwen 2.5 Coder 14B — best coding quality per VRAM of validated local models (12GB VRAM)"
    },
    "efficiency": {
      "model": "qwen3.5:9b",
      "description": "Qwen 3.5 9B — consumer hardware entry point with tool use and vision support (8GB VRAM)"
    }
  },

  "shorthand": {
    "fable": "claude-fable-5-1",
    "opus": "claude-opus-5-5",
    "sonnet": "claude-sonnet-5-5",
    "haiku": "claude-haiku-5-5",
    "inherit": "inherit"
  },

  "claude_shorthand": {
    "opus": "opus",
    "opus-1m": "opus[1m]",
    "opus[1m]": "opus[1m]",
    "sonnet": "sonnet",
    "sonnet-1m": "sonnet[1m]",
    "sonnet[1m]": "sonnet[1m]",
    "haiku": "haiku",
    "fable": "fable",
    "fable-1m": "fable[1m]",
    "fable[1m]": "fable[1m]",
    "inherit": "inherit"
  },

  "openai_shorthand": {
    "astra": "gpt-6-astra",
    "sol": "gpt-6.1-sol",
    "terra": "gpt-6.1-terra",
    "luna": "gpt-6-luna"
  },

  "_comments": {
    "usage": "This file defines default model mappings used by AIWG deployment scripts",
    "customization": "Users can modify these values to use different models or versions",
    "location": "Place custom models.json in project root to override defaults",
    "precedence": "Project models.json > User ~/.config/aiwg/models.json > AIWG defaults",
    "documentation": "See docs/configuration/model-configuration.md for details",
    "flagship": "Flagship models (claude-fable-5-1, gpt-6-astra) are never assigned to a role by default. They are available only through explicit user election (e.g. --reasoning-model fable or --reasoning-model astra). See epic #2642.",
    "claudeLongContext": "Claude Code documents sonnet and sonnet[1m] as separate selectors. AIWG deploys pinned model IDs (claude-sonnet-5-5 etc.) because a bare alias inherits a 1M-context parent and subagent dispatch then hits the usage-credit gate (#1442, #2563); opt into 1M with --coding-model sonnet[1m] or sonnet-1m."
  }
}
