agestra 4.11.0 → 4.12.0
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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.gemini/commands/agestra/implement.toml +3 -2
- package/AGENTS.md +1 -1
- package/GEMINI.md +1 -1
- package/README.ja.md +11 -3
- package/README.ko.md +9 -1
- package/README.md +16 -6
- package/README.zh.md +11 -3
- package/agents/agestra-designer.md +1 -0
- package/agents/agestra-ideator.md +1 -0
- package/agents/agestra-implementer.md +76 -0
- package/agents/agestra-moderator.md +15 -14
- package/agents/agestra-qa.md +1 -1
- package/agents/agestra-team-lead.md +49 -40
- package/commands/design.md +8 -8
- package/commands/idea.md +8 -8
- package/commands/implement.md +32 -10
- package/commands/review.md +11 -11
- package/commands/setup.md +1 -1
- package/dist/bundle.js +9 -9
- package/hooks/user-prompt-submit.js +86 -8
- package/package.json +11 -2
- package/scripts/host-assets/codex-assets.mjs +200 -0
- package/scripts/host-assets/gemini-assets.mjs +341 -0
- package/scripts/host-assets/manifest.mjs +211 -0
- package/scripts/install-host-mcp.mjs +195 -24
- package/scripts/uninstall-host-mcp.mjs +122 -8
- package/skills/design.md +10 -10
- package/skills/idea.md +11 -11
- package/skills/leader.md +162 -0
- package/skills/provider-guide.md +18 -13
- package/skills/review.md +11 -11
- package/skills/setup.md +2 -2
|
@@ -9,8 +9,9 @@ Use the shared workflow spec below as the source of truth and adapt it to the cu
|
|
|
9
9
|
@{commands/implement.md}
|
|
10
10
|
|
|
11
11
|
Gemini-specific rules:
|
|
12
|
-
- Start with `environment_check` and `provider_list`.
|
|
12
|
+
- Start with `setup_status`, then `environment_check` and `provider_list`.
|
|
13
13
|
- Prefer Agestra MCP tools and worker orchestration over ad-hoc shell-heavy implementation plans.
|
|
14
|
-
-
|
|
14
|
+
- Treat "Leader-host only" as the Gemini-led local path when Gemini is the active host.
|
|
15
|
+
- Use the shared `agestra-implementer` role semantics for host-local code edits.
|
|
15
16
|
- Keep the final answer in the user's language.
|
|
16
17
|
"""
|
package/AGENTS.md
CHANGED
|
@@ -13,7 +13,7 @@ This repository includes a Codex-friendly host wrapper for Agestra.
|
|
|
13
13
|
- Treat `commands/*.md` as the source of truth for Agestra workflows.
|
|
14
14
|
- When the user asks for review, design, idea, or implementation help, start with `environment_check` and `provider_list`.
|
|
15
15
|
- Prefer Agestra MCP tools over ad-hoc multi-provider prompting.
|
|
16
|
-
- If
|
|
16
|
+
- If any legacy workflow text mentions "Claude only", interpret that as the current leader-host-only path when Claude is not the active host.
|
|
17
17
|
|
|
18
18
|
## Workflow Mapping
|
|
19
19
|
|
package/GEMINI.md
CHANGED
|
@@ -24,7 +24,7 @@ Each command delegates to the shared workflow specs in `commands/*.md`.
|
|
|
24
24
|
- Start orchestration requests with `environment_check` and `provider_list`.
|
|
25
25
|
- Prefer Agestra MCP tools instead of rebuilding workflows in free-form prompts.
|
|
26
26
|
- Treat `commands/*.md` and `agents/*.md` as the canonical workflow and role assets.
|
|
27
|
-
- If
|
|
27
|
+
- If any legacy shared workflow text mentions "Claude only", translate that to the current leader-host-only path when Gemini is the active host.
|
|
28
28
|
|
|
29
29
|
## Core MCP Tools
|
|
30
30
|
|
package/README.ja.md
CHANGED
|
@@ -84,7 +84,7 @@ Gemini ではリポジトリ直下の [GEMINI.md](GEMINI.md) と、[`.gemini/com
|
|
|
84
84
|
| `/agestra setup` | 初期 AI プロバイダー選択とセットアップ |
|
|
85
85
|
| `/agestra implement [task]` | Claude only または Multi-AI モードで実装を進める |
|
|
86
86
|
|
|
87
|
-
外部プロバイダーが利用可能な場合、テキストコマンド(review、design、idea
|
|
87
|
+
外部プロバイダーが利用可能な場合、テキストコマンド(review、design、idea)は直接徹底討論モードに入り、マルチ AI クロスバリデーションを行います。プロバイダーが検出されない場合、Claude が自動的に単独で作業します。
|
|
88
88
|
|
|
89
89
|
## エージェント
|
|
90
90
|
|
|
@@ -106,8 +106,11 @@ Gemini ではリポジトリ直下の [GEMINI.md](GEMINI.md) と、[`.gemini/com
|
|
|
106
106
|
| `cancel` | ワーカー、ディベート、チェーン、タスクの安全な停止 |
|
|
107
107
|
| `build-fix` | build/typecheck/lint エラーの自動診断と修正 |
|
|
108
108
|
| `trace` | エージェント実行タイムラインとフローダイアグラムの表示 |
|
|
109
|
+
| `setup` | 初期プロバイダー選択と `providers.config.json` 書き込み |
|
|
109
110
|
| `design` | Multi-AI モード選択を含む設計探索ワークフロー |
|
|
110
111
|
| `idea` | Multi-AI モード選択を含む改善案発見ワークフロー |
|
|
112
|
+
| `review` | Multi-AI モード選択を含むコード品質・セキュリティ・ハードコーディングレビューワークフロー |
|
|
113
|
+
| `leader` | マルチAI/プロバイダーオーケストレーションのエントリーポイント — 明示的なプロバイダー、ディベート、合意形成、相互検証シグナルを検知し、ドメイン分類後 `agestra-team-lead` へ委譲 |
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -137,7 +140,7 @@ Turborepo モノレポで、9 パッケージ構成です:
|
|
|
137
140
|
|
|
138
141
|
### 作業モード
|
|
139
142
|
|
|
140
|
-
**Text work**(レビュー、設計、アイデア): プロバイダーあり →
|
|
143
|
+
**Text work**(レビュー、設計、アイデア): プロバイダーあり → 徹底討論モード; なし → Claude only
|
|
141
144
|
|
|
142
145
|
**Implementation work**(team-lead orchestration):
|
|
143
146
|
- **Claude만으로** — Claude がプロジェクト/グローバルエージェントを使って直接実装します。
|
|
@@ -314,7 +317,12 @@ agestra/
|
|
|
314
317
|
│ ├── worker-manage.md # CLI ワーカー管理
|
|
315
318
|
│ ├── cancel.md # 安全な操作キャンセル
|
|
316
319
|
│ ├── build-fix.md # ビルドエラー自動修復
|
|
317
|
-
│
|
|
320
|
+
│ ├── trace.md # 実行タイムラインビューア
|
|
321
|
+
│ ├── setup.md # 初期プロバイダー選択
|
|
322
|
+
│ ├── design.md # 設計探索ワークフロー
|
|
323
|
+
│ ├── idea.md # 改善案発見ワークフロー
|
|
324
|
+
│ ├── review.md # コード品質レビューワークフロー
|
|
325
|
+
│ └── leader.md # マルチAIオーケストレーションルーター
|
|
318
326
|
├── hooks/
|
|
319
327
|
│ └── user-prompt-submit.md # ツール推奨フック
|
|
320
328
|
├── dist/
|
package/README.ko.md
CHANGED
|
@@ -148,8 +148,11 @@ winget install BurntSushi.ripgrep.MSVC
|
|
|
148
148
|
| `cancel` | 워커, 토론, 체인, 작업의 정상 종료 |
|
|
149
149
|
| `build-fix` | 빌드/타입체크/린트 에러 자동 진단 및 수정 |
|
|
150
150
|
| `trace` | 에이전트 실행 타임라인 및 흐름 다이어그램 조회 |
|
|
151
|
+
| `setup` | 초기 공급자 선택 및 `providers.config.json` 작성 |
|
|
151
152
|
| `design` | 멀티 AI 모드 선택이 포함된 아키텍처 탐색 워크플로우 |
|
|
152
153
|
| `idea` | 멀티 AI 모드 선택이 포함된 개선점 발굴 워크플로우 |
|
|
154
|
+
| `review` | 멀티 AI 모드 선택이 포함된 코드 품질·보안·하드코딩 리뷰 워크플로우 |
|
|
155
|
+
| `leader` | 멀티 AI/프로바이더 오케스트레이션 진입점 — 명시적인 프로바이더, 토론, 합의, 교차 검증 신호를 잡아 도메인을 분류한 뒤 `agestra-team-lead`에 위임 |
|
|
153
156
|
|
|
154
157
|
---
|
|
155
158
|
|
|
@@ -357,7 +360,12 @@ agestra/
|
|
|
357
360
|
│ ├── worker-manage.md # CLI 워커 관리
|
|
358
361
|
│ ├── cancel.md # 정상 작업 취소
|
|
359
362
|
│ ├── build-fix.md # 빌드 에러 자동 수정
|
|
360
|
-
│
|
|
363
|
+
│ ├── trace.md # 실행 타임라인 조회
|
|
364
|
+
│ ├── setup.md # 초기 공급자 선택
|
|
365
|
+
│ ├── design.md # 아키텍처 탐색 워크플로우
|
|
366
|
+
│ ├── idea.md # 개선점 발굴 워크플로우
|
|
367
|
+
│ ├── review.md # 코드 품질 리뷰 워크플로우
|
|
368
|
+
│ └── leader.md # 멀티 AI 오케스트레이션 라우터
|
|
361
369
|
├── hooks/
|
|
362
370
|
│ └── user-prompt-submit.md # 도구 추천 hook
|
|
363
371
|
├── dist/
|
package/README.md
CHANGED
|
@@ -124,15 +124,16 @@ All three hosts drive the same MCP server and shared workflow specs from `comman
|
|
|
124
124
|
| `/agestra idea [topic]` | Discover improvements by comparing with similar projects |
|
|
125
125
|
| `/agestra design [subject]` | Explore architecture and design trade-offs before implementation |
|
|
126
126
|
| `/agestra setup` | Initial AI provider selection and setup |
|
|
127
|
-
| `/agestra implement [task]` | Execute implementation
|
|
127
|
+
| `/agestra implement [task]` | Execute implementation through Leader-host-only or suggested AI distribution mode |
|
|
128
128
|
|
|
129
|
-
When external providers are available, text commands (review, design, idea) go directly to debate mode for multi-AI cross-validation. When no providers are detected,
|
|
129
|
+
When external providers are available, text commands (review, design, idea) go directly to consensus debate mode for multi-AI cross-validation. When no providers are detected, the current leader host works with its local specialist agent automatically. Implementation requests first classify the task and can ask whether to propose an AI task distribution.
|
|
130
130
|
|
|
131
131
|
## Agents
|
|
132
132
|
|
|
133
133
|
| Agent | Model | Role |
|
|
134
134
|
|-------|-------|------|
|
|
135
135
|
| `agestra-team-lead` | Sonnet | Full orchestrator — environment check, quality-based provider routing, work mode selection, CLI worker supervision, QA loop |
|
|
136
|
+
| `agestra-implementer` | Sonnet | Scoped implementation executor — code edits, test updates, local verification |
|
|
136
137
|
| `agestra-reviewer` | Opus | Strict quality verifier — security, orphans, spec drift, test gaps |
|
|
137
138
|
| `agestra-designer` | Opus | Architecture explorer — Socratic questioning, trade-off analysis |
|
|
138
139
|
| `agestra-ideator` | Sonnet | Improvement discoverer — web research, competitive analysis |
|
|
@@ -148,8 +149,11 @@ When external providers are available, text commands (review, design, idea) go d
|
|
|
148
149
|
| `cancel` | Graceful stop for workers, debates, chains, tasks |
|
|
149
150
|
| `build-fix` | Auto-diagnose and fix build/typecheck/lint errors |
|
|
150
151
|
| `trace` | View agent execution timeline and flow diagrams |
|
|
152
|
+
| `setup` | Initial provider selection and `providers.config.json` write |
|
|
151
153
|
| `design` | Architecture exploration workflow with multi-AI mode selection |
|
|
152
154
|
| `idea` | Improvement discovery workflow with multi-AI mode selection |
|
|
155
|
+
| `review` | Code quality / security / hardcoding review workflow with multi-AI mode selection |
|
|
156
|
+
| `leader` | Multi-AI/provider orchestration entry — catches explicit provider, debate, consensus, or cross-validation signals, classifies the domain, and hands off to `agestra-team-lead` |
|
|
153
157
|
|
|
154
158
|
---
|
|
155
159
|
|
|
@@ -179,11 +183,11 @@ Turborepo monorepo with 9 packages:
|
|
|
179
183
|
|
|
180
184
|
### Work Modes
|
|
181
185
|
|
|
182
|
-
**Text work** (review, design, idea): providers available → debate mode; no providers →
|
|
186
|
+
**Text work** (review, design, idea): providers available → consensus debate mode; no providers → Leader-host only
|
|
183
187
|
|
|
184
188
|
**Implementation work** (team-lead orchestration):
|
|
185
|
-
- **
|
|
186
|
-
-
|
|
189
|
+
- **Leader-host only** — `agestra-implementer` applies scoped code changes; reviewer/QA verify.
|
|
190
|
+
- **Suggested AI distribution** — the team lead proposes a routing table, asks for approval, then dispatches Codex/Gemini CLI workers for suitable code edits and Ollama for simple/repetitive proposal work.
|
|
187
191
|
|
|
188
192
|
---
|
|
189
193
|
|
|
@@ -349,6 +353,7 @@ agestra/
|
|
|
349
353
|
│ ├── agestra-reviewer.md # Strict quality verifier (Opus)
|
|
350
354
|
│ ├── agestra-designer.md # Architecture explorer (Opus)
|
|
351
355
|
│ ├── agestra-ideator.md # Improvement discoverer (Sonnet)
|
|
356
|
+
│ ├── agestra-implementer.md # Scoped implementation executor (Sonnet)
|
|
352
357
|
│ ├── agestra-moderator.md # Multi-mode facilitator (Sonnet)
|
|
353
358
|
│ ├── agestra-qa.md # QA verifier (Opus, no code writes)
|
|
354
359
|
│ └── agestra-team-lead.md # Full orchestrator (Sonnet, no code writes)
|
|
@@ -357,7 +362,12 @@ agestra/
|
|
|
357
362
|
│ ├── worker-manage.md # CLI worker management
|
|
358
363
|
│ ├── cancel.md # Graceful operation cancellation
|
|
359
364
|
│ ├── build-fix.md # Build error auto-repair
|
|
360
|
-
│
|
|
365
|
+
│ ├── trace.md # Execution timeline viewer
|
|
366
|
+
│ ├── setup.md # Initial provider selection
|
|
367
|
+
│ ├── design.md # Architecture exploration workflow
|
|
368
|
+
│ ├── idea.md # Improvement discovery workflow
|
|
369
|
+
│ ├── review.md # Code quality review workflow
|
|
370
|
+
│ └── leader.md # Multi-AI orchestration entry router
|
|
361
371
|
├── hooks/
|
|
362
372
|
│ └── user-prompt-submit.md # Tool recommendation hook
|
|
363
373
|
├── dist/
|
package/README.zh.md
CHANGED
|
@@ -84,7 +84,7 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
|
|
|
84
84
|
| `/agestra setup` | 初始 AI 提供方选择与设置 |
|
|
85
85
|
| `/agestra implement [task]` | 以 Claude only 或 Multi-AI 模式执行实现 |
|
|
86
86
|
|
|
87
|
-
当外部提供方可用时,文本命令(review、design、idea
|
|
87
|
+
当外部提供方可用时,文本命令(review、design、idea)直接进入终极辩论模式,进行多 AI 交叉验证。当未检测到提供方时,Claude 自动独立工作。
|
|
88
88
|
|
|
89
89
|
## 代理
|
|
90
90
|
|
|
@@ -106,8 +106,11 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
|
|
|
106
106
|
| `cancel` | 安全停止 worker、辩论、链路和任务 |
|
|
107
107
|
| `build-fix` | 自动诊断并修复 build/typecheck/lint 错误 |
|
|
108
108
|
| `trace` | 查看代理执行时间线与流程图 |
|
|
109
|
+
| `setup` | 初始提供方选择与 `providers.config.json` 写入 |
|
|
109
110
|
| `design` | 包含 Multi-AI 模式选择的架构探索工作流 |
|
|
110
111
|
| `idea` | 包含 Multi-AI 模式选择的改进发现工作流 |
|
|
112
|
+
| `review` | 包含 Multi-AI 模式选择的代码质量·安全·硬编码审查工作流 |
|
|
113
|
+
| `leader` | 多AI/提供方编排入口 — 捕获明确的提供方、辩论、共识或交叉验证信号,进行领域分类后委托给 `agestra-team-lead` |
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -137,7 +140,7 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
|
|
|
137
140
|
|
|
138
141
|
### 工作模式
|
|
139
142
|
|
|
140
|
-
**文本工作**(review、design、idea):有提供方 →
|
|
143
|
+
**文本工作**(review、design、idea):有提供方 → 终极辩论模式;无提供方 → Claude only
|
|
141
144
|
|
|
142
145
|
**实现工作**(team-lead orchestration):
|
|
143
146
|
- **Claude만으로** — Claude 直接结合项目/全局代理完成实现。
|
|
@@ -314,7 +317,12 @@ agestra/
|
|
|
314
317
|
│ ├── worker-manage.md # CLI Worker 管理
|
|
315
318
|
│ ├── cancel.md # 安全取消操作
|
|
316
319
|
│ ├── build-fix.md # 构建错误自动修复
|
|
317
|
-
│
|
|
320
|
+
│ ├── trace.md # 执行时间线查看器
|
|
321
|
+
│ ├── setup.md # 初始提供方选择
|
|
322
|
+
│ ├── design.md # 架构探索工作流
|
|
323
|
+
│ ├── idea.md # 改进发现工作流
|
|
324
|
+
│ ├── review.md # 代码质量审查工作流
|
|
325
|
+
│ └── leader.md # 多AI 编排路由器
|
|
318
326
|
├── hooks/
|
|
319
327
|
│ └── user-prompt-submit.md # 工具推荐 hook
|
|
320
328
|
├── dist/
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agestra-implementer
|
|
3
|
+
description: |
|
|
4
|
+
Implementation executor. Applies scoped code changes, writes or updates tests,
|
|
5
|
+
follows existing project patterns, and verifies the result. Receives tasks from
|
|
6
|
+
the team lead; does not orchestrate other providers.
|
|
7
|
+
|
|
8
|
+
<example>
|
|
9
|
+
Context: The team lead has decomposed a task and needs a host-local executor
|
|
10
|
+
user: "이 작업은 현재 호스트 구현 에이전트가 처리해"
|
|
11
|
+
assistant: "I'll use the agestra-implementer agent to apply the scoped code changes."
|
|
12
|
+
<commentary>
|
|
13
|
+
Implementation executor — modifies code within the assigned files and verifies.
|
|
14
|
+
</commentary>
|
|
15
|
+
</example>
|
|
16
|
+
model: sonnet
|
|
17
|
+
color: green
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
<Role>
|
|
21
|
+
You are a focused implementation executor. You receive a bounded task from the
|
|
22
|
+
leader, modify the code, add or update tests when needed, run verification, and
|
|
23
|
+
report exactly what changed. You are not the moderator, planner, or reviewer.
|
|
24
|
+
</Role>
|
|
25
|
+
|
|
26
|
+
<Operating_Principles>
|
|
27
|
+
- Stay inside the assigned scope. Do not perform unrelated cleanup or broad refactors.
|
|
28
|
+
- Follow existing project patterns before introducing new abstractions.
|
|
29
|
+
- Treat small and simple as different concepts: a small security or concurrency change may be high-risk; a large repetitive rename may be simple.
|
|
30
|
+
- Prefer tests first for behavioral changes and regressions.
|
|
31
|
+
- Preserve user or other-agent changes. If a file has unrelated edits, work with them rather than reverting them.
|
|
32
|
+
- Do not spawn other AI providers, run debates, or approve external worker changes. Escalate those decisions to the leader.
|
|
33
|
+
</Operating_Principles>
|
|
34
|
+
|
|
35
|
+
<Workflow>
|
|
36
|
+
|
|
37
|
+
### Phase 1: Intake
|
|
38
|
+
|
|
39
|
+
Confirm the task packet contains:
|
|
40
|
+
- Task goal
|
|
41
|
+
- Files allowed to modify
|
|
42
|
+
- Files useful to read
|
|
43
|
+
- Constraints and non-goals
|
|
44
|
+
- Success criteria and verification commands
|
|
45
|
+
- Design/spec reference if one exists
|
|
46
|
+
|
|
47
|
+
If the task packet is too vague to implement safely, ask the leader for clarification rather than guessing.
|
|
48
|
+
|
|
49
|
+
### Phase 2: Inspect
|
|
50
|
+
|
|
51
|
+
Read the relevant files and identify the existing local pattern. Keep the implementation approach small and compatible with surrounding code.
|
|
52
|
+
|
|
53
|
+
### Phase 3: Implement
|
|
54
|
+
|
|
55
|
+
Apply the minimal code changes needed to satisfy the task. Add tests when the change affects behavior, public contracts, generated output, provider routing, orchestration, or failure handling.
|
|
56
|
+
|
|
57
|
+
### Phase 4: Verify
|
|
58
|
+
|
|
59
|
+
Run the narrowest useful tests first, then broader checks when the change touches shared behavior. If verification fails, diagnose and fix within the assigned scope. If the failure belongs outside the task scope, report it clearly to the leader.
|
|
60
|
+
|
|
61
|
+
### Phase 5: Report
|
|
62
|
+
|
|
63
|
+
Report:
|
|
64
|
+
- Files changed
|
|
65
|
+
- Behavior changed
|
|
66
|
+
- Tests or commands run, with pass/fail status
|
|
67
|
+
- Any remaining risks or follow-up decisions for the leader
|
|
68
|
+
|
|
69
|
+
</Workflow>
|
|
70
|
+
|
|
71
|
+
<Constraints>
|
|
72
|
+
- You may edit files only for the assigned implementation task.
|
|
73
|
+
- Do not accept or reject CLI worker worktrees.
|
|
74
|
+
- Do not write final synthesis, debate, or approval documents.
|
|
75
|
+
- Do not hide failed verification. Report it and either fix it or explain why it is outside scope.
|
|
76
|
+
</Constraints>
|
|
@@ -24,6 +24,7 @@ description: |
|
|
|
24
24
|
</example>
|
|
25
25
|
model: sonnet
|
|
26
26
|
color: cyan
|
|
27
|
+
disallowedTools: Edit, NotebookEdit
|
|
27
28
|
---
|
|
28
29
|
|
|
29
30
|
<Role>
|
|
@@ -221,15 +222,15 @@ Invoked when multiple AIs have independently analyzed the same target and their
|
|
|
221
222
|
## Integrated Analysis
|
|
222
223
|
|
|
223
224
|
### Consensus Findings (agreed by all/most)
|
|
224
|
-
- [finding] — agreed by:
|
|
225
|
-
- [finding] — agreed by:
|
|
225
|
+
- [finding] — agreed by: host/reviewer, Gemini, Codex
|
|
226
|
+
- [finding] — agreed by: host/specialist, Ollama
|
|
226
227
|
|
|
227
228
|
### Notable Findings (unique perspectives)
|
|
228
229
|
- [finding] — source: Gemini (unique insight)
|
|
229
|
-
- [finding] — source:
|
|
230
|
+
- [finding] — source: host/reviewer (unique insight)
|
|
230
231
|
|
|
231
232
|
### Disputed Points
|
|
232
|
-
- [topic]:
|
|
233
|
+
- [topic]: host/reviewer says X, Codex says Y
|
|
233
234
|
- Evidence for X: ...
|
|
234
235
|
- Evidence for Y: ...
|
|
235
236
|
|
|
@@ -260,7 +261,7 @@ Invoked after Independent Aggregation has produced an initial working document.
|
|
|
260
261
|
|
|
261
262
|
**Input:** Current working doc + ordered participant list.
|
|
262
263
|
|
|
263
|
-
**Turn order within a round:** external providers alphabetical first,
|
|
264
|
+
**Turn order within a round:** external providers alphabetical first, host-backed specialist last when present. Providers are invoked sequentially so the ledger can record one validated turn at a time and later providers can see the current item state.
|
|
264
265
|
|
|
265
266
|
**Per round `N` procedure:**
|
|
266
267
|
|
|
@@ -272,7 +273,7 @@ Invoked after Independent Aggregation has produced an initial working document.
|
|
|
272
273
|
- Current consensus item index from the ledger.
|
|
273
274
|
- JSON response contract from the turn packet.
|
|
274
275
|
|
|
275
|
-
b. Send the review request through the MCP moderator engine. For
|
|
276
|
+
b. Send the review request through the MCP moderator engine. For the host-backed specialist, spawn the appropriate specialist agent (`agestra-ideator`, `agestra-reviewer`, etc.) only when the engine requests that participant turn. For external providers, use provider MCP calls controlled by the engine.
|
|
276
277
|
|
|
277
278
|
c. Validate the JSON response and append accepted stance/comment records to the consensus ledger. The debate markdown is regenerated from the ledger; do not create one markdown document per provider turn.
|
|
278
279
|
|
|
@@ -321,7 +322,7 @@ The idea/review final doc is for **humans skimming after the fact**, not for mac
|
|
|
321
322
|
#### 2. 참여자 및 라운드 요약
|
|
322
323
|
|
|
323
324
|
Plain list (not a table):
|
|
324
|
-
- **참여자:** `
|
|
325
|
+
- **참여자:** `host/ideator`, `codex`, ... — one line per participant, with a short note if any dropped out mid-flow and why.
|
|
325
326
|
- **라운드:** `{N}/{max}` with a one-sentence arc ("Round 1: big-picture disagreement on tool scope. Round 2: narrowed to implementation priorities. Round 3: consensus.").
|
|
326
327
|
- **사용자 제약:** every binding constraint the user gave during Phase 1, verbatim.
|
|
327
328
|
|
|
@@ -339,7 +340,7 @@ One **subsection per accepted idea** (not a single table row). For each idea:
|
|
|
339
340
|
**노력 · 우선순위.** {effort} · {priority} — 협의 결과면 그렇게 표기 ("Round 2 protocol: 노력 S→M, codex 근거 채택").
|
|
340
341
|
|
|
341
342
|
**동의 현황.**
|
|
342
|
-
- 🟢 agree:
|
|
343
|
+
- 🟢 agree: host/ideator, codex
|
|
343
344
|
- 🟡 agree-with-note: gemini — "MEDIUM이 더 현실적, HIGH는 낙관적"
|
|
344
345
|
- 모두가 agree이면 "전원 agree — 이견 없음." 한 줄로 대체.
|
|
345
346
|
```
|
|
@@ -371,7 +372,7 @@ One subsection per item where Round `N-final` still had any `disagree`. Format:
|
|
|
371
372
|
마지막에 한 번만 나오는 축약 표 — 3~5번 섹션의 중복이 아니라 **스캔용**. 열은 아이디어 ID, 행은 프로바이더, 셀은 🟢/🟡/🔴만.
|
|
372
373
|
|
|
373
374
|
```markdown
|
|
374
|
-
| Idea |
|
|
375
|
+
| Idea | host/ideator | codex | gemini |
|
|
375
376
|
|------|----------------|-------|--------|
|
|
376
377
|
| IDEA-01 Auto-focus on Create | 🟢 | 🟢 | 🟢 |
|
|
377
378
|
| IDEA-02 숫자 키 타입 선택 | 🟢 | 🟡 | 🟢 |
|
|
@@ -427,9 +428,9 @@ Invoked by team-lead when CLI workers have produced overlapping file changes tha
|
|
|
427
428
|
<Turn_Management>
|
|
428
429
|
The order within each round (Structured Debate and Document Review modes):
|
|
429
430
|
1. External providers first (alphabetical order)
|
|
430
|
-
2.
|
|
431
|
+
2. Host-backed specialist last (or with specialist perspective via `claude_comment` in legacy manual mode)
|
|
431
432
|
|
|
432
|
-
This ensures
|
|
433
|
+
This ensures the host specialist can respond to external opinions while the JSON ledger records one validated provider turn at a time. In Structured Debate the participant list is taken **verbatim** from the caller (subject only to `auto_inject_specialists` in D13 and `exclude_participants`); no automatic provider filtering is applied.
|
|
433
434
|
</Turn_Management>
|
|
434
435
|
|
|
435
436
|
<Consensus_Criteria>
|
|
@@ -441,12 +442,12 @@ If `max_rounds` is hit with open proposals, the moderator surfaces the choice to
|
|
|
441
442
|
<Constraints>
|
|
442
443
|
- Default `max_rounds = 10`. On hitting the limit the moderator MUST call `AskUserQuestion` — it does not silently extend or truncate.
|
|
443
444
|
- Do NOT express your own opinion on the debate topic. You are a facilitator, not a participant.
|
|
444
|
-
- When a registered host-backed
|
|
445
|
+
- When a registered host-backed provider is available, include the host specialist turn. Otherwise either use manual `claude_comment` turns for legacy compatibility or proceed without a host specialist and state that limitation clearly.
|
|
445
446
|
- When a specialist or reviewer agent is running in the background, wait for its actual output. Do not substitute your own analysis or stop it after a short empty-output check.
|
|
446
447
|
- Poll long-running background reviewers at reasonable intervals (about once per minute). Treat them as stalled only on explicit error, user cancellation, or no visible progress for at least 8 minutes; allow up to 15 minutes for large review scopes.
|
|
447
448
|
- Summarize neutrally. Do not favor any provider's position.
|
|
448
|
-
- If only one external provider is available, still run the process (
|
|
449
|
-
- If no external providers are available, inform the user and suggest "
|
|
449
|
+
- If only one external provider is available, still run the process (host specialist + 1 provider is a valid 2-party discussion).
|
|
450
|
+
- If no external providers are available, inform the user and suggest "Leader-host only" mode instead.
|
|
450
451
|
- Never translate participant-authored content (proposal titles, vote reasons, individual-review bodies). Translate only moderator-authored narration via i18n bundles.
|
|
451
452
|
- Communicate in the user's language for moderator-authored narration; respect locale resolution order.
|
|
452
453
|
</Constraints>
|
package/agents/agestra-qa.md
CHANGED
|
@@ -199,7 +199,7 @@ Do NOT duplicate the reviewer's checklist. If you suspect code quality issues ou
|
|
|
199
199
|
- READ-ONLY. You must not modify any files.
|
|
200
200
|
- Every finding must cite a specific file and line number.
|
|
201
201
|
- Do not speculate. If you cannot verify an item, mark it as UNVERIFIABLE with explanation.
|
|
202
|
-
- Do not skip the cross-validation step. If no external providers are available, note it and proceed with
|
|
202
|
+
- Do not skip the cross-validation step. If no external providers are available, note it and proceed with Leader-host-only verification.
|
|
203
203
|
- Do not issue PASS if any design requirement is NOT IMPLEMENTED.
|
|
204
204
|
- Do not issue PASS if build or tests fail.
|
|
205
205
|
- Run actual commands (tsc, vitest, etc.) — do not guess test results.
|