@ryodeushii/ai-product-team-agents 0.0.7 → 0.0.9

package/README.md

@@ -82,15 +82,20 @@ autonomy: checkpoint   # supervised | checkpoint | autonomous
 # Deployment target (used by devops agent)
 deploy: vercel         # vercel | fly | aws | gcp | docker | k8s
 
-# Model overrides — all optional, framework defaults apply otherwise
+# Define your own presets (optional) — use the same name to shadow a built-in
+presets:
+  google:
+    thinking:  google/gemini-2.5-pro
+    executing: google/gemini-2.5-flash
+    creative:  google/gemini-2.5-pro
+
+# Select a preset (built-in: "anthropic"; or one you defined above)
+preset: google
+
+# Fine-tune individual roles on top of the preset (optional)
 models:
-  defaults:
-    thinking:  anthropic/claude-sonnet-4-6          # architect, developer, reviewer…
-    executing: anthropic/claude-haiku-4-5-20251001  # explorer, fixer, seo
-    creative:  google/gemini-2.5-pro                # designer, marketing
   roles:
-    architect: anthropic/claude-sonnet-4-6   # override a specific role
-    explorer:  local/qwen2.5-coder           # local model via OpenCode
+    explorer: local/qwen2.5-coder   # local model via OpenCode
 
 # Disable roles you don't need
 roles:
@@ -134,46 +139,35 @@ Models are defined in `models.yml`. Three tiers:
 
 ### Presets
 
-Switch all tiers at once with a named preset:
-
-```yaml
-preset: google   # gemini 2.5 pro for thinking/creative, flash for executing
-```
-
-| Preset | thinking | executing | creative |
-|---|---|---|---|
-| `balanced` | claude-sonnet-4-6 | claude-haiku-4-5 | claude-sonnet-4-6 |
-| `fast` | claude-haiku-4-5 | claude-haiku-4-5 | claude-haiku-4-5 |
-| `google` | gemini-2.5-pro | gemini-2.5-flash | gemini-2.5-pro |
-| `openai` | gpt-4.1 | gpt-4.1-mini | gpt-4.1 |
-
-### Per-project overrides
-
-Mix a preset with per-role overrides:
+The framework ships with one built-in preset (`anthropic`). Define your own presets in `.agents.yml` under `presets:` — project-defined presets shadow built-ins of the same name.
 
 ```yaml
+# 1. Define presets in .agents.yml (once per project, or copy across projects)
+presets:
+  google:
+    thinking:  google/gemini-2.5-pro
+    executing: google/gemini-2.5-flash
+    creative:  google/gemini-2.5-pro
+  fast:
+    thinking:  anthropic/claude-haiku-4-5-20251001
+    executing: anthropic/claude-haiku-4-5-20251001
+    creative:  anthropic/claude-haiku-4-5-20251001
+
+# 2. Pick one
 preset: google
-models:
-  roles:
-    explorer: local/qwen2.5-coder   # override one role on top of preset
-```
-
-Or override individual tiers without a preset:
 
-```yaml
+# 3. Fine-tune on top (optional)
 models:
-  defaults:
-    creative: google/gemini-2.5-pro  # swap just the creative tier
   roles:
-    architect: openai/gpt-4.1        # one specific role
+    explorer: local/qwen2.5-coder
 ```
 
 Resolution order (highest to lowest priority):
-1. Project role override
-2. Project tier default
-3. Preset tier
-4. Framework role default
-5. Framework tier default
+1. Project role override (`models.roles.<role>`)
+2. Project tier default (`models.defaults.<tier>`)
+3. Selected preset — project presets first, built-in presets fallback
+4. Framework role default (`models.yml` roles section)
+5. Framework tier default (`models.yml` defaults section)
 
 ### Auto-update on startup (Claude Code)
 

package/models.yml

@@ -17,27 +17,10 @@ roles:
   designer: anthropic/claude-sonnet-4-6
   marketing: anthropic/claude-sonnet-4-6
 
+# Built-in presets. Projects can define their own in .agents.yml
+# and shadow these by using the same name.
 presets:
-  # Anthropic — balanced quality/cost (framework default)
-  balanced:
+  anthropic:
     thinking: anthropic/claude-sonnet-4-6
     executing: anthropic/claude-haiku-4-5-20251001
     creative: anthropic/claude-sonnet-4-6
-
-  # Anthropic — all fast/cheap
-  fast:
-    thinking: anthropic/claude-haiku-4-5-20251001
-    executing: anthropic/claude-haiku-4-5-20251001
-    creative: anthropic/claude-haiku-4-5-20251001
-
-  # Google Gemini
-  google:
-    thinking: google/gemini-2.5-pro
-    executing: google/gemini-2.5-flash
-    creative: google/gemini-2.5-pro
-
-  # OpenAI
-  openai:
-    thinking: openai/gpt-4.1
-    executing: openai/gpt-4.1-mini
-    creative: openai/gpt-4.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@ryodeushii/ai-product-team-agents",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "repository": {
     "url": "https://github.com/ryodeushii/ai-product-team-agents"
   },

package/src/config/schema.ts

