agestra 4.14.2 → 4.14.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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/agents/agestra-team-lead.md +73 -1
- package/commands/design.md +21 -7
- package/commands/idea.md +23 -8
- package/commands/implement.md +4 -4
- package/commands/qa.md +43 -15
- package/commands/research.md +4 -1
- package/commands/review.md +22 -8
- package/commands/security.md +22 -8
- package/commands/setup.md +1 -1
- package/dist/bundle.js +7 -7
- package/package.json +1 -1
- package/scripts/host-assets/categories.mjs +3 -0
- package/skills/design.md +20 -6
- package/skills/idea.md +23 -8
- package/skills/leader.md +27 -7
- package/skills/provider-guide.md +14 -2
- package/skills/qa.md +39 -14
- package/skills/research.md +4 -0
- package/skills/review.md +23 -9
- package/skills/security.md +21 -7
- package/skills/setup.md +5 -2
package/package.json
CHANGED
package/skills/design.md
CHANGED
|
@@ -68,7 +68,7 @@ Greenfield: no relevant source code exists for the feature. Brownfield: modifyin
|
|
|
68
68
|
- Anything the user wants to explain in their own words.
|
|
69
69
|
|
|
70
70
|
**Host research consensus inputs (mandatory before provider fan-out):**
|
|
71
|
-
- "Provider-backed design
|
|
71
|
+
- "Provider-backed design can use Host-led, Council, or Provider-seeded research. What should the selected investigation look for: existing patterns in this codebase, prior art / competing implementations, constraints / regulations, current-information needs, or skip?"
|
|
72
72
|
- "Should any participant or lens receive a specific research assignment, or should team-lead choose the assignment rows?"
|
|
73
73
|
|
|
74
74
|
**After each user answer:**
|
|
@@ -93,9 +93,22 @@ Greenfield: no relevant source code exists for the feature. Brownfield: modifyin
|
|
|
93
93
|
|
|
94
94
|
**Hard gate:** Do not start `environment_check`, `provider_list`, team-lead handoff, or provider fan-out until the design subject and need-to-know dimensions have explicit user-provided values, explicit user-requested defaults, or explicit defer/skip values. If the user says "enough" before ambiguity is low, record the residual risk in the handoff packet instead of silently filling gaps.
|
|
95
95
|
|
|
96
|
-
### Phase 2:
|
|
96
|
+
### Phase 2: Choose 조사 방식
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
Before provider fan-out, ask once which investigation topology to use unless the user already specified it:
|
|
99
|
+
|
|
100
|
+
| Option | Description |
|
|
101
|
+
|--------|-------------|
|
|
102
|
+
| **Host-led Research (Recommended)** | The current host/native researchers inspect the codebase and prepare the first design evidence packet; providers challenge and debate it. Record internally as `host-seeded`. |
|
|
103
|
+
| **Council Research** | Host and providers independently investigate design options with assigned lenses before consolidation and debate. |
|
|
104
|
+
| **Provider-seeded Research** | One selected provider creates the first design seed/evidence artifact; host and other providers challenge it. |
|
|
105
|
+
| **Decide automatically** | Use Host-led for bounded design work, Council for broad architecture exploration, and Provider-seeded only when the user named a provider to lead. |
|
|
106
|
+
|
|
107
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/latency gate, not a design clarification. If a host-level no-questions directive prevents asking, choose Host-led Research (`host-seeded`) and report that broader provider investigation was skipped. If Provider-seeded Research is selected and the seed provider is not explicit, record the seed provider as pending; after provider availability is listed, ask which available provider should seed. Do not infer it.
|
|
108
|
+
|
|
109
|
+
### Phase 3: Route execution
|
|
110
|
+
|
|
111
|
+
This skill is **information-gathering only**. After Phases 1-2, hand off to the appropriate executor based on environment.
|
|
99
112
|
|
|
100
113
|
Call `environment_check` and `provider_list`.
|
|
101
114
|
|
|
@@ -105,7 +118,7 @@ Call `environment_check` and `provider_list`.
|
|
|
105
118
|
Stop Agestra orchestration and tell the user to run `/agestra setup` to enable a provider, or ask the current host to do design work directly outside Agestra. Do not spawn a host specialist from this skill.
|
|
106
119
|
|
|
107
120
|
**Provider-backed path — 1+ external providers available (multi-AI):**
|
|
108
|
-
Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selected**. Provider-backed design uses the
|
|
121
|
+
Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selected**. Provider-backed design uses the selected research topology flow:
|
|
109
122
|
|
|
110
123
|
```text
|
|
111
124
|
호스트가 조사한다.
|
|
@@ -125,7 +138,8 @@ External AI research and debate run in separate fresh sessions, even when the sa
|
|
|
125
138
|
- **Idea decision record:** {path under `docs/ideas/` if the design came from a saved idea}
|
|
126
139
|
- **Existing design docs:** {paths under `docs/plans/` if any}
|
|
127
140
|
- **Consensus domain:** `design`
|
|
128
|
-
- **Research
|
|
141
|
+
- **Research topology / 조사 방식:** {selected in Phase 2 — `host-seeded`, `council`, `provider-seeded`, or `automatic`}
|
|
142
|
+
- **Research notes:** {what the selected investigation should look for — existing patterns, prior art, constraints, current-information needs}
|
|
129
143
|
- **Research assignments:** {optional participant/lens rows for `research_assignments`, or "team-lead choose"}
|
|
130
144
|
- **Available providers:** {from environment_check}
|
|
131
145
|
- **Requested providers:** {explicit names captured from the user's wording, e.g. `[codex, gemini]`; otherwise "all available"}
|
|
@@ -135,7 +149,7 @@ External AI research and debate run in separate fresh sessions, even when the sa
|
|
|
135
149
|
|
|
136
150
|
Team-lead owns:
|
|
137
151
|
- Building the participant team (host designer + external providers + auto-injected specialists when applicable)
|
|
138
|
-
-
|
|
152
|
+
- Resolving the selected research topology, then calling `agent_research_consensus_start` when investigation fan-out is required or `agent_consensus_start` with prepared `initial_aggregation.items` when seed/host evidence is already available.
|
|
139
153
|
- Ensuring external AI research and debate use separate fresh sessions.
|
|
140
154
|
- Never creating a bundled research pseudo-participant and never carrying research bundles through `source_documents`.
|
|
141
155
|
- Inspecting `aggregation_record.json`, `open_debate_items.json`, `round_packet.{round}.{provider}.json`, the aggregation document, and the leader-authored final decision document under `docs/agestra/`.
|
package/skills/idea.md
CHANGED
|
@@ -12,7 +12,7 @@ description: >
|
|
|
12
12
|
|
|
13
13
|
Idea and inspiration discovery. Help the user find what might be worth making, changing, or exploring next. Research similar projects when requested, collect user wishes and reference points, compare capabilities, and generate grounded but creative possibilities without filtering too early for implementation feasibility.
|
|
14
14
|
|
|
15
|
-
Provider-backed idea discovery uses the
|
|
15
|
+
Provider-backed idea discovery uses the selected research topology flow:
|
|
16
16
|
|
|
17
17
|
```text
|
|
18
18
|
호스트가 조사한다.
|
|
@@ -65,7 +65,7 @@ Before researching, understand what the user needs through targeted questions. A
|
|
|
65
65
|
| Area | "What kind of ideas should we explore? (design, usability, onboarding, new features, automation, performance, accessibility, docs, DX, integrations, monetization, community, other)" | Narrow or widen the search space |
|
|
66
66
|
| User wishes | "What have users asked for, complained about, or seemed to want? Choose none if there are no known signals." | Anchor ideas in real demand |
|
|
67
67
|
| Current audience | "Who uses this now, and what do they use it for most?" | Keep ideas relevant to actual users |
|
|
68
|
-
| Research notes | "Provider-backed idea discovery
|
|
68
|
+
| Research notes | "Provider-backed idea discovery can use Host-led, Council, or Provider-seeded research. What should the selected investigation look for: competitors, user praise/complaints, current information, source constraints, or skip?" | Shape the research assignments |
|
|
69
69
|
| Research assignments | "Should any participant or lens receive a specific research assignment, or should team-lead choose the assignment rows?" | Capture preferred division of labor |
|
|
70
70
|
| Identity and boundaries | "What should not change about this project? Any identity, workflow, or area you want to protect? Choose unspecified if you are not sure." | Avoid ideas that break what already works |
|
|
71
71
|
| Free notes | "Anything else you want me to keep in mind? Choose skip if not." | Capture taste, hunches, and side constraints |
|
|
@@ -85,7 +85,7 @@ After gathering context:
|
|
|
85
85
|
| Must-have | "Is there one point that absolutely should exist?" | Preserve the user's spark |
|
|
86
86
|
| Inspiration | "Are there apps, games, sites, or tools you want to reference? Choose none if there are no references." | Seed taste and competitor research |
|
|
87
87
|
| Difference | "How should this feel different from existing apps? Choose unspecified if you are not sure." | Encourage differentiation without over-constraining |
|
|
88
|
-
| Research notes | "Provider-backed idea discovery
|
|
88
|
+
| Research notes | "Provider-backed idea discovery can use Host-led, Council, or Provider-seeded research. What should the selected investigation look for: similar apps, user praise/complaints, current information, source constraints, or skip?" | Shape the research assignments |
|
|
89
89
|
| Research assignments | "Should any participant or lens receive a specific research assignment, or should team-lead choose the assignment rows?" | Capture preferred division of labor |
|
|
90
90
|
| Free notes | "Anything else you want to say, even if it is rough? Choose skip if not." | Let vague inspiration stay useful |
|
|
91
91
|
|
|
@@ -93,9 +93,22 @@ After gathering context:
|
|
|
93
93
|
|
|
94
94
|
**Early exit:** If the user provides all required fields upfront, skip redundant questions and proceed to Phase 2. If any required field is missing, ask for it one at a time.
|
|
95
95
|
|
|
96
|
-
### Phase 2:
|
|
96
|
+
### Phase 2: Choose 조사 방식
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
Before provider fan-out, ask once which investigation topology to use unless the user already specified it:
|
|
99
|
+
|
|
100
|
+
| Option | Description |
|
|
101
|
+
|--------|-------------|
|
|
102
|
+
| **Host-led Research (Recommended)** | The current host prepares the first evidence packet, then providers challenge and debate it. Fastest and lowest-cost default. Record internally as `host-seeded`. |
|
|
103
|
+
| **Council Research** | Host and providers independently investigate assigned lenses before consolidation and debate. Stronger for broad/open-ended exploration. |
|
|
104
|
+
| **Provider-seeded Research** | One selected provider creates the first seed/evidence artifact, then host and other providers challenge it. |
|
|
105
|
+
| **Decide automatically** | Use Host-led for bounded topics, Council for broad idea discovery, and Provider-seeded only when the user named a provider to lead. |
|
|
106
|
+
|
|
107
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/latency gate, not a domain clarification. If a host-level no-questions directive prevents asking, choose Host-led Research (`host-seeded`) and report that broader provider investigation was skipped. If Provider-seeded Research is selected and the seed provider is not explicit, record the seed provider as pending; after provider availability is listed, ask which available provider should seed. Do not infer it.
|
|
108
|
+
|
|
109
|
+
### Phase 3: Route execution
|
|
110
|
+
|
|
111
|
+
This skill is **information-gathering only**. After Phases 1-2, hand off to the appropriate executor based on environment.
|
|
99
112
|
|
|
100
113
|
Call `environment_check` and `provider_list`.
|
|
101
114
|
|
|
@@ -110,10 +123,11 @@ Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selec
|
|
|
110
123
|
- **Domain:** `idea`
|
|
111
124
|
- **Mode:** `multi-ai` (pre-selected — team-lead must NOT re-ask orchestration mode)
|
|
112
125
|
- **Idea mode:** `A` (existing project) or `B` (new project) — from Phase 1 detection
|
|
113
|
-
- **Interview answers:** {all dimensions captured in Phase 1 — Intent/Area/User wishes/Current audience/Research
|
|
126
|
+
- **Interview answers:** {all dimensions captured in Phase 1 — Intent/Area/User wishes/Current audience/Research notes/Identity and boundaries/Free notes for Mode A; Kind/Seed/Audience/Must-have/Inspiration/Difference/Research notes/Free notes for Mode B}
|
|
114
127
|
- **Project context:** {README summary, current feature set if Mode A; seed idea verbatim if Mode B}
|
|
115
128
|
- **Consensus domain:** `idea`
|
|
116
|
-
- **Research
|
|
129
|
+
- **Research topology / 조사 방식:** {selected in Phase 2 — `host-seeded`, `council`, `provider-seeded`, or `automatic`}
|
|
130
|
+
- **Research notes:** {what the selected investigation should look for}
|
|
117
131
|
- **Research assignments:** {optional participant/lens rows for `research_assignments`, or "team-lead choose"}
|
|
118
132
|
- **Available providers:** {from environment_check}
|
|
119
133
|
- **Requested providers:** {explicit names captured from the user's wording; otherwise "all available"}
|
|
@@ -123,7 +137,8 @@ Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selec
|
|
|
123
137
|
|
|
124
138
|
Team-lead owns:
|
|
125
139
|
- Building the participant team. Any host ideator is invoked through the active host layer; external providers are MCP/CLI/chat participants only.
|
|
126
|
-
-
|
|
140
|
+
- Resolving the selected research topology, then calling `agent_research_consensus_start` when investigation fan-out is required or `agent_consensus_start` with prepared `initial_aggregation.items` when seed/host evidence is already available.
|
|
141
|
+
- For research fan-out, pass `domain: "idea"` to `agent_research_consensus_start`.
|
|
127
142
|
- Ensuring external AI research and debate use separate fresh sessions.
|
|
128
143
|
- Never creating a bundled research pseudo-participant and never carrying research bundles through `source_documents`.
|
|
129
144
|
- Writing the project-facing idea decision record under `docs/agestra/YYYY-MM-DD-idea-<session-id>-result.md` from the aggregation document, JSON artifacts, consensus state, and the user's interview answers. Preserve disputed positions and weak-evidence flags rather than averaging them away.
|
package/skills/leader.md
CHANGED
|
@@ -30,9 +30,11 @@ off to the appropriate Agestra workflow with multi-AI mode pre-selected.
|
|
|
30
30
|
|
|
31
31
|
Plain review/QA/check requests without `/agestra` or explicit multi-AI/provider wording stay with the current host; they are not Agestra natural-language auto-triggers.
|
|
32
32
|
|
|
33
|
-
This skill is a **thin router** — it does not perform the work itself.
|
|
34
|
-
|
|
35
|
-
|
|
33
|
+
This skill is a **thin router** — it does not perform the work itself. It should
|
|
34
|
+
auto-classify clear requests and route them quietly. It shows the domain menu
|
|
35
|
+
only when the request is genuinely ambiguous. The matching domain skill gathers
|
|
36
|
+
domain-specific requirements, then the `agestra:agestra-team-lead` agent executes
|
|
37
|
+
the actual orchestration.
|
|
36
38
|
|
|
37
39
|
## When NOT to use
|
|
38
40
|
|
|
@@ -98,6 +100,14 @@ Distinguish `review` vs `qa`:
|
|
|
98
100
|
- Inform the user once: "이 작업은 N단계로 나눕니다 — 먼저 X, 다음 Y." (in user's language)
|
|
99
101
|
- Run them sequentially via repeated domain-skill → team-lead handoffs.
|
|
100
102
|
|
|
103
|
+
**Clear-domain requests:**
|
|
104
|
+
- Do not ask "which command?" when the domain is clear from the request.
|
|
105
|
+
- Route directly to the matching domain skill.
|
|
106
|
+
- Domain-specific cost, trust, runtime-depth, write, provider, or research-topology gates
|
|
107
|
+
are asked inside the domain skill or by team-lead, not here.
|
|
108
|
+
- If the user says "알아서", "decide automatically", or equivalent and the
|
|
109
|
+
domain is clear, pass `automatic` intent forward instead of opening the menu.
|
|
110
|
+
|
|
101
111
|
**Ambiguous requests** (multi-AI signal present but no clear domain):
|
|
102
112
|
- Ask ONE targeted question via `AskUserQuestion` (or a plain numbered prompt as fallback).
|
|
103
113
|
- Present the SIX options below. Match the question language to the user's language.
|
|
@@ -175,7 +185,7 @@ the domain skill should read:
|
|
|
175
185
|
| `design` | `agestra:design` | |
|
|
176
186
|
| `idea` | `agestra:idea` | |
|
|
177
187
|
| `review` | `agestra:review` | |
|
|
178
|
-
| `qa` | `agestra:qa` | Verification only. Asks QA
|
|
188
|
+
| `qa` | `agestra:qa` | Verification only. Asks Host-only vs QA Brigade, then QA depth; provider-backed QA Brigade is optional and falls back to Host-only/setup guidance when no providers are available |
|
|
179
189
|
| `security` | `agestra:security` | Dedicated security audit |
|
|
180
190
|
| `implement` (default) | `agestra:implement` | Code changes + QA. Team-lead runs provider-backed code execution, host-owned evidence collection, and Phase 5M structured QA debate |
|
|
181
191
|
|
|
@@ -193,13 +203,23 @@ The domain skill is responsible for:
|
|
|
193
203
|
|
|
194
204
|
1. Skipping its own domain-classification step (already done here)
|
|
195
205
|
2. Running its information-gathering phase (Clarity Gate, scope, focus areas, Mode A/B)
|
|
196
|
-
3.
|
|
197
|
-
|
|
206
|
+
3. Capturing the domain's `조사 방식` / research topology gate when provider-backed
|
|
207
|
+
investigation is possible: `host-seeded`, `council`, `provider-seeded`, or `automatic`
|
|
208
|
+
4. Building the handoff packet for `agestra:agestra-team-lead`
|
|
209
|
+
5. Invoking team-lead with `Mode: multi-ai` pre-selected so team-lead does not re-interview
|
|
198
210
|
|
|
199
211
|
team-lead then owns:
|
|
200
212
|
|
|
201
213
|
- Building the participant team from the reduced host-native agents (`agestra-research`, `agestra-debate`, `agestra-implementer`) and named external providers. External providers participate through MCP/CLI/chat routes and do not create or manage native host agents.
|
|
202
|
-
-
|
|
214
|
+
- Resolving the selected research topology into concrete host-native research
|
|
215
|
+
assignments, external provider assignments, seed-provider work, and debate
|
|
216
|
+
participants. If topology is missing and asking is allowed, team-lead asks one
|
|
217
|
+
concise topology question; if no-questions mode blocks asking, team-lead uses
|
|
218
|
+
host-seeded research and reports that choice.
|
|
219
|
+
- Consensus orchestration: `agent_research_consensus_start` when the selected
|
|
220
|
+
topology requires investigation before debate, or `agent_consensus_start` from
|
|
221
|
+
prepared `initial_aggregation` when the domain skill/team-lead already has
|
|
222
|
+
sufficient evidence
|
|
203
223
|
- Approval gate (`agent_debate_approve` / `_continue` / `_reject`)
|
|
204
224
|
- For `implement`: code edits via `agestra:agestra-implementer` or CLI workers
|
|
205
225
|
(`cli_worker_spawn`), then `agent_changes_review` before merge
|
package/skills/provider-guide.md
CHANGED
|
@@ -58,7 +58,19 @@ Available via `/agestra review`, `/agestra qa`, `/agestra security`, `/agestra d
|
|
|
58
58
|
|------|-------------|-------------|
|
|
59
59
|
| **Consensus debate** | Independent work → aggregation → review rounds until consensus | Providers available (default) |
|
|
60
60
|
|
|
61
|
-
When providers are enabled,
|
|
61
|
+
When providers are enabled, explicit multi-AI/provider requests can go directly
|
|
62
|
+
to the matching domain skill, but the domain skill still owns its question sheet
|
|
63
|
+
and cost gates before team-lead dispatches providers. Idea, design, review,
|
|
64
|
+
security, and explicit research workflows ask for `조사 방식` / research topology
|
|
65
|
+
when provider-backed investigation is possible: Host-led Research, Council
|
|
66
|
+
Research, Provider-seeded Research, or Decide automatically.
|
|
67
|
+
|
|
68
|
+
`/agestra qa` is the exception: it must ask for Host-only QA, QA Brigade, or
|
|
69
|
+
automatic selection because configured providers alone should not turn a
|
|
70
|
+
verification request into a long provider-research run.
|
|
71
|
+
If a host-level no-questions directive prevents that gate, use Host-only QA and
|
|
72
|
+
report that provider fan-out was skipped. Trust registration remains a separate
|
|
73
|
+
security approval gate and cannot be inferred from no-questions instructions.
|
|
62
74
|
When no providers are enabled, run setup or handle the task directly outside Agestra.
|
|
63
75
|
|
|
64
76
|
### Implementation Work (실제 구현)
|
|
@@ -197,7 +209,7 @@ Phase 7: Report
|
|
|
197
209
|
- `Multi-AI`: CLI workers + capability-matched local/tool model work for parallelized execution; team lead supervises and merges
|
|
198
210
|
|
|
199
211
|
**QA domain:**
|
|
200
|
-
- `/agestra qa` verifies existing work without code changes. It asks Standard vs Full E2E depth, writes a QA report under `docs/reports/qa/`, collects host-owned evidence, runs Connection / Boundary Checks (API/consumer data shape, route/link mapping, state transition completeness, command/result consistency, and E2E artifact interpretation)
|
|
212
|
+
- `/agestra qa` verifies existing work without code changes. It first asks Host-only QA vs QA Brigade vs automatic selection, then asks Standard vs Full E2E depth, writes a QA report under `docs/reports/qa/`, collects host-owned evidence, and runs Connection / Boundary Checks (API/consumer data shape, route/link mapping, state transition completeness, command/result consistency, and E2E artifact interpretation). QA Brigade cross-checks host-prepared findings through a short consensus round; it does not start with external provider research unless the user explicitly asks for deep provider research. If no providers are enabled, it offers Host-only QA or setup. QA-only mode does not modify product code. It never spawns implementer or CLI workers for product fixes. If QA decides persistent E2E tests are needed, team-lead asks the user and routes only the approved test work to `agestra-implementer` with `mode: e2e-test-authoring`.
|
|
201
213
|
|
|
202
214
|
**Security domain:**
|
|
203
215
|
- `/agestra security` writes a security report under `docs/reports/security/`. Tool installs, heavyweight static scans, networked package audits, and large-log scans require explicit user approval with the exact command, scope, privacy/telemetry note, expected time, and artifact path.
|
package/skills/qa.md
CHANGED
|
@@ -31,7 +31,19 @@ or `Current config: not found`:
|
|
|
31
31
|
Use the provided design document or implemented scope. If unclear, ask which `docs/plans/` document should be the source of truth. If no design document exists, request `/agestra design` first.
|
|
32
32
|
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. Do not proceed to QA depth or provider routing until the QA target/source-of-truth is explicit.
|
|
33
33
|
|
|
34
|
-
### Phase 2: Choose QA
|
|
34
|
+
### Phase 2: Choose QA Execution Mode
|
|
35
|
+
|
|
36
|
+
Ask once unless already specified:
|
|
37
|
+
|
|
38
|
+
| Option | Description |
|
|
39
|
+
|--------|-------------|
|
|
40
|
+
| **Host-only QA (Recommended)** | Fastest path. The current host collects evidence, runs `qa_run`, writes the QA report, and does not call external providers. |
|
|
41
|
+
| **QA Brigade** | Host evidence first, then enabled providers cross-check prepared findings through a short consensus round. Takes longer. |
|
|
42
|
+
| **Decide automatically** | Use Host-only QA unless the target is broad/high-risk, the user explicitly asked for multiple AIs/providers, or the design has disputed evidence. |
|
|
43
|
+
|
|
44
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/permission gate, not a clarifying question. Do not infer provider-backed QA merely because `/agestra qa` was invoked or providers are configured. Skip this question only when the user already explicitly requested current-host-only QA, named provider-backed/multi-AI QA, or selected a mode in the same request. If a host-level no-questions directive prevents asking, choose Host-only QA and report that provider fan-out was skipped.
|
|
45
|
+
|
|
46
|
+
### Phase 3: Choose QA Depth
|
|
35
47
|
|
|
36
48
|
Ask once unless already specified:
|
|
37
49
|
|
|
@@ -42,21 +54,31 @@ Ask once unless already specified:
|
|
|
42
54
|
| **Decide automatically** | Include E2E for UI-heavy, auth, file, public-release, destructive, or complex state-flow work |
|
|
43
55
|
|
|
44
56
|
Warn that E2E can cost more time, tokens, and local runtime setup.
|
|
45
|
-
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. Do not infer QA depth unless the user chose `Decide automatically` or the request already explicitly asked for Standard QA or Full QA/E2E.
|
|
57
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/permission gate, not a clarifying question. Do not infer QA depth unless the user chose `Decide automatically` or the request already explicitly asked for Standard QA or Full QA/E2E. If a host-level no-questions directive prevents asking, choose Standard QA and report that E2E was skipped unless the user explicitly requested it.
|
|
46
58
|
|
|
47
59
|
Persistent E2E test files are not created or maintained by QA. If they are needed, QA returns an `E2E_TEST_WORK_REQUEST` packet; after explicit user approval, route it to `agestra:agestra-implementer` with `mode: e2e-test-authoring` and re-run QA after those tests exist. Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. Do not infer approval.
|
|
48
60
|
|
|
49
|
-
|
|
50
|
-
- "
|
|
51
|
-
- "Should any
|
|
61
|
+
If QA Brigade was selected, also ask focused provider cross-check inputs before provider fan-out:
|
|
62
|
+
- "QA Brigade uses host-prepared evidence first. What should providers cross-check: spec-to-code mapping gaps, API/consumer data shape, route/link mapping, state transition completeness, command/result consistency, suspected regressions, integration/regression risk, edge / error states, test adequacy, safety hygiene, E2E artifact interpretation, or skip?"
|
|
63
|
+
- "Should any provider or host-native lens receive a specific cross-check assignment, or should team-lead choose the assignment rows?"
|
|
52
64
|
|
|
53
|
-
### Phase
|
|
65
|
+
### Phase 4: Route Execution
|
|
54
66
|
|
|
55
67
|
Call `environment_check` and `provider_list`.
|
|
56
68
|
|
|
57
|
-
If
|
|
69
|
+
If Host-only QA was selected, run the host-owned QA evidence pass directly:
|
|
70
|
+
|
|
71
|
+
- Use `qa_run` for build/test verification where applicable.
|
|
72
|
+
- Inspect the design/progress contract, implementation files, command output, and runtime/E2E artifacts according to the selected depth.
|
|
73
|
+
- Use host-native `agestra-research` only as a bounded native helper assignment when the current host exposes native agents and the evidence question is narrow.
|
|
74
|
+
- Write the QA report under `docs/reports/qa/`.
|
|
75
|
+
- Do not call `agent_research_consensus_start`, `agent_consensus_start`, `ai_chat`, or external provider tools.
|
|
76
|
+
|
|
77
|
+
If QA Brigade was selected but no external providers are available, stop provider orchestration and offer Host-only QA or `/agestra setup`. Do not spawn a provider-backed consensus with zero providers.
|
|
58
78
|
|
|
59
|
-
If external providers are available,
|
|
79
|
+
If QA Brigade was selected and external providers are available, first run workspace trust readiness for the exact target root. If supported providers are blocked, ask once whether to register only this project folder. This is a security approval gate, not a clarifying question; "keep going" / no-questions instructions are not approval. After approval, call `provider_trust_apply` once per blocked provider. Use `provider_trust_apply_all` only when the host permission model explicitly allows batch trust changes. If approval cannot be obtained, skip blocked providers or fall back to Host-only QA. Pass `workspace_base_dir` explicitly to provider readiness/trust and consensus calls whenever the host workspace root may be ambiguous.
|
|
80
|
+
|
|
81
|
+
Then hand off to `agestra:agestra-team-lead`. Provider-backed QA uses the fast host-prepared consensus path by default:
|
|
60
82
|
|
|
61
83
|
```text
|
|
62
84
|
호스트가 조사한다.
|
|
@@ -65,27 +87,30 @@ If external providers are available, hand off to `agestra:agestra-team-lead`. Pr
|
|
|
65
87
|
호스트가 문서화한다.
|
|
66
88
|
```
|
|
67
89
|
|
|
68
|
-
|
|
90
|
+
The host must prepare QA evidence before provider fan-out. External providers cross-check the prepared evidence; they do not run the initial research phase. Build a self-contained handoff packet:
|
|
69
91
|
|
|
70
92
|
- **Domain:** `qa`
|
|
71
93
|
- **Submode:** `qa-only`
|
|
72
|
-
- **Mode:** `
|
|
94
|
+
- **Mode:** `qa-brigade` (selected by the user; do not re-ask)
|
|
73
95
|
- **QA depth:** {selected depth}
|
|
74
96
|
- **Design doc reference:** {path under docs/plans}
|
|
75
97
|
- **Report artifact path expectation:** `docs/reports/qa/YYYY-MM-DD-qa-[target].md`
|
|
76
98
|
- **Consensus domain:** `qa`
|
|
77
99
|
- **Connection / Boundary Checks:** API/consumer data shape, route/link mapping, state transition completeness, command/result consistency, and E2E artifact interpretation when E2E ran
|
|
78
|
-
- **Research notes:** {what the host-
|
|
79
|
-
- **
|
|
100
|
+
- **Research notes:** {what the host-owned evidence pass should look for — spec-to-code gaps, boundary mismatches, regressions, integration risk, edge/error states, test adequacy, safety hygiene}
|
|
101
|
+
- **Cross-check assignments:** {optional provider/lens rows for the short consensus round, or "team-lead choose"}
|
|
80
102
|
- **Target workspace root:** {absolute project folder if supplied or implied; pass as `workspace_base_dir`}
|
|
81
103
|
- **Locale:** {from setup_status}
|
|
82
104
|
- **Original user request:** {preserve verbatim}
|
|
83
105
|
|
|
84
|
-
Team-lead calls `
|
|
106
|
+
Team-lead runs the host-owned QA evidence pass, prepares `initial_aggregation.items` from concrete evidence, and calls `agent_consensus_start` with metadata for `domain: "qa"`, exact provider participants, `participant_routes` for any host-native `agestra-debate` participant, `max_rounds: 1` for Standard QA, and a bounded participant timeout. Team-lead must poll `agent_debate_status` and `run_observable_events` when a locator is available, then surface concise progress at least every 30-60 seconds while provider work is running. When the status reports pending host turns, team-lead dispatches the native `agestra-debate` agent and submits the JSON with `agent_consensus_submit_turn`. If the current host cannot surface progress from a background team-lead, the caller must poll and relay progress, or choose Host-only QA for the current run.
|
|
107
|
+
|
|
108
|
+
Do not call `agent_research_consensus_start` for the default QA Brigade path. That tool is reserved for an explicit deep provider-research mode; in that exception, External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases. Default QA Brigade must avoid the extra external research round because QA already has host-owned executable evidence.
|
|
85
109
|
|
|
86
|
-
### Phase
|
|
110
|
+
### Phase 5: Present
|
|
87
111
|
|
|
88
112
|
Report:
|
|
113
|
+
- QA execution mode
|
|
89
114
|
- QA depth and E2E status
|
|
90
115
|
- QA report path
|
|
91
116
|
- Design document used
|
package/skills/research.md
CHANGED
|
@@ -86,6 +86,10 @@ Recommend or confirm one 조사 방식:
|
|
|
86
86
|
- Host-seeded Research: the active host creates and persists the first seed/source document, then external participants challenge it through `domain: "research"`.
|
|
87
87
|
- Provider-seeded Research: the selected seed provider creates the first seed/evidence artifact, then host/reviewer participants challenge it independently.
|
|
88
88
|
|
|
89
|
+
This is a cost/latency gate, not a clarifying question. If a host-level
|
|
90
|
+
no-questions directive prevents asking, choose Host-seeded Research and report
|
|
91
|
+
that broader provider investigation was skipped.
|
|
92
|
+
|
|
89
93
|
If no external providers are available, stop Agestra orchestration and tell the user to run setup or handle the research directly outside Agestra.
|
|
90
94
|
|
|
91
95
|
For Council Research, first create a table of domain-specific investigation items and AI/worker assignments, then ask the user to approve or modify it.
|
package/skills/review.md
CHANGED
|
@@ -72,13 +72,26 @@ Ask tone when useful:
|
|
|
72
72
|
|
|
73
73
|
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. Do not infer review lens/depth/tone when the user has not provided enough signal; explicit defaults such as `Balanced review`, `Standard review`, or `skip tone` are acceptable.
|
|
74
74
|
|
|
75
|
-
Also ask
|
|
76
|
-
- "Provider-backed review
|
|
75
|
+
Also ask selected research inputs before provider fan-out:
|
|
76
|
+
- "Provider-backed review can use Host-led, Council, or Provider-seeded research. What should the selected investigation look for: regression-prone areas, blast radius / downstream callers, prior incidents, dependency / supply-chain concerns, current-information needs, or skip?"
|
|
77
77
|
- "Should any participant or lens receive a specific research assignment, or should team-lead choose the assignment rows?"
|
|
78
78
|
|
|
79
|
-
### Phase 3:
|
|
79
|
+
### Phase 3: Choose 조사 방식
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
Before provider fan-out, ask once which investigation topology to use unless the user already specified it:
|
|
82
|
+
|
|
83
|
+
| Option | Description |
|
|
84
|
+
|--------|-------------|
|
|
85
|
+
| **Host-led Research (Recommended)** | The current host prepares bounded review evidence first; providers challenge and debate the prepared findings. Record internally as `host-seeded`. |
|
|
86
|
+
| **Council Research** | Host and providers independently inspect assigned review lenses before consolidation and debate. |
|
|
87
|
+
| **Provider-seeded Research** | One selected provider creates the first review seed/evidence artifact; host and other providers challenge it. |
|
|
88
|
+
| **Decide automatically** | Use Host-led for scoped reviews, Council for whole-project/deep reviews, and Provider-seeded only when the user named a provider to lead. |
|
|
89
|
+
|
|
90
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/latency gate, not a review clarification. If a host-level no-questions directive prevents asking, choose Host-led Research (`host-seeded`) and report that broader provider investigation was skipped. If Provider-seeded Research is selected and the seed provider is not explicit, record the seed provider as pending; after provider availability is listed, ask which available provider should seed. Do not infer it.
|
|
91
|
+
|
|
92
|
+
### Phase 4: Route execution
|
|
93
|
+
|
|
94
|
+
This skill is **information-gathering only**. After Phases 1-3, hand off to the appropriate executor based on environment.
|
|
82
95
|
|
|
83
96
|
Call `environment_check` and `provider_list`.
|
|
84
97
|
|
|
@@ -86,7 +99,7 @@ Call `environment_check` and `provider_list`.
|
|
|
86
99
|
Stop Agestra orchestration and tell the user to run `/agestra setup` to enable a provider, or ask the current host to review directly outside Agestra. Do not spawn a host specialist from this skill.
|
|
87
100
|
|
|
88
101
|
**Provider-backed path — 1+ external providers available (multi-AI):**
|
|
89
|
-
Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selected**. Provider-backed review uses the
|
|
102
|
+
Hand off to the `agestra:agestra-team-lead` agent with multi-AI mode **pre-selected**. Provider-backed review uses the selected research topology flow:
|
|
90
103
|
|
|
91
104
|
```text
|
|
92
105
|
호스트가 조사한다.
|
|
@@ -105,7 +118,8 @@ External AI research and debate run in separate fresh sessions, even when the sa
|
|
|
105
118
|
- **Boundary:** critique/evaluation only; QA and deep security are separate workflows
|
|
106
119
|
- **Report artifact path expectation:** `docs/reports/review/YYYY-MM-DD-review-[target].md`
|
|
107
120
|
- **Consensus domain:** `review`
|
|
108
|
-
- **Research
|
|
121
|
+
- **Research topology / 조사 방식:** {selected in Phase 3 — `host-seeded`, `council`, `provider-seeded`, or `automatic`}
|
|
122
|
+
- **Research notes:** {what the selected investigation should look for — regression-prone areas, blast radius, prior incidents, dependency concerns, current-information needs}
|
|
109
123
|
- **Research assignments:** {optional participant/lens rows for `research_assignments`, or "team-lead choose"}
|
|
110
124
|
- **Available providers:** {from environment_check, exclude `ollama` unless explicitly requested for lightweight commentary}
|
|
111
125
|
- **Requested providers:** {explicit names captured from the user's wording, e.g. `[codex, gemini]`; otherwise "all available review-capable"}
|
|
@@ -115,7 +129,7 @@ External AI research and debate run in separate fresh sessions, even when the sa
|
|
|
115
129
|
|
|
116
130
|
Team-lead owns:
|
|
117
131
|
- Building the participant team (host reviewer + external providers)
|
|
118
|
-
-
|
|
132
|
+
- Resolving the selected research topology, then calling `agent_research_consensus_start` when investigation fan-out is required or `agent_consensus_start` with prepared `initial_aggregation.items` when seed/host evidence is already available.
|
|
119
133
|
- Ensuring external AI research and debate use separate fresh sessions.
|
|
120
134
|
- Never creating a bundled research pseudo-participant and never carrying research bundles through `source_documents`.
|
|
121
135
|
- Inspecting `aggregation_record.json`, `open_debate_items.json`, `round_packet.{round}.{provider}.json`, the aggregation document, and the leader-authored final decision document under `docs/agestra/`.
|
|
@@ -128,7 +142,7 @@ Team-lead owns:
|
|
|
128
142
|
|
|
129
143
|
Direct execution from this skill bypasses team-lead's task design, capability-based routing with optional trace-assisted signals (`trace_summary`), and consistency enforcement. Always go through team-lead in the provider-backed path.
|
|
130
144
|
|
|
131
|
-
### Phase
|
|
145
|
+
### Phase 5: Review Verdict
|
|
132
146
|
|
|
133
147
|
The reviewer returns a review verdict:
|
|
134
148
|
|
|
@@ -140,7 +154,7 @@ The reviewer returns a review verdict:
|
|
|
140
154
|
|
|
141
155
|
This is not a QA verdict and not a security certification.
|
|
142
156
|
|
|
143
|
-
### Phase
|
|
157
|
+
### Phase 6: Present
|
|
144
158
|
|
|
145
159
|
Surface the result to the user in the user's language:
|
|
146
160
|
- Review report path
|
package/skills/security.md
CHANGED
|
@@ -41,17 +41,30 @@ Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. Do
|
|
|
41
41
|
|
|
42
42
|
Ask separately before any tool-assisted scan that installs tools, contacts package registries, uses network access, or produces large logs. The user must approve the exact tool, command, scope, expected time, privacy/telemetry behavior, and artifact path. If declined, continue manual review and record skipped checks as residual risk.
|
|
43
43
|
|
|
44
|
-
Also ask
|
|
45
|
-
- "Provider-backed security
|
|
44
|
+
Also ask selected research inputs before provider fan-out:
|
|
45
|
+
- "Provider-backed security can use Host-led, Council, or Provider-seeded research. What should the selected investigation look for: secrets / API key surfaces, auth / authz boundaries, file / command execution paths, network exposure, dependency / supply-chain concerns, unsafe defaults, or skip?"
|
|
46
46
|
- "Should any participant or lens receive a specific research assignment, or should team-lead choose the assignment rows?"
|
|
47
47
|
|
|
48
|
-
### Phase 3:
|
|
48
|
+
### Phase 3: Choose 조사 방식
|
|
49
|
+
|
|
50
|
+
Before provider fan-out, ask once which investigation topology to use unless the user already specified it:
|
|
51
|
+
|
|
52
|
+
| Option | Description |
|
|
53
|
+
|--------|-------------|
|
|
54
|
+
| **Host-led Research (Recommended)** | The current host prepares bounded security evidence first; providers challenge and debate the prepared findings. Record internally as `host-seeded`. |
|
|
55
|
+
| **Council Research** | Host and providers independently inspect assigned security surfaces before consolidation and debate. |
|
|
56
|
+
| **Provider-seeded Research** | One selected provider creates the first security seed/evidence artifact; host and other providers challenge it. |
|
|
57
|
+
| **Decide automatically** | Use Host-led for bounded audits, Council for broad/full security reviews, and Provider-seeded only when the user named a provider to lead. |
|
|
58
|
+
|
|
59
|
+
Use `AskUserQuestion` when available, or a plain numbered prompt as fallback. This is a cost/latency gate, not a security clarification. If a host-level no-questions directive prevents asking, choose Host-led Research (`host-seeded`) and report that broader provider investigation was skipped. If Provider-seeded Research is selected and the seed provider is not explicit, record the seed provider as pending; after provider availability is listed, ask which available provider should seed. Do not infer it.
|
|
60
|
+
|
|
61
|
+
### Phase 4: Route Execution
|
|
49
62
|
|
|
50
63
|
Call `environment_check` and `provider_list`.
|
|
51
64
|
|
|
52
65
|
If no external providers are available, stop Agestra orchestration and tell the user to run `/agestra setup` to enable a provider, or ask the current host to run a security review directly outside Agestra. Do not spawn a host specialist from this skill.
|
|
53
66
|
|
|
54
|
-
If external providers are available or named, hand off to `agestra:agestra-team-lead`. Provider-backed security uses the
|
|
67
|
+
If external providers are available or named, hand off to `agestra:agestra-team-lead`. Provider-backed security uses the selected research topology flow:
|
|
55
68
|
|
|
56
69
|
```text
|
|
57
70
|
호스트가 조사한다.
|
|
@@ -70,20 +83,21 @@ External AI research and debate run in separate fresh sessions, even when the sa
|
|
|
70
83
|
- **Tool permission choices:** approved / declined / not asked, with exact approved commands if any
|
|
71
84
|
- **Report artifact path expectation:** `docs/reports/security/YYYY-MM-DD-security-[target].md`
|
|
72
85
|
- **Consensus domain:** `security`
|
|
73
|
-
- **Research
|
|
86
|
+
- **Research topology / 조사 방식:** {selected in Phase 3 — `host-seeded`, `council`, `provider-seeded`, or `automatic`}
|
|
87
|
+
- **Research notes:** {what the selected investigation should look for — secrets/keys, auth/authz boundaries, file/command execution, network exposure, dependency concerns, unsafe defaults}
|
|
74
88
|
- **Research assignments:** {optional participant/lens rows for `research_assignments`, or "team-lead choose"}
|
|
75
89
|
- **Locale:** {from setup_status}
|
|
76
90
|
- **Target workspace root:** {absolute project folder if supplied or implied; pass as `workspace_base_dir`}
|
|
77
91
|
- **Original user request:** {preserve verbatim}
|
|
78
92
|
|
|
79
93
|
Team-lead owns:
|
|
80
|
-
-
|
|
94
|
+
- Resolving the selected research topology, then calling `agent_research_consensus_start` when investigation fan-out is required or `agent_consensus_start` with prepared `initial_aggregation.items` when seed/host evidence is already available.
|
|
81
95
|
- Ensuring external AI research and debate use separate fresh sessions.
|
|
82
96
|
- Never creating a bundled research pseudo-participant and never carrying research bundles through `source_documents`.
|
|
83
97
|
- Inspecting `aggregation_record.json`, `open_debate_items.json`, `round_packet.{round}.{provider}.json`, the aggregation document, and the leader-authored final decision document under `docs/agestra/`.
|
|
84
98
|
- The brigade must not run destructive exploit tests and must not install tools or run heavyweight/networked scans without explicit user approval.
|
|
85
99
|
|
|
86
|
-
### Phase
|
|
100
|
+
### Phase 5: Present
|
|
87
101
|
|
|
88
102
|
Report:
|
|
89
103
|
- Security report path
|
package/skills/setup.md
CHANGED
|
@@ -107,6 +107,9 @@ Use the existing config without asking on every session. The user can rerun
|
|
|
107
107
|
## Integration with Debate
|
|
108
108
|
|
|
109
109
|
When user triggers review/idea/design (via hook or command):
|
|
110
|
-
-
|
|
111
|
-
-
|
|
110
|
+
- Use the existing provider config instead of asking provider setup again
|
|
111
|
+
- Still run the matching domain skill's question sheet, including domain-specific
|
|
112
|
+
cost gates and `조사 방식` / research topology selection when provider-backed
|
|
113
|
+
research is possible
|
|
114
|
+
- Route through team-lead for consensus/debate using the enabled providers
|
|
112
115
|
- If only 1 provider is enabled, inform user that debate needs 2+ participants and offer to add Claude as participant
|