@ryodeushii/ai-product-team-agents 0.0.1 → 0.0.3

package/README.md

@@ -32,13 +32,13 @@ A collection of agent role definitions, workflow orchestration, and dynamic mode
 Run from your target project directory:
 
 ```bash
-bunx github:ryodeushii/ai-product-team-agents <project-name>
+bunx @ryodeushii/ai-product-team-agents <project-name>
 ```
 
-Or with explicit bin name:
+Or with npm/npx:
 
 ```bash
-bunx github:ryodeushii/ai-product-team-agents/agents-setup <project-name>
+npx @ryodeushii/ai-product-team-agents <project-name>
 ```
 
 This creates:
@@ -54,11 +54,36 @@ Edit `.agents.yml`:
 
 ```yaml
 project: my-saas
-stack: [typescript, react, postgres]
-tasks: github-issues    # github-issues | linear | files | none
+
+# Tech stack — used by agents for context
+stack: [typescript, react, postgres, docker]
+
+# Task tracking integration
+tasks: github-issues   # github-issues | linear | files | none
+
+# Docs directory (agents look here for specs, ADRs, etc.)
 docs_dir: docs/
-autonomy: checkpoint    # supervised | checkpoint | autonomous
-deploy: vercel
+
+# How much the orchestrator pauses for human approval
+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
+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
+
+# Disable roles you don't need
+roles:
+  seo:       disabled
+  marketing: disabled
 ```
 
 ### 3. Use the team
@@ -97,15 +122,17 @@ Models are defined in `models.yml`. Three tiers:
 
 ### Per-project overrides
 
-In your project's `.agents.yml`:
+In your project's `.agents.yml`, override any tier or individual role:
 
 ```yaml
 models:
   defaults:
-    creative: google/gemini-2.5-pro   # override a whole tier
+    thinking:  anthropic/claude-sonnet-4-6          # all thinking-tier roles
+    executing: anthropic/claude-haiku-4-5-20251001  # all executing-tier roles
+    creative:  google/gemini-2.5-pro                # all creative-tier roles
   roles:
-    architect: openai/gpt-4.1         # override a specific role
-    explorer: local/qwen2.5-coder     # local model via OpenCode
+    architect: openai/gpt-4.1          # one specific role
+    explorer:  local/qwen2.5-coder     # local model via OpenCode
 ```
 
 Resolution order (highest to lowest priority):
@@ -118,13 +145,33 @@ Models are resolved **dynamically** — changes to `models.yml` or `.agents.yml`
 
 ### MCP server
 
-The framework ships an MCP server that exposes a `resolve_model(role, project_root)` tool for dynamic model resolution. Run it with:
+The framework ships an MCP server that exposes a `resolve_model(role, project_root)` tool for dynamic model resolution.
 
-```bash
-bun run src/mcp/server.ts
+Add to your Claude Code MCP config (`~/.claude/mcp.json` or project-level `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "agents-framework": {
+      "command": "bunx",
+      "args": ["@ryodeushii/ai-product-team-agents/agents-mcp"]
+    }
+  }
+}
 ```
 
-Add to your Claude Code or OpenCode MCP config to enable per-project model overrides.
+Or with npx:
+
+```json
+{
+  "mcpServers": {
+    "agents-framework": {
+      "command": "npx",
+      "args": ["-y", "@ryodeushii/ai-product-team-agents/agents-mcp"]
+    }
+  }
+}
+```
 
 ---
 
@@ -162,8 +209,8 @@ New projects always pause at every step regardless of this setting.
 ### Setup
 
 ```bash
-git clone <repo>
-cd agents
+git clone https://github.com/ryodeushii/ai-product-team-agents
+cd ai-product-team-agents
 bun install
 ```
 

package/package.json

@@ -1,6 +1,10 @@
 {
+  "$schema": "https://json.schemastore.org/package.json",
   "name": "@ryodeushii/ai-product-team-agents",
-  "version": "0.0.1",
+  "version": "0.0.3",
+  "repository": {
+    "url": "https://github.com/ryodeushii/ai-product-team-agents"
+  },
   "module": "index.ts",
   "type": "module",
   "files": [

package/roles/orchestrator.md

@@ -1,7 +1,7 @@
 ---
 name: orchestrator
 description: Delegates to product team specialists for optimal quality, speed, and cost
-mode: agent
+mode: primary
 ---
 
 <Role>

package/templates/.agents.yml

@@ -1,17 +1,56 @@
 project: {{project_name}}
+
+# Tech stack — used by agents for context
 stack: []
+# stack: [typescript, react, postgres, docker]
+
+# Task tracking integration
 tasks: none        # github-issues | linear | files | none
+
+# Docs directory (agents look here for specs, ADRs, etc.)
 docs_dir: docs/
+
+# How much the orchestrator pauses for human approval
 autonomy: checkpoint  # supervised | checkpoint | autonomous
-# deploy: vercel
+#   supervised  — pause before every agent handoff
+#   checkpoint  — pause at key decisions (spec, arch, deploy)
+#   autonomous  — pause only on errors or blockers
+
+# Deployment target (used by devops agent)
+# deploy: vercel     # vercel | fly | aws | gcp | docker | k8s
 
+# ─── Model overrides ────────────────────────────────────────────────────────
+#
+# Resolution order (highest → lowest priority):
+#   1. models.roles.<role>      — this project, specific role
+#   2. models.defaults.<tier>   — this project, whole tier
+#   3. framework roles default  — models.yml roles section
+#   4. framework tier default   — models.yml defaults section
+#
 # models:
 #   defaults:
-#     creative: google/gemini-2.5-pro
+#     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: openai/gpt-4.1
-#     explorer: local/qwen2.5-coder
+#     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
 
+# ─── Disable roles you don't need ───────────────────────────────────────────
 # roles:
-#   seo: disabled
+#   seo:       disabled
 #   marketing: disabled
+#   designer:  disabled