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/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/README.ja.md +8 -27
- package/README.ko.md +244 -263
- package/README.md +244 -263
- package/README.zh.md +8 -27
- package/agents/agestra-designer.md +20 -4
- package/agents/agestra-ideator.md +20 -5
- package/agents/agestra-moderator.md +34 -17
- package/agents/agestra-qa.md +20 -5
- package/agents/agestra-reviewer.md +20 -3
- package/agents/agestra-team-lead.md +93 -80
- package/commands/design.md +26 -56
- package/commands/idea.md +22 -56
- package/commands/review.md +63 -93
- package/dist/bundle.js +423 -624
- package/hooks/user-prompt-submit.js +90 -25
- package/package.json +1 -1
- package/skills/design.md +29 -52
- package/skills/idea.md +307 -212
- package/skills/provider-guide.md +15 -21
- package/skills/review.md +45 -66
- package/skills/setup.md +98 -0
- package/skills/trace.md +3 -2
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?
|
|
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?" |
|
|
66
|
-
| Core | "
|
|
67
|
-
| Boundary | "What should it NOT be?
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
(
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
-
|
|
204
|
-
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
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.
|
package/skills/provider-guide.md
CHANGED
|
@@ -50,13 +50,14 @@ Full-capability agents. Use for:
|
|
|
50
50
|
|
|
51
51
|
### Text Work (리뷰/설계/아이디어)
|
|
52
52
|
|
|
53
|
-
|
|
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 |
|
|
58
|
-
|
|
|
59
|
-
|
|
57
|
+
| **Claude only** | Specialist agent works alone | No external providers available |
|
|
58
|
+
| **끝장토론** | Independent work → aggregation → review 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
136
|
+
### Hook-Triggered Flow
|
|
141
137
|
|
|
142
|
-
|
|
143
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
153
|
+
## Setup
|
|
159
154
|
|
|
160
|
-
|
|
161
|
-
|
|
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
|
|