@@ -27,6 +27,7 @@ export const projectConfigSchema = z.object({
     .default("checkpoint"),
   deploy: z.string().optional(),
   preset: z.string().optional(),
+  presets: z.record(z.string(), tierOverrideSchema).optional(),
   models: z
     .object({
       defaults: tierOverrideSchema.optional(),

package/src/models/resolver.ts

@@ -1,6 +1,6 @@
 // src/models/resolver.ts
 
-import type { ModelsConfig, ProjectModelsOverride, Role } from "./types";
+import type { ModelsConfig, ProjectModelsOverride, Role, Tier } from "./types";
 import { ROLE_TIERS } from "./types";
 
 export function resolveModel(
@@ -8,6 +8,7 @@ export function resolveModel(
   framework: ModelsConfig,
   project: ProjectModelsOverride = {},
   preset?: string,
+  projectPresets: Record<string, Partial<Record<Tier, string>>> = {},
 ): string {
   // 1. project role override
   if (project.roles?.[role] !== undefined) return project.roles[role]!;
@@ -16,9 +17,9 @@ export function resolveModel(
   const tier = ROLE_TIERS[role];
   if (project.defaults?.[tier] !== undefined) return project.defaults[tier]!;
 
-  // 3. preset tier
+  // 3. preset tier — project presets shadow framework presets
   if (preset !== undefined) {
-    const presetConfig = framework.presets[preset];
+    const presetConfig = projectPresets[preset] ?? framework.presets[preset];
     if (presetConfig === undefined)
       throw new Error(`Unknown preset "${preset}"`);
     if (presetConfig[tier] !== undefined) return presetConfig[tier]!;

package/src/setup/index.ts

@@ -13,7 +13,7 @@ import type { Role } from "../models/types";
 // Runs --update on every Claude Code session start so model overrides
 // from .agents.yml are always applied without manual intervention.
 const HOOK_COMMAND =
-  "bunx --bun @ryodeushii/ai-product-team-agents --update 2>/dev/null; true";
+  "bunx --bun --no-cache @ryodeushii/ai-product-team-agents --update 2>/dev/null; true";
 
 interface SetupOptions {
   projectName: string;
@@ -124,6 +124,7 @@ export async function setupProject(
           framework,
           project.models ?? {},
           project.preset,
+          project.presets ?? {},
         );
         // inject or replace model: in frontmatter
         if (content.startsWith("---")) {

package/templates/.agents.yml

@@ -19,42 +19,50 @@ autonomy: checkpoint  # supervised | checkpoint | autonomous
 # Deployment target (used by devops agent)
 # deploy: vercel     # vercel | fly | aws | gcp | docker | k8s
 
-# ─── Model overrides ────────────────────────────────────────────────────────
+# ─── Model configuration ─────────────────────────────────────────────────────
 #
 # Resolution order (highest → lowest priority):
-#   1. models.roles.<role>      — this project, specific role
-#   2. models.defaults.<tier>   — this project, whole tier
-#   3. preset.<tier>            — named preset from models.yml
-#   4. framework roles default  — models.yml roles section
-#   5. framework tier default   — models.yml defaults section
-#
-# Presets (switch all tiers at once):
-# preset: balanced   # default — anthropic sonnet/haiku
-# preset: fast       # all haiku — cheap and quick
-# preset: google     # gemini 2.5 pro/flash
-# preset: openai     # gpt-4.1/mini
+#   1. models.roles.<role>       — this project, specific role
+#   2. models.defaults.<tier>    — this project, whole tier
+#   3. presets.<selected>.<tier> — selected preset (project first, then built-in)
+#   4. framework role default    — models.yml roles section
+#   5. framework tier default    — models.yml defaults section
+#
+# ── Step 1: define your presets (optional) ──────────────────────────────────
+#
+# Built-in preset: "anthropic" (sonnet/haiku). Add your own here and they
+# shadow built-ins of the same name.
+#
+# presets:
+#   google:
+#     thinking:  google/gemini-2.5-pro
+#     executing: google/gemini-2.5-flash
+#     creative:  google/gemini-2.5-pro
+#   openai:
+#     thinking:  openai/gpt-4.1
+#     executing: openai/gpt-4.1-mini
+#     creative:  openai/gpt-4.1
+#   fast:
+#     thinking:  anthropic/claude-haiku-4-5-20251001
+#     executing: anthropic/claude-haiku-4-5-20251001
+#     creative:  anthropic/claude-haiku-4-5-20251001
+#
+# ── Step 2: pick a preset ───────────────────────────────────────────────────
+#
+# preset: anthropic   # built-in default
+# preset: google      # example project-defined preset above
+#
+# ── Step 3: fine-tune on top of the preset (optional) ───────────────────────
 #
 # models:
 #   defaults:
-#     thinking:  anthropic/claude-sonnet-4-6       # architect, developer, reviewer…
-#     executing: anthropic/claude-haiku-4-5-20251001  # explorer, fixer, seo
-#     creative:  google/gemini-2.5-pro             # designer, marketing
+#     thinking:  anthropic/claude-sonnet-4-6       # all thinking-tier roles
+#     executing: anthropic/claude-haiku-4-5-20251001
+#     creative:  google/gemini-2.5-pro
 #   roles:
-#     orchestrator: anthropic/claude-sonnet-4-6
-#     architect:    anthropic/claude-sonnet-4-6
-#     developer:    anthropic/claude-sonnet-4-6
-#     reviewer:     anthropic/claude-sonnet-4-6
-#     qa:           anthropic/claude-sonnet-4-6
-#     devops:       anthropic/claude-sonnet-4-6
-#     pm:           anthropic/claude-sonnet-4-6
-#     explorer:     anthropic/claude-haiku-4-5-20251001
-#     fixer:        anthropic/claude-haiku-4-5-20251001
-#     seo:          anthropic/claude-haiku-4-5-20251001
-#     designer:     google/gemini-2.5-pro
-#     marketing:    google/gemini-2.5-pro
-#     # local models via OpenCode:
-#     # explorer:   local/qwen2.5-coder
-#     # fixer:      local/qwen2.5-coder
+#     architect: anthropic/claude-sonnet-4-6        # one specific role
+#     explorer:  local/qwen2.5-coder                # local model via OpenCode
+#     designer:  google/gemini-2.5-pro
 
 # ─── Disable roles you don't need ───────────────────────────────────────────
 # roles: