agestra 4.7.0 → 4.8.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/skills/idea.md CHANGED
@@ -1,212 +1,307 @@
1
- ---
2
- name: agestra-idea
3
- description: >
4
- Use when discovering improvements, comparing with similar projects, collecting user feedback,
5
- exploring new features, researching what to build, or validating ideas. Triggers on:
6
- "find improvements", "what should I add", "compare with competitors", "what are users asking for",
7
- "explore ideas", "feature ideas", "what's missing", "is this worth building", "what do users want",
8
- "what problem does this solve", "who would use this", "what should I focus on next",
9
- "개선점", "뭐 추가하면 좋을까", "아이디어", "유사 프로젝트", "뭐가 부족해",
10
- "이거 만들 가치가 있어?", "다음에 뭘 해야 할까", "비슷한 도구",
11
- "改善", "アイデア", "改进", "想法"
12
- ---
13
-
14
- ## Purpose
15
-
16
- Idea and improvement discovery. Research similar projects, collect user complaints and feature requests, compare capabilities, and generate actionable suggestions.
17
-
18
- ## Scope
19
-
20
- **Mode A: Existing project** — The codebase has a README or meaningful code.
21
- Research improvements, missing features, and competitive gaps for this project.
22
-
23
- **Mode B: New project** — The codebase is empty/new, but the user has a seed idea (e.g., "I want to build a writing tool").
24
- Research the landscape: what already exists, what users complain about, what gaps remain.
25
-
26
- **Out of scope:** Requests with no seed idea at all (e.g., "what should I build?"). You need at least a domain or concept to anchor research. Ask for one:
27
-
28
- > "I need at least a rough idea — a domain, a tool type, or a problem you want to solve. For example: 'a writing tool', 'a CLI for deployment', 'something for managing bookmarks'."
29
-
30
- ## Workflow
31
-
32
- ### Phase 1: Clarity Gate
33
-
34
- Before researching, understand what the user needs through targeted questions. Ask ONE question at a time. Communicate in the user's language.
35
-
36
- **Step 1: Determine mode.**
37
- - If the codebase has a README or meaningful code → Mode A (existing project)
38
- - If the codebase is empty/new but user has a seed idea → Mode B (new project)
39
-
40
- **Step 2: Mode-specific interview.**
41
-
42
- **Mode A — Existing project:**
43
-
44
- | Dimension | Question | Purpose |
45
- |-----------|----------|---------|
46
- | Direction | "What aspect are you looking to improve? (features, UX, performance, integrations, DX)" | Narrow the research scope |
47
- | Audience | "Who are your current users? What do they use it for most?" | Target the right competitors |
48
- | Feedback | "Have you received any complaints or feature requests?" | Direct pain point input |
49
- | Competition | "Are there specific competitors or similar tools you're aware of?" | Seed the research |
50
- | Strength | "What do you consider your project's unique strength?" | Avoid suggesting what already works |
51
- | Constraints | "Any areas you don't want to change or can't change?" | Set research boundaries |
52
-
53
- After gathering context:
54
- - Read the project's README and key files to understand what it does
55
- - Use Glob and Grep to map the current feature set
56
- - Identify the project's category and target audience
57
-
58
- **Mode B — New project:**
59
-
60
- | Dimension | Question | Purpose |
61
- |-----------|----------|---------|
62
- | Problem | "What problem are you trying to solve?" | Core motivation |
63
- | Audience | "Who would use this? What's the target audience?" | Market focus |
64
- | Form | "How do you envision it? (CLI, web app, library, service, plugin)" | Shape the research |
65
- | Inspiration | "What inspired this? Have you seen something similar?" | Seed the research |
66
- | Core | "What's the single most important thing it must do well?" | Prioritization anchor |
67
- | Boundary | "What should it NOT be? Where do you draw the line?" | Scope limits |
68
-
69
- **Early exit:** If the user provides enough context upfront (specific competitors, clear scope, concrete goals), skip remaining questions and proceed to Phase 2. Do not force unnecessary rounds.
70
-
71
- ### Phase 2: Check environment and select mode
72
-
73
- Call `environment_check` to determine available providers.
74
-
75
- Present mode selection (in the user's language):
76
-
77
- | Option | Condition | Description |
78
- |--------|-----------|-------------|
79
- | **Claude only** | Always | 플러그인 전문 에이전트가 단독으로 개선점 탐색 |
80
- | **각자 독립** | 1+ provider available | 에이전트 팀(moderator + ideator + 외부 AI)이 각자 독립 탐색 후 취합 문서 작성 |
81
- | **끝장토론** | 1+ provider available | 각자 독립 탐색 취합 문서를 돌아가며 분석/피드백, 모두 동의할 때까지 |
82
-
83
- Only show options whose conditions are met. If no providers are available, run Claude only.
84
-
85
- ### Phase 3: Execute
86
-
87
- #### If "Claude only":
88
- Proceed to Phase 4 (Research) directly using `agestra-ideator` agent.
89
-
90
- #### If "각자 독립":
91
-
92
- **팀 구성:** `agestra-moderator` (리더) + `agestra-ideator` (Claude) + 사용 가능한 외부 AI (gemini, codex, ollama 등)
93
-
94
- 1. In parallel:
95
- - Spawn the `agestra-ideator` agent for Claude's independent improvement research.
96
- After the agent completes, save Claude's result as a document via `workspace_create_document`:
97
- - **title:** `Idea Exploration — claude/ideator`
98
- - **metadata:** `{ "Provider": "claude/ideator", "Task": "{topic}", "Mode": "Independent" }`
99
- - **content:** The ideator agent's full output.
100
- - For each available provider, call `ai_chat` with `save_as_document`:
101
- - **save_as_document.title:** `Idea Exploration — {provider}`
102
- - **save_as_document.metadata:** `{ "Task": "{topic}", "Mode": "Independent" }`
103
- - **prompt:** Research improvements for [topic]. Look at similar projects, common user complaints, missing features, and opportunities. For each suggestion, provide: title, category (UX/Performance/Feature/Integration/DX), source of the idea, priority (HIGH/MEDIUM/LOW), and a brief description.
104
-
105
- 2. Collect all document IDs.
106
-
107
- 3. Spawn the `agestra-moderator` agent in **Independent Aggregation** mode:
108
- - Pass the document ID list.
109
- - Moderator reads each document, classifies consensus/unique/disputed suggestions.
110
- - Moderator creates an aggregated document via `workspace_create_document`.
111
-
112
- 4. Present summary report to the user:
113
- - Key consensus suggestions (1-3 lines).
114
- - Notable unique ideas (if any).
115
- - Priority disagreements (if any).
116
- - Individual + aggregated document IDs.
117
-
118
- #### If "끝장토론":
119
-
120
- **팀 구성:** `agestra-moderator` (리더) + `agestra-ideator` (Claude) + 사용 가능한 외부 AI (gemini, codex, ollama 등)
121
-
122
- 1. Execute "각자 독립" steps 1-3 above (independent work + initial aggregation).
123
- - The moderator's integrated document becomes the starting document.
124
-
125
- 2. Document review rounds (no max — until all agree):
126
- a. Moderator sends the current document to each AI for review:
127
- - Claude: spawn `agestra-ideator` analyze document → section-by-section feedback
128
- - Other providers: `agent_debate_turn` with the document as prompt, requesting agree/disagree per section
129
- b. Moderator collects all feedback.
130
- c. Classify: agree/disagree per section per provider.
131
- d. Revise document incorporating disagreement feedback.
132
- e. If all providers agree on all sections → consensus reached.
133
- f. If not → next round with revised document.
134
- g. **Every 10 rounds:** Ask the user whether to continue or stop with current state.
135
-
136
- 3. Present the final document:
137
- - Consensus sections: marked as agreed
138
- - Disputed sections: show split positions with each provider's rationale
139
-
140
- ### Phase 4: Research (Claude only mode)
141
-
142
- If running Claude only, execute the following research phases:
143
-
144
- #### 4a: Research Similar Projects
145
- - Use WebSearch to find similar tools, libraries, and projects
146
- - Look for: direct competitors, adjacent tools, inspirational projects
147
- - Collect names, URLs, and key differentiators
148
-
149
- #### 4b: Collect Pain Points
150
- - WebSearch for complaints about similar tools (GitHub issues, forums, discussions)
151
- - WebFetch relevant issue pages and discussion threads
152
- - Identify recurring themes in user feedback
153
- - Note what users wish existed but doesn't
154
-
155
- #### 4c: Feature Comparison
156
- Build a comparison table:
157
-
158
- | Feature | This Project | Competitor A | Competitor B |
159
- |---------|-------------|-------------|-------------|
160
- | Feature 1 | Yes/No | Yes/No | Yes/No |
161
-
162
- #### 4d: Generate Suggestions
163
- For each suggestion:
164
- - **Title** clear, actionable name
165
- - **Category** — UX, Performance, Feature, Integration, DX
166
- - **Source** where this idea came from (competitor, user complaint, own analysis)
167
- - **Priority** HIGH / MEDIUM / LOW with rationale
168
- - **Effort** estimated complexity
169
- - **Description** what it does and why it matters
170
-
171
- #### 4e: Prioritized Recommendations
172
- Present a ranked list:
173
- 1. **Quick wins**high impact, low effort
174
- 2. **Strategic investments** high impact, high effort
175
- 3. **Nice-to-haves** low impact, low effort
176
-
177
- ## Output Format
178
-
179
- ```markdown
180
- ## Research Summary
181
-
182
- ### Similar Projects
183
- (list with URLs and key features)
184
-
185
- ### User Pain Points
186
- (categorized complaints from research)
187
-
188
- ### Feature Comparison
189
- (table)
190
-
191
- ### Recommendations
192
-
193
- #### Quick Wins
194
- 1. ...
195
-
196
- #### Strategic Investments
197
- 1. ...
198
-
199
- #### Nice-to-Haves
200
- 1. ...
201
-
202
- ### Sources
203
- - [Source 1](url)
204
- - [Source 2](url)
205
- ```
206
-
207
- ## Constraints
208
-
209
- - Always include source URLs for claims about other projects.
210
- - Do not fabricate features of competitors — verify via web research.
211
- - Prioritize actionable suggestions over theoretical improvements.
212
- - Communicate in the user's language.
1
+ ---
2
+ name: agestra-idea
3
+ description: >
4
+ Use when discovering improvements, comparing with similar projects, collecting user feedback,
5
+ exploring new features, researching what to build, or validating ideas. Triggers on:
6
+ "find improvements", "what should I add", "compare with competitors", "what are users asking for",
7
+ "explore ideas", "feature ideas", "what's missing", "is this worth building", "what do users want",
8
+ "what problem does this solve", "who would use this", "what should I focus on next",
9
+ "개선점", "뭐 추가하면 좋을까", "아이디어", "유사 프로젝트", "뭐가 부족해",
10
+ "이거 만들 가치가 있어?", "다음에 뭘 해야 할까", "비슷한 도구",
11
+ "改善", "アイデア", "改进", "想法"
12
+ ---
13
+
14
+ ## Purpose
15
+
16
+ Idea and improvement discovery. Research similar projects, collect user complaints and feature requests, compare capabilities, and generate actionable suggestions.
17
+
18
+ ## Scope
19
+
20
+ **Mode A: Existing project** — The codebase has a README or meaningful code.
21
+ Research improvements, missing features, and competitive gaps for this project.
22
+
23
+ **Mode B: New project** — The codebase is empty/new, but the user has a seed idea (e.g., "I want to build a writing tool").
24
+ Research the landscape: what already exists, what users complain about, what gaps remain. Define what to build and why it's worth building.
25
+
26
+ **Out of scope:** Requests with no seed idea at all (e.g., "what should I build?"). You need at least a domain or concept to anchor research. Ask for one:
27
+
28
+ > "I need at least a rough idea — a domain, a tool type, or a problem you want to solve. For example: 'a writing tool', 'a CLI for deployment', 'something for managing bookmarks'."
29
+
30
+ ## Workflow
31
+
32
+ ### Phase 1: Clarity Gate
33
+
34
+ Before researching, understand what the user needs through targeted questions. Ask ONE question at a time. Communicate in the user's language.
35
+
36
+ **Step 1: Determine mode.**
37
+ - If the codebase has a README or meaningful code → Mode A (existing project)
38
+ - If the codebase is empty/new but user has a seed idea → Mode B (new project)
39
+
40
+ **Step 2: Mode-specific interview.**
41
+
42
+ **Mode A — Existing project:**
43
+
44
+ | Dimension | Question | Purpose |
45
+ |-----------|----------|---------|
46
+ | Direction | "What aspect are you looking to improve? (features, UX, performance, integrations, DX)" | Narrow the research scope |
47
+ | Audience | "Who are your current users? What do they use it for most?" | Target the right competitors |
48
+ | Feedback | "Have you received any complaints or feature requests?" | Direct pain point input |
49
+ | Competition | "Are there specific competitors or similar tools you're aware of?" | Seed the research |
50
+ | Strength | "What do you consider your project's unique strength?" | Avoid suggesting what already works |
51
+ | Constraints | "Any areas you don't want to change or can't change?" | Set research boundaries |
52
+
53
+ After gathering context:
54
+ - Read the project's README and key files to understand what it does
55
+ - Use Glob and Grep to map the current feature set
56
+ - Identify the project's category and target audience
57
+
58
+ **Mode B — New project:**
59
+
60
+ | Dimension | Question | Purpose |
61
+ |-----------|----------|---------|
62
+ | Problem | "What problem are you trying to solve? What frustration triggered this idea?" | Core motivation — this anchors all research |
63
+ | Audience | "Who would use this? Describe the ideal user." | Determines which competitors and pain points to research |
64
+ | Form | "How do you envision it? (CLI, web app, mobile, library, service, plugin, desktop)" | Shape the research — different forms have different competitive landscapes |
65
+ | Inspiration | "What inspired this? Have you seen something similar that's close but not quite right?" | Seeds competitor research with concrete starting points |
66
+ | Core | "If it could only do ONE thing perfectly, what would that be?" | Prioritization anchor — prevents scope creep in research |
67
+ | Boundary | "What should it NOT be? What's explicitly out of scope?" | Prevents researching irrelevant directions |
68
+ | Differentiator | "Why would someone use yours instead of what already exists?" | Tests whether the user has a hypothesis to validate |
69
+
70
+ **Early exit:** If the user provides enough context upfront (specific competitors, clear scope, concrete goals), skip remaining questions and proceed to Phase 2. Do not force unnecessary rounds.
71
+
72
+ ### Phase 2: Check environment and select mode
73
+
74
+ Call `environment_check` to determine available providers.
75
+
76
+ - If **no providers are available**: proceed to Phase 3 (Research) directly using `agestra-ideator` agent (Claude only).
77
+ - If **1+ providers are available**: proceed to 끝장토론 execution below.
78
+
79
+ ### Phase 3: Execute 끝장토론
80
+
81
+ **팀 구성:** `agestra-moderator` (리더) + `agestra-ideator` (Claude) + 사용 가능한 외부 AI (gemini, codex 등)
82
+
83
+ The `ai_chat` prompt for external providers differs by mode. Use the interview answers collected in Phase 1 to construct a context-rich prompt.
84
+
85
+ 1. Independent work + initial aggregation:
86
+
87
+ a. In parallel:
88
+ - Spawn the `agestra-ideator` agent for Claude's independent research.
89
+ After the agent completes, save Claude's result as a document via `workspace_create_document`:
90
+ - **title:** `Idea Exploration — claude/ideator`
91
+ - **metadata:** `{ "Provider": "claude/ideator", "Task": "{topic}", "Mode": "Independent" }`
92
+ - **content:** The ideator agent's full output.
93
+ - For each available provider, call `ai_chat` with `save_as_document`:
94
+ - **save_as_document.title:** `Idea Exploration — {provider}`
95
+ - **save_as_document.metadata:** `{ "Task": "{topic}", "Mode": "Independent" }`
96
+ - **prompt:** Use the Mode A or Mode B prompt below.
97
+
98
+ **Mode A prompt for external providers:**
99
+
100
+ > Context from user interview:
101
+ > - Direction: {user's answer}
102
+ > - Audience: {user's answer}
103
+ > - Known competitors: {user's answer}
104
+ > - Project strengths: {user's answer}
105
+ > - Constraints: {user's answer}
106
+ >
107
+ > Analyze this existing project and generate exactly 5 improvement ideas.
108
+ > For each idea, provide this exact structure:
109
+ >
110
+ > 1. **Title** clear, actionable name
111
+ > 2. **Category** — one of: Feature, UX, Performance, Integration, DX, Security, Documentation
112
+ > 3. **Evidence** specific file, pattern, or code area that reveals this opportunity
113
+ > 4. **Description** what to change and why it matters
114
+ > 5. **Effort** trivial / small / medium / large / complex, with brief justification
115
+ > 6. **Priority** HIGH / MEDIUM / LOW with rationale
116
+ > 7. **Implementation approach** concrete first steps
117
+ >
118
+ > Rules:
119
+ > - Every idea must be grounded in actual code or project structure (no generic advice)
120
+ > - Include a mix of effort levels (not all "large")
121
+ > - Do not suggest changes to areas the user marked as constraints
122
+
123
+ **Mode B prompt for external providers:**
124
+
125
+ > Context from user interview:
126
+ > - Problem to solve: {user's answer}
127
+ > - Target audience: {user's answer}
128
+ > - Envisioned form: {user's answer}
129
+ > - Inspiration/similar tools: {user's answer}
130
+ > - Core must-have: {user's answer}
131
+ > - Out of scope: {user's answer}
132
+ > - Differentiator hypothesis: {user's answer}
133
+ >
134
+ > Research the landscape for this new project idea and provide:
135
+ >
136
+ > **Part 1: Competitive Landscape (3-5 existing tools)**
137
+ > For each competitor:
138
+ > - Name and URL
139
+ > - What it does well
140
+ > - What users complain about (cite sources if possible)
141
+ > - How the user's idea differs
142
+ >
143
+ > **Part 2: Opportunity Analysis**
144
+ > - Gaps in existing tools that no one fills
145
+ > - Most common user frustrations across competitors
146
+ > - Underserved audience segments
147
+ >
148
+ > **Part 3: Feature Recommendations (5-7 ideas)**
149
+ > For each feature:
150
+ > 1. **Title** clear name
151
+ > 2. **Category** — Core (must-have for v1) / Differentiator (sets it apart) / Growth (future expansion)
152
+ > 3. **Why** how this addresses a real gap or pain point found in research
153
+ > 4. **Effort** trivial / small / medium / large / complex
154
+ > 5. **Priority** — P0 (v1 essential) / P1 (v1 nice-to-have) / P2 (post-launch)
155
+ > 6. **Risk** — what could go wrong or make this not worth building
156
+ >
157
+ > **Part 4: Viability Assessment**
158
+ > - Is the user's differentiator hypothesis valid? Why or why not?
159
+ > - What's the biggest risk for this project?
160
+ > - Recommended MVP scope (3-5 features max)
161
+ >
162
+ > Be thorough and specific. Generic advice like "make it user-friendly" is not useful.
163
+
164
+ b. Collect all document IDs.
165
+
166
+ c. Spawn the `agestra-moderator` agent in **Independent Aggregation** mode:
167
+ - Pass the document ID list.
168
+ - Moderator reads each document, classifies consensus/unique/disputed suggestions.
169
+ - Moderator creates an aggregated document. This becomes the starting document.
170
+
171
+ 2. Start a turn-based debate session with `agent_debate_create`.
172
+
173
+ 3. Document review rounds (no max until all agree):
174
+ a. Moderator sends the current document to each AI for review.
175
+ b. Moderator collects all feedback and updates the working document.
176
+ c. If all providers agree on all sections → consensus reached.
177
+ d. If not → next round with the revised document.
178
+ e. **Every 10 rounds:** Ask the user whether to continue or stop with current state.
179
+
180
+ 4. When consensus is reached, record the final synthesis with `agent_debate_conclude`.
181
+
182
+ 5. Present the final document:
183
+ - Consensus sections: marked as agreed
184
+ - Disputed sections: show split positions with each provider's rationale
185
+
186
+ ### Phase 4: Research (Claude only mode)
187
+
188
+ If running Claude only, execute the following research phases:
189
+
190
+ #### Mode A: Existing project research
191
+
192
+ **4a: Codebase Analysis**
193
+ - Read project README, key files, and directory structure
194
+ - Use Glob and Grep to map current features and patterns
195
+ - Identify code smells, gaps, and improvement areas grounded in actual code
196
+
197
+ **4b: Research Similar Projects**
198
+ - Use WebSearch to find similar tools, libraries, and projects
199
+ - Focus on competitors the user mentioned in the interview
200
+ - Collect names, URLs, and key differentiators
201
+
202
+ **4c: Collect Pain Points**
203
+ - WebSearch for complaints about similar tools (GitHub issues, forums, discussions)
204
+ - WebFetch relevant issue pages and discussion threads
205
+ - Identify recurring themes in user feedback
206
+
207
+ **4d: Generate 5 structured ideas**
208
+ Follow the Mode A prompt structure above (Title, Category, Evidence, Description, Effort, Priority, Implementation approach).
209
+
210
+ **4e: Prioritized Recommendations**
211
+ Present a ranked list:
212
+ 1. **Quick wins** high impact, low effort
213
+ 2. **Strategic investments** — high impact, high effort
214
+ 3. **Nice-to-haves** — low impact, low effort
215
+
216
+ #### Mode B: New project research
217
+
218
+ **4a: Competitive Landscape**
219
+ - WebSearch for existing tools in the domain the user described
220
+ - For each competitor: features, pricing, user reviews, GitHub stars/activity
221
+ - WebFetch key competitor pages for detailed feature analysis
222
+ - Cross-reference with the user's inspiration and known similar tools
223
+
224
+ **4b: User Pain Points**
225
+ - WebSearch for complaints: "{domain} tool frustrations", "{competitor} alternatives", "{problem} solution"
226
+ - Look at GitHub issues, Reddit threads, forum posts, product review sites
227
+ - Categorize by frequency and severity
228
+
229
+ **4c: Gap Analysis**
230
+ - What do users want that no existing tool provides?
231
+ - Which audience segments are underserved?
232
+ - What technical approaches haven't been tried?
233
+
234
+ **4d: Generate 5-7 structured feature ideas**
235
+ Follow the Mode B prompt structure above (Title, Category, Why, Effort, Priority, Risk).
236
+
237
+ **4e: Viability Assessment**
238
+ - Validate or challenge the user's differentiator hypothesis
239
+ - Identify the biggest risk
240
+ - Recommend MVP scope (3-5 features max)
241
+ - Suggest a "litmus test" — one thing the user could build in a weekend to validate demand
242
+
243
+ ## Output Format
244
+
245
+ ### Mode A output:
246
+
247
+ ```markdown
248
+ ## Improvement Ideas for {project}
249
+
250
+ ### Quick Wins
251
+ 1. **{Title}** [{Category}] — Effort: {effort}
252
+ {Description}. Evidence: {file/pattern}.
253
+
254
+ ### Strategic Investments
255
+ 1. ...
256
+
257
+ ### Nice-to-Haves
258
+ 1. ...
259
+
260
+ ### Competitive Comparison
261
+ | Feature | This Project | {Competitor A} | {Competitor B} |
262
+ |---------|-------------|----------------|----------------|
263
+
264
+ ### Sources
265
+ - [Source 1](url)
266
+ ```
267
+
268
+ ### Mode B output:
269
+
270
+ ```markdown
271
+ ## Research: {project idea}
272
+
273
+ ### Competitive Landscape
274
+ | Tool | Strengths | Weaknesses | How we differ |
275
+ |------|-----------|------------|---------------|
276
+
277
+ ### User Pain Points
278
+ (categorized by frequency)
279
+
280
+ ### Recommended Features
281
+ #### Core (v1 essential)
282
+ 1. **{Title}** — {Why}. Effort: {effort}. Risk: {risk}.
283
+
284
+ #### Differentiators
285
+ 1. ...
286
+
287
+ #### Growth (post-launch)
288
+ 1. ...
289
+
290
+ ### Viability Assessment
291
+ - Differentiator valid? {yes/no + reasoning}
292
+ - Biggest risk: {description}
293
+ - Recommended MVP: {3-5 features}
294
+ - Quick validation: {litmus test suggestion}
295
+
296
+ ### Sources
297
+ - [Source 1](url)
298
+ ```
299
+
300
+ ## Constraints
301
+
302
+ - Always include source URLs for claims about other projects.
303
+ - Do not fabricate features of competitors — verify via web research.
304
+ - Every Mode A idea must cite specific code evidence (file, pattern, or area).
305
+ - Mode B ideas must trace back to research findings (competitor gap, user complaint, or market opportunity).
306
+ - Prioritize actionable suggestions over theoretical improvements.
307
+ - Communicate in the user's language.
@@ -50,13 +50,14 @@ Full-capability agents. Use for:
50
50
 
51
51
  ### Text Work (리뷰/설계/아이디어)
52
52
 
53
- Three modes available via `/agestra review`, `/agestra design`, `/agestra idea`:
53
+ Available via `/agestra review`, `/agestra design`, `/agestra idea`:
54
54
 
55
55
  | Mode | Description | When to Use |
56
56
  |------|-------------|-------------|
57
- | **Claude only** | Specialist agent works alone | Quick analysis, no external AI needed |
58
- | **각자 독립** | Each AI works independentlymoderator aggregates | Want multiple perspectives, fast |
59
- | **끝장토론** | Independent work + document review rounds until consensus | Need thorough, agreed-upon analysis |
57
+ | **Claude only** | Specialist agent works alone | No external providers available |
58
+ | **끝장토론** | Independent work aggregationreview rounds until consensus | Providers available (default) |
59
+
60
+ When providers are enabled, commands go directly to 끝장토론 mode. No mode selection needed.
60
61
 
61
62
  ### Implementation Work (실제 구현)
62
63
 
@@ -104,8 +105,6 @@ Match by **semantic intent**, not literal keywords. These triggers apply in any
104
105
  | Second opinion, other perspectives | `ai_compare` or `/agestra review` (각자 독립) | User wants multiple viewpoints on a decision |
105
106
  | Validation, verification, cross-check | `agent_cross_validate` | User wants to confirm correctness of work output |
106
107
  | Speed up, parallelize, split work | Team API or CLI workers | User wants faster execution or has independent tasks |
107
- | Past experience, history, previous attempts | `memory_search` or `memory_dead_ends` | User asks about prior work or known issues |
108
- | Remember this, save for later | `memory_store` | User wants to persist knowledge across sessions |
109
108
  | Mention a provider by name (Gemini, Codex, Ollama) | `ai_chat` or `cli_worker_spawn` | Route directly to the named provider |
110
109
  | Architecture review, design discussion | `/agestra design` | Structured multi-AI architecture exploration |
111
110
  | Compare options, which is better | `ai_compare` | Side-by-side comparison from multiple providers |
@@ -130,21 +129,17 @@ Match by **semantic intent**, not literal keywords. These triggers apply in any
130
129
  | `cancel` | Gracefully stop running operations (including CLI workers) with state cleanup |
131
130
  | `worker-manage` | List, check, collect, and stop CLI workers |
132
131
 
133
- When "각자 독립" is selected, each AI works independently and `agestra-moderator` aggregates results.
134
- When "끝장토론" is selected, `agestra-moderator` facilitates document review rounds after independent aggregation.
135
-
136
- Commands and hook-triggered suggestions share the same 3-choice pattern (Claude only / 각자 독립 / 끝장토론). Commands are explicit entry points; hooks detect intent from natural language.
132
+ In 끝장토론 mode, each AI works independently first, then `agestra-moderator` aggregates results and facilitates review rounds until consensus.
137
133
 
138
- ### Hook-Triggered Choice
134
+ Commands and hook-triggered suggestions go directly to 끝장토론 when providers are available. Commands are explicit entry points; hooks detect intent from natural language.
139
135
 
140
- When an `AGESTRA_SUGGESTION` marker appears from the UserPromptSubmit hook, present these choices:
136
+ ### Hook-Triggered Flow
141
137
 
142
- 1. **Claude only** Claude Code handles it alone
143
- 2. **각자 독립** Each AI works independently, moderator aggregates
144
- 3. **끝장토론** — Independent work + document review rounds until consensus
145
- 4. **Other** — User specifies the approach
138
+ When the UserPromptSubmit hook injects context, proceed directly to **끝장토론** (debate) mode
139
+ using the enabled providers from `providers.config.json`.
146
140
 
147
- Present choices in the user's language. If no providers are available, skip and proceed directly.
141
+ If no config exists, suggest `/agestra setup` first.
142
+ If no providers are enabled, suggest `/agestra setup` to select AIs.
148
143
 
149
144
  ## Error Handling — 429 Rate Limit
150
145
 
@@ -155,11 +150,10 @@ Present choices in the user's language. If no providers are available, skip and
155
150
 
156
151
  Do NOT wait for rate limit reset.
157
152
 
158
- ## Memory System
153
+ ## Setup
159
154
 
160
- - Failed approaches are automatically recorded as `dead_end` nodes.
161
- - Call `memory_dead_ends` before starting work to avoid repeating failed strategies.
162
- - Call `memory_store` to save findings for future sessions.
155
+ Run `/agestra setup` to select which AIs to use. Selected AIs are saved in `providers.config.json`.
156
+ All providers default to disabled until explicitly enabled via setup.
163
157
 
164
158
  ## Orchestration Pipeline
165
159