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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +35 -8
  2. package/package.json +1 -1
  3. package/roles/orchestrator.md +1 -1
  4. package/templates/.agents.yml +44 -5
package/README.md CHANGED
@@ -54,11 +54,36 @@ Edit `.agents.yml`:
54
54
 
55
55
  ```yaml
56
56
  project: my-saas
57
- stack: [typescript, react, postgres]
58
- tasks: github-issues # github-issues | linear | files | none
57
+
58
+ # Tech stack — used by agents for context
59
+ stack: [typescript, react, postgres, docker]
60
+
61
+ # Task tracking integration
62
+ tasks: github-issues # github-issues | linear | files | none
63
+
64
+ # Docs directory (agents look here for specs, ADRs, etc.)
59
65
  docs_dir: docs/
60
- autonomy: checkpoint # supervised | checkpoint | autonomous
61
- deploy: vercel
66
+
67
+ # How much the orchestrator pauses for human approval
68
+ autonomy: checkpoint # supervised | checkpoint | autonomous
69
+
70
+ # Deployment target (used by devops agent)
71
+ deploy: vercel # vercel | fly | aws | gcp | docker | k8s
72
+
73
+ # Model overrides — all optional, framework defaults apply otherwise
74
+ models:
75
+ defaults:
76
+ thinking: anthropic/claude-sonnet-4-6 # architect, developer, reviewer…
77
+ executing: anthropic/claude-haiku-4-5-20251001 # explorer, fixer, seo
78
+ creative: google/gemini-2.5-pro # designer, marketing
79
+ roles:
80
+ architect: anthropic/claude-sonnet-4-6 # override a specific role
81
+ explorer: local/qwen2.5-coder # local model via OpenCode
82
+
83
+ # Disable roles you don't need
84
+ roles:
85
+ seo: disabled
86
+ marketing: disabled
62
87
  ```
63
88
 
64
89
  ### 3. Use the team
@@ -97,15 +122,17 @@ Models are defined in `models.yml`. Three tiers:
97
122
 
98
123
  ### Per-project overrides
99
124
 
100
- In your project's `.agents.yml`:
125
+ In your project's `.agents.yml`, override any tier or individual role:
101
126
 
102
127
  ```yaml
103
128
  models:
104
129
  defaults:
105
- creative: google/gemini-2.5-pro # override a whole tier
130
+ thinking: anthropic/claude-sonnet-4-6 # all thinking-tier roles
131
+ executing: anthropic/claude-haiku-4-5-20251001 # all executing-tier roles
132
+ creative: google/gemini-2.5-pro # all creative-tier roles
106
133
  roles:
107
- architect: openai/gpt-4.1 # override a specific role
108
- explorer: local/qwen2.5-coder # local model via OpenCode
134
+ architect: openai/gpt-4.1 # one specific role
135
+ explorer: local/qwen2.5-coder # local model via OpenCode
109
136
  ```
110
137
 
111
138
  Resolution order (highest to lowest priority):
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@ryodeushii/ai-product-team-agents",
4
- "version": "0.0.2",
4
+ "version": "0.0.3",
5
5
  "repository": {
6
6
  "url": "https://github.com/ryodeushii/ai-product-team-agents"
7
7
  },
package/roles/orchestrator.md CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: orchestrator
3
3
  description: Delegates to product team specialists for optimal quality, speed, and cost
4
- mode: agent
4
+ mode: primary
5
5
  ---
6
6
 
7
7
  <Role>
package/templates/.agents.yml CHANGED
@@ -1,17 +1,56 @@
1
1
  project: {{project_name}}
2
+
3
+ # Tech stack — used by agents for context
2
4
  stack: []
5
+ # stack: [typescript, react, postgres, docker]
6
+
7
+ # Task tracking integration
3
8
  tasks: none # github-issues | linear | files | none
9
+
10
+ # Docs directory (agents look here for specs, ADRs, etc.)
4
11
  docs_dir: docs/
12
+
13
+ # How much the orchestrator pauses for human approval
5
14
  autonomy: checkpoint # supervised | checkpoint | autonomous
6
- # deploy: vercel
15
+ # supervised — pause before every agent handoff
16
+ # checkpoint — pause at key decisions (spec, arch, deploy)
17
+ # autonomous — pause only on errors or blockers
18
+
19
+ # Deployment target (used by devops agent)
20
+ # deploy: vercel # vercel | fly | aws | gcp | docker | k8s
7
21
 
22
+ # ─── Model overrides ────────────────────────────────────────────────────────
23
+ #
24
+ # Resolution order (highest → lowest priority):
25
+ # 1. models.roles.<role> — this project, specific role
26
+ # 2. models.defaults.<tier> — this project, whole tier
27
+ # 3. framework roles default — models.yml roles section
28
+ # 4. framework tier default — models.yml defaults section
29
+ #
8
30
  # models:
9
31
  # defaults:
10
- # creative: google/gemini-2.5-pro
32
+ # thinking: anthropic/claude-sonnet-4-6 # architect, developer, reviewer…
33
+ # executing: anthropic/claude-haiku-4-5-20251001 # explorer, fixer, seo
34
+ # creative: google/gemini-2.5-pro # designer, marketing
11
35
  # roles:
12
- # architect: openai/gpt-4.1
13
- # explorer: local/qwen2.5-coder
36
+ # orchestrator: anthropic/claude-sonnet-4-6
37
+ # architect: anthropic/claude-sonnet-4-6
38
+ # developer: anthropic/claude-sonnet-4-6
39
+ # reviewer: anthropic/claude-sonnet-4-6
40
+ # qa: anthropic/claude-sonnet-4-6
41
+ # devops: anthropic/claude-sonnet-4-6
42
+ # pm: anthropic/claude-sonnet-4-6
43
+ # explorer: anthropic/claude-haiku-4-5-20251001
44
+ # fixer: anthropic/claude-haiku-4-5-20251001
45
+ # seo: anthropic/claude-haiku-4-5-20251001
46
+ # designer: google/gemini-2.5-pro
47
+ # marketing: google/gemini-2.5-pro
48
+ # # local models via OpenCode:
49
+ # # explorer: local/qwen2.5-coder
50
+ # # fixer: local/qwen2.5-coder
14
51
 
52
+ # ─── Disable roles you don't need ───────────────────────────────────────────
15
53
  # roles:
16
- # seo: disabled
54
+ # seo: disabled
17
55
  # marketing: disabled
56
+ # designer: disabled