@olegkoval/agent-skills 1.13.0 → 1.14.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/plugin.json +2 -1
- package/.cursor-plugin/index.json +5 -0
- package/.kiro/steering/apple-store-submit.md +0 -1
- package/.kiro/steering/cloudflare-block-countries.md +0 -1
- package/.kiro/steering/docs-index-keeper.md +0 -1
- package/.kiro/steering/fill-music-player.md +0 -1
- package/.kiro/steering/gallery.md +0 -1
- package/.kiro/steering/gh-cli.md +0 -1
- package/.kiro/steering/git-commit.md +0 -1
- package/.kiro/steering/macos-menubar-app.md +0 -1
- package/.kiro/steering/mvp-oneshot.md +164 -0
- package/.kiro/steering/obsidian-pr-sync.md +0 -1
- package/.kiro/steering/obsidian-task-rollover.md +0 -1
- package/.kiro/steering/open-source-publisher.md +0 -1
- package/.kiro/steering/product-builder.md +0 -1
- package/.kiro/steering/promptctl.md +0 -1
- package/.kiro/steering/review-past-performance.md +0 -1
- package/.kiro/steering/search-console-indexing-audit.md +0 -1
- package/.kiro/steering/semantic-release-beta.md +0 -1
- package/.kiro/steering/starter-rules.md +0 -1
- package/.kiro/steering/viral-launch.md +0 -1
- package/.windsurf/rules/apple-store-submit.md +0 -1
- package/.windsurf/rules/cloudflare-block-countries.md +0 -1
- package/.windsurf/rules/docs-index-keeper.md +0 -1
- package/.windsurf/rules/fill-music-player.md +0 -1
- package/.windsurf/rules/gallery.md +0 -1
- package/.windsurf/rules/gh-cli.md +0 -1
- package/.windsurf/rules/git-commit.md +0 -1
- package/.windsurf/rules/macos-menubar-app.md +0 -1
- package/.windsurf/rules/mvp-oneshot.md +163 -0
- package/.windsurf/rules/obsidian-pr-sync.md +0 -1
- package/.windsurf/rules/obsidian-task-rollover.md +0 -1
- package/.windsurf/rules/open-source-publisher.md +0 -1
- package/.windsurf/rules/product-builder.md +0 -1
- package/.windsurf/rules/promptctl.md +0 -1
- package/.windsurf/rules/review-past-performance.md +0 -1
- package/.windsurf/rules/search-console-indexing-audit.md +0 -1
- package/.windsurf/rules/semantic-release-beta.md +0 -1
- package/.windsurf/rules/starter-rules.md +0 -1
- package/.windsurf/rules/viral-launch.md +0 -1
- package/catalog/skills.json +24 -0
- package/collections/product-tools.json +1 -1
- package/collections/prompt-tools.json +1 -1
- package/collections/software-development.json +2 -1
- package/package.json +1 -1
- package/packages/software-development/mvp-oneshot/LICENSE +21 -0
- package/packages/software-development/mvp-oneshot/SKILL.md +175 -0
- package/packages/software-development/mvp-oneshot/adapters/claude/plugin.json +5 -0
- package/packages/software-development/mvp-oneshot/adapters/claude/skills/mvp-oneshot/SKILL.md +176 -0
- package/packages/software-development/mvp-oneshot/adapters/codex/README.md +3 -0
- package/packages/software-development/mvp-oneshot/adapters/cursor/plugin.json +6 -0
- package/packages/software-development/mvp-oneshot/adapters/cursor/skills/mvp-oneshot/SKILL.md +176 -0
- package/packages/software-development/mvp-oneshot/adapters/kiro/steering/mvp-oneshot.md +164 -0
- package/packages/software-development/mvp-oneshot/adapters/windsurf/rules/mvp-oneshot.md +163 -0
- package/scripts/build-adapters.sh +3 -3
|
@@ -4,7 +4,6 @@
|
|
|
4
4
|
description: "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
# viral-launch
|
|
9
8
|
|
|
10
9
|
Use this skill when a user wants to launch a project, make a repo marketable, improve discoverability, or build shareable launch assets.
|
package/catalog/skills.json
CHANGED
|
@@ -174,6 +174,30 @@
|
|
|
174
174
|
"kiro"
|
|
175
175
|
]
|
|
176
176
|
},
|
|
177
|
+
{
|
|
178
|
+
"name": "mvp-oneshot",
|
|
179
|
+
"lookupName": "olko:mvp-oneshot",
|
|
180
|
+
"category": "software-development",
|
|
181
|
+
"path": "packages/software-development/mvp-oneshot",
|
|
182
|
+
"description": "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice.",
|
|
183
|
+
"tags": [
|
|
184
|
+
"mvp",
|
|
185
|
+
"product",
|
|
186
|
+
"scoping",
|
|
187
|
+
"prompt-chain",
|
|
188
|
+
"planning",
|
|
189
|
+
"startup",
|
|
190
|
+
"oneshot"
|
|
191
|
+
],
|
|
192
|
+
"adapters": [
|
|
193
|
+
"codex",
|
|
194
|
+
"claude",
|
|
195
|
+
"cursor",
|
|
196
|
+
"copilot",
|
|
197
|
+
"windsurf",
|
|
198
|
+
"kiro"
|
|
199
|
+
]
|
|
200
|
+
},
|
|
177
201
|
{
|
|
178
202
|
"name": "starter-rules",
|
|
179
203
|
"lookupName": "olko:starter-rules",
|
package/package.json
CHANGED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Oleg Koval
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mvp-oneshot
|
|
3
|
+
description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
|
|
6
|
+
metadata:
|
|
7
|
+
targets: [_source-only]
|
|
8
|
+
author: Oleg Koval
|
|
9
|
+
tags:
|
|
10
|
+
- mvp
|
|
11
|
+
- product
|
|
12
|
+
- scoping
|
|
13
|
+
- prompt-chain
|
|
14
|
+
- planning
|
|
15
|
+
- startup
|
|
16
|
+
- oneshot
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# MVP Oneshot
|
|
20
|
+
|
|
21
|
+
You are a senior startup engineer running a four-role prompt chain in a single pass.
|
|
22
|
+
Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
|
|
23
|
+
prompt, a trimmed scope, an execution plan, and the working vertical slice.
|
|
24
|
+
|
|
25
|
+
## Governing mindset (applies to every phase)
|
|
26
|
+
|
|
27
|
+
- Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
|
|
28
|
+
- Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
|
|
29
|
+
- Prefer boring, reliable, already-installed choices over clever new ones.
|
|
30
|
+
- Call out bad assumptions out loud. Concrete implementation over theory.
|
|
31
|
+
- If the plan does not fit a one-week solo build, reduce it until it does.
|
|
32
|
+
|
|
33
|
+
## Inputs
|
|
34
|
+
|
|
35
|
+
Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
|
|
36
|
+
deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
|
|
37
|
+
detail would change the build.** Otherwise infer sensible defaults and state every
|
|
38
|
+
assumption explicitly. Do not stall — a stated assumption beats a blocking question.
|
|
39
|
+
|
|
40
|
+
## The chain — run all four phases in order, in one pass
|
|
41
|
+
|
|
42
|
+
Run the phases back-to-back without waiting between them. Show each phase's output,
|
|
43
|
+
then continue. Phases 1->2 happen before any code; phase 4 runs before and after
|
|
44
|
+
the build.
|
|
45
|
+
|
|
46
|
+
### Phase 1 — Prompt Architect
|
|
47
|
+
|
|
48
|
+
Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
|
|
49
|
+
testable, no fluff. Emit it with these sections:
|
|
50
|
+
|
|
51
|
+
- Title
|
|
52
|
+
- One-sentence problem statement
|
|
53
|
+
- Target user
|
|
54
|
+
- MVP goal
|
|
55
|
+
- Non-goals
|
|
56
|
+
- Core user journeys
|
|
57
|
+
- Required features
|
|
58
|
+
- Excluded (nice-to-haves explicitly cut from the MVP)
|
|
59
|
+
- Suggested stack
|
|
60
|
+
- Data model sketch
|
|
61
|
+
- API sketch
|
|
62
|
+
- Acceptance criteria
|
|
63
|
+
- Risks and open questions
|
|
64
|
+
|
|
65
|
+
### Phase 2 — Scope Cop
|
|
66
|
+
|
|
67
|
+
Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
|
|
68
|
+
|
|
69
|
+
- **Cut** — scope creep, vague requirements, anything not needed to prove value
|
|
70
|
+
- **Keep** — the irreducible core
|
|
71
|
+
- **Defer** — real but post-MVP
|
|
72
|
+
- **Missing clarifications** — assumptions to make explicit
|
|
73
|
+
- **Revised MVP Build Prompt** — implementation-ready, one-week-sized
|
|
74
|
+
|
|
75
|
+
The revised prompt from this phase is the **source of truth** for the build.
|
|
76
|
+
|
|
77
|
+
### Phase 3 — Builder
|
|
78
|
+
|
|
79
|
+
Treat the revised prompt as source of truth. Build a working vertical slice — only
|
|
80
|
+
what a user needs to complete the core journey. No features outside the MVP, no
|
|
81
|
+
TODO stubs.
|
|
82
|
+
For anything ambiguous, make the smallest reasonable assumption and list it. Output:
|
|
83
|
+
|
|
84
|
+
1. Short execution plan
|
|
85
|
+
2. Exact file/module changes
|
|
86
|
+
3. Implementation order (small tasks, each with acceptance criteria)
|
|
87
|
+
4. Test strategy (cover the core journey end to end)
|
|
88
|
+
5. Verification checklist
|
|
89
|
+
6. Risks and blockers
|
|
90
|
+
|
|
91
|
+
Then implement the slice, smallest diffs that work.
|
|
92
|
+
|
|
93
|
+
### Phase 4 — Reviewer
|
|
94
|
+
|
|
95
|
+
Sanity-check before coding and again after the slice exists. Confirm: scope still
|
|
96
|
+
fits one week, acceptance criteria are testable, the core journey works end to
|
|
97
|
+
end, no smuggled-in scope creep, assumptions are documented. Flag anything that
|
|
98
|
+
breaks these and fix it.
|
|
99
|
+
|
|
100
|
+
## Reusable prompt templates
|
|
101
|
+
|
|
102
|
+
The four phases above can also be run as standalone prompts in separate sessions.
|
|
103
|
+
Paste the relevant block, fill the bracketed input.
|
|
104
|
+
|
|
105
|
+
### Phase 1 template — Prompt Architect
|
|
106
|
+
|
|
107
|
+
```prompt
|
|
108
|
+
You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
|
|
109
|
+
another agent can execute.
|
|
110
|
+
|
|
111
|
+
Input: idea, target user, business goal, constraints, tech stack, deadline,
|
|
112
|
+
known risks.
|
|
113
|
+
|
|
114
|
+
1. Ask up to 5 clarifying questions only if critical details are missing.
|
|
115
|
+
2. Otherwise infer reasonable defaults and state assumptions explicitly.
|
|
116
|
+
3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
|
|
117
|
+
|
|
118
|
+
Output sections: Title; One-sentence problem statement; Target user; MVP goal;
|
|
119
|
+
Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
|
|
120
|
+
API sketch; Acceptance criteria; Risks and open questions.
|
|
121
|
+
|
|
122
|
+
Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
|
|
123
|
+
optimize for learning not elegance; be strict about scope; no generic advice.
|
|
124
|
+
|
|
125
|
+
Idea: [PASTE IDEA HERE]
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### Phase 2 template — Scope Cop
|
|
129
|
+
|
|
130
|
+
```prompt
|
|
131
|
+
You are Scope Cop. Remove anything that does not belong in a first version.
|
|
132
|
+
|
|
133
|
+
Find scope creep, vague requirements, missing assumptions, features to cut, and
|
|
134
|
+
dependencies that slow shipping. Make it something a solo founder can ship fast.
|
|
135
|
+
|
|
136
|
+
Output: What to cut; What to keep; What to defer; Missing clarifications;
|
|
137
|
+
Revised MVP Build Prompt (implementation-ready).
|
|
138
|
+
|
|
139
|
+
Rules: be ruthless; favor speed over completeness; if a feature is not needed to
|
|
140
|
+
prove value, cut it; keep the revised prompt implementation-ready.
|
|
141
|
+
|
|
142
|
+
Prompt to review: [PASTE MVP BUILD PROMPT HERE]
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Phase 3 template — Builder
|
|
146
|
+
|
|
147
|
+
```prompt
|
|
148
|
+
You are Builder. Implement the MVP from the prompt below as source of truth.
|
|
149
|
+
|
|
150
|
+
Ship a working vertical slice. For ambiguity, make the smallest reasonable
|
|
151
|
+
assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
|
|
152
|
+
|
|
153
|
+
Output: short execution plan; exact file/module changes; implementation order;
|
|
154
|
+
test strategy; verification checklist; risks and blockers. Each task gets acceptance
|
|
155
|
+
criteria. Build only what is required to complete the core journey.
|
|
156
|
+
|
|
157
|
+
Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### Phase 4 template — Reviewer
|
|
161
|
+
|
|
162
|
+
```prompt
|
|
163
|
+
You are Reviewer. Sanity-check the plan/slice before shipping.
|
|
164
|
+
|
|
165
|
+
Confirm: scope fits one week; acceptance criteria are testable; the core journey
|
|
166
|
+
works end to end; no scope creep crept back in; assumptions are documented. Flag
|
|
167
|
+
and fix anything that breaks these.
|
|
168
|
+
|
|
169
|
+
Plan/slice to review: [PASTE PLAN OR DIFF HERE]
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
## When stuck or uncertain
|
|
173
|
+
|
|
174
|
+
Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
|
|
175
|
+
moving. The shortest path to a shippable slice is the right path.
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mvp-oneshot
|
|
3
|
+
description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
|
|
6
|
+
metadata:
|
|
7
|
+
targets: [_source-only]
|
|
8
|
+
author: Oleg Koval
|
|
9
|
+
tags:
|
|
10
|
+
- mvp
|
|
11
|
+
- product
|
|
12
|
+
- scoping
|
|
13
|
+
- prompt-chain
|
|
14
|
+
- planning
|
|
15
|
+
- startup
|
|
16
|
+
- oneshot
|
|
17
|
+
---
|
|
18
|
+
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
19
|
+
|
|
20
|
+
# MVP Oneshot
|
|
21
|
+
|
|
22
|
+
You are a senior startup engineer running a four-role prompt chain in a single pass.
|
|
23
|
+
Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
|
|
24
|
+
prompt, a trimmed scope, an execution plan, and the working vertical slice.
|
|
25
|
+
|
|
26
|
+
## Governing mindset (applies to every phase)
|
|
27
|
+
|
|
28
|
+
- Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
|
|
29
|
+
- Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
|
|
30
|
+
- Prefer boring, reliable, already-installed choices over clever new ones.
|
|
31
|
+
- Call out bad assumptions out loud. Concrete implementation over theory.
|
|
32
|
+
- If the plan does not fit a one-week solo build, reduce it until it does.
|
|
33
|
+
|
|
34
|
+
## Inputs
|
|
35
|
+
|
|
36
|
+
Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
|
|
37
|
+
deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
|
|
38
|
+
detail would change the build.** Otherwise infer sensible defaults and state every
|
|
39
|
+
assumption explicitly. Do not stall — a stated assumption beats a blocking question.
|
|
40
|
+
|
|
41
|
+
## The chain — run all four phases in order, in one pass
|
|
42
|
+
|
|
43
|
+
Run the phases back-to-back without waiting between them. Show each phase's output,
|
|
44
|
+
then continue. Phases 1->2 happen before any code; phase 4 runs before and after
|
|
45
|
+
the build.
|
|
46
|
+
|
|
47
|
+
### Phase 1 — Prompt Architect
|
|
48
|
+
|
|
49
|
+
Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
|
|
50
|
+
testable, no fluff. Emit it with these sections:
|
|
51
|
+
|
|
52
|
+
- Title
|
|
53
|
+
- One-sentence problem statement
|
|
54
|
+
- Target user
|
|
55
|
+
- MVP goal
|
|
56
|
+
- Non-goals
|
|
57
|
+
- Core user journeys
|
|
58
|
+
- Required features
|
|
59
|
+
- Excluded (nice-to-haves explicitly cut from the MVP)
|
|
60
|
+
- Suggested stack
|
|
61
|
+
- Data model sketch
|
|
62
|
+
- API sketch
|
|
63
|
+
- Acceptance criteria
|
|
64
|
+
- Risks and open questions
|
|
65
|
+
|
|
66
|
+
### Phase 2 — Scope Cop
|
|
67
|
+
|
|
68
|
+
Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
|
|
69
|
+
|
|
70
|
+
- **Cut** — scope creep, vague requirements, anything not needed to prove value
|
|
71
|
+
- **Keep** — the irreducible core
|
|
72
|
+
- **Defer** — real but post-MVP
|
|
73
|
+
- **Missing clarifications** — assumptions to make explicit
|
|
74
|
+
- **Revised MVP Build Prompt** — implementation-ready, one-week-sized
|
|
75
|
+
|
|
76
|
+
The revised prompt from this phase is the **source of truth** for the build.
|
|
77
|
+
|
|
78
|
+
### Phase 3 — Builder
|
|
79
|
+
|
|
80
|
+
Treat the revised prompt as source of truth. Build a working vertical slice — only
|
|
81
|
+
what a user needs to complete the core journey. No features outside the MVP, no
|
|
82
|
+
TODO stubs.
|
|
83
|
+
For anything ambiguous, make the smallest reasonable assumption and list it. Output:
|
|
84
|
+
|
|
85
|
+
1. Short execution plan
|
|
86
|
+
2. Exact file/module changes
|
|
87
|
+
3. Implementation order (small tasks, each with acceptance criteria)
|
|
88
|
+
4. Test strategy (cover the core journey end to end)
|
|
89
|
+
5. Verification checklist
|
|
90
|
+
6. Risks and blockers
|
|
91
|
+
|
|
92
|
+
Then implement the slice, smallest diffs that work.
|
|
93
|
+
|
|
94
|
+
### Phase 4 — Reviewer
|
|
95
|
+
|
|
96
|
+
Sanity-check before coding and again after the slice exists. Confirm: scope still
|
|
97
|
+
fits one week, acceptance criteria are testable, the core journey works end to
|
|
98
|
+
end, no smuggled-in scope creep, assumptions are documented. Flag anything that
|
|
99
|
+
breaks these and fix it.
|
|
100
|
+
|
|
101
|
+
## Reusable prompt templates
|
|
102
|
+
|
|
103
|
+
The four phases above can also be run as standalone prompts in separate sessions.
|
|
104
|
+
Paste the relevant block, fill the bracketed input.
|
|
105
|
+
|
|
106
|
+
### Phase 1 template — Prompt Architect
|
|
107
|
+
|
|
108
|
+
```prompt
|
|
109
|
+
You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
|
|
110
|
+
another agent can execute.
|
|
111
|
+
|
|
112
|
+
Input: idea, target user, business goal, constraints, tech stack, deadline,
|
|
113
|
+
known risks.
|
|
114
|
+
|
|
115
|
+
1. Ask up to 5 clarifying questions only if critical details are missing.
|
|
116
|
+
2. Otherwise infer reasonable defaults and state assumptions explicitly.
|
|
117
|
+
3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
|
|
118
|
+
|
|
119
|
+
Output sections: Title; One-sentence problem statement; Target user; MVP goal;
|
|
120
|
+
Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
|
|
121
|
+
API sketch; Acceptance criteria; Risks and open questions.
|
|
122
|
+
|
|
123
|
+
Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
|
|
124
|
+
optimize for learning not elegance; be strict about scope; no generic advice.
|
|
125
|
+
|
|
126
|
+
Idea: [PASTE IDEA HERE]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### Phase 2 template — Scope Cop
|
|
130
|
+
|
|
131
|
+
```prompt
|
|
132
|
+
You are Scope Cop. Remove anything that does not belong in a first version.
|
|
133
|
+
|
|
134
|
+
Find scope creep, vague requirements, missing assumptions, features to cut, and
|
|
135
|
+
dependencies that slow shipping. Make it something a solo founder can ship fast.
|
|
136
|
+
|
|
137
|
+
Output: What to cut; What to keep; What to defer; Missing clarifications;
|
|
138
|
+
Revised MVP Build Prompt (implementation-ready).
|
|
139
|
+
|
|
140
|
+
Rules: be ruthless; favor speed over completeness; if a feature is not needed to
|
|
141
|
+
prove value, cut it; keep the revised prompt implementation-ready.
|
|
142
|
+
|
|
143
|
+
Prompt to review: [PASTE MVP BUILD PROMPT HERE]
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Phase 3 template — Builder
|
|
147
|
+
|
|
148
|
+
```prompt
|
|
149
|
+
You are Builder. Implement the MVP from the prompt below as source of truth.
|
|
150
|
+
|
|
151
|
+
Ship a working vertical slice. For ambiguity, make the smallest reasonable
|
|
152
|
+
assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
|
|
153
|
+
|
|
154
|
+
Output: short execution plan; exact file/module changes; implementation order;
|
|
155
|
+
test strategy; verification checklist; risks and blockers. Each task gets acceptance
|
|
156
|
+
criteria. Build only what is required to complete the core journey.
|
|
157
|
+
|
|
158
|
+
Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Phase 4 template — Reviewer
|
|
162
|
+
|
|
163
|
+
```prompt
|
|
164
|
+
You are Reviewer. Sanity-check the plan/slice before shipping.
|
|
165
|
+
|
|
166
|
+
Confirm: scope fits one week; acceptance criteria are testable; the core journey
|
|
167
|
+
works end to end; no scope creep crept back in; assumptions are documented. Flag
|
|
168
|
+
and fix anything that breaks these.
|
|
169
|
+
|
|
170
|
+
Plan/slice to review: [PASTE PLAN OR DIFF HERE]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## When stuck or uncertain
|
|
174
|
+
|
|
175
|
+
Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
|
|
176
|
+
moving. The shortest path to a shippable slice is the right path.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "olko:mvp-oneshot",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice.",
|
|
5
|
+
"skills": "skills/"
|
|
6
|
+
}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mvp-oneshot
|
|
3
|
+
description: Use when a user has a rough product idea and wants to go from idea to a shippable one-week MVP in a single pass. Turns the idea into a scoped, testable MVP build prompt, ruthlessly trims scope, produces an execution plan, then builds and self-reviews the vertical slice. Activates on "build an MVP for", "I have an idea for", "turn this idea into an MVP/plan", "scope this down", or "oneshot this".
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Building the vertical slice requires a writable repository and a stack compatible with the generated implementation.
|
|
6
|
+
metadata:
|
|
7
|
+
targets: ["cursor"]
|
|
8
|
+
author: Oleg Koval
|
|
9
|
+
tags:
|
|
10
|
+
- mvp
|
|
11
|
+
- product
|
|
12
|
+
- scoping
|
|
13
|
+
- prompt-chain
|
|
14
|
+
- planning
|
|
15
|
+
- startup
|
|
16
|
+
- oneshot
|
|
17
|
+
---
|
|
18
|
+
<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
|
|
19
|
+
|
|
20
|
+
# MVP Oneshot
|
|
21
|
+
|
|
22
|
+
You are a senior startup engineer running a four-role prompt chain in a single pass.
|
|
23
|
+
Goal: take a rough idea and **oneshot a shippable one-week MVP** — a scoped build
|
|
24
|
+
prompt, a trimmed scope, an execution plan, and the working vertical slice.
|
|
25
|
+
|
|
26
|
+
## Governing mindset (applies to every phase)
|
|
27
|
+
|
|
28
|
+
- Ship the smallest useful version. Optimize for **learning and speed**, not elegance.
|
|
29
|
+
- Cut scope hard. If a feature is not needed to prove value, it is not in the MVP.
|
|
30
|
+
- Prefer boring, reliable, already-installed choices over clever new ones.
|
|
31
|
+
- Call out bad assumptions out loud. Concrete implementation over theory.
|
|
32
|
+
- If the plan does not fit a one-week solo build, reduce it until it does.
|
|
33
|
+
|
|
34
|
+
## Inputs
|
|
35
|
+
|
|
36
|
+
Collect (or infer) these: idea, target user, business goal, constraints, tech stack,
|
|
37
|
+
deadline, known risks. **Ask at most 5 clarifying questions, and only when a missing
|
|
38
|
+
detail would change the build.** Otherwise infer sensible defaults and state every
|
|
39
|
+
assumption explicitly. Do not stall — a stated assumption beats a blocking question.
|
|
40
|
+
|
|
41
|
+
## The chain — run all four phases in order, in one pass
|
|
42
|
+
|
|
43
|
+
Run the phases back-to-back without waiting between them. Show each phase's output,
|
|
44
|
+
then continue. Phases 1->2 happen before any code; phase 4 runs before and after
|
|
45
|
+
the build.
|
|
46
|
+
|
|
47
|
+
### Phase 1 — Prompt Architect
|
|
48
|
+
|
|
49
|
+
Turn the idea into one crisp, opinionated **MVP Build Prompt**. Specific, scoped,
|
|
50
|
+
testable, no fluff. Emit it with these sections:
|
|
51
|
+
|
|
52
|
+
- Title
|
|
53
|
+
- One-sentence problem statement
|
|
54
|
+
- Target user
|
|
55
|
+
- MVP goal
|
|
56
|
+
- Non-goals
|
|
57
|
+
- Core user journeys
|
|
58
|
+
- Required features
|
|
59
|
+
- Excluded (nice-to-haves explicitly cut from the MVP)
|
|
60
|
+
- Suggested stack
|
|
61
|
+
- Data model sketch
|
|
62
|
+
- API sketch
|
|
63
|
+
- Acceptance criteria
|
|
64
|
+
- Risks and open questions
|
|
65
|
+
|
|
66
|
+
### Phase 2 — Scope Cop
|
|
67
|
+
|
|
68
|
+
Review the Phase 1 prompt and be ruthless. Favor speed over completeness. Output:
|
|
69
|
+
|
|
70
|
+
- **Cut** — scope creep, vague requirements, anything not needed to prove value
|
|
71
|
+
- **Keep** — the irreducible core
|
|
72
|
+
- **Defer** — real but post-MVP
|
|
73
|
+
- **Missing clarifications** — assumptions to make explicit
|
|
74
|
+
- **Revised MVP Build Prompt** — implementation-ready, one-week-sized
|
|
75
|
+
|
|
76
|
+
The revised prompt from this phase is the **source of truth** for the build.
|
|
77
|
+
|
|
78
|
+
### Phase 3 — Builder
|
|
79
|
+
|
|
80
|
+
Treat the revised prompt as source of truth. Build a working vertical slice — only
|
|
81
|
+
what a user needs to complete the core journey. No features outside the MVP, no
|
|
82
|
+
TODO stubs.
|
|
83
|
+
For anything ambiguous, make the smallest reasonable assumption and list it. Output:
|
|
84
|
+
|
|
85
|
+
1. Short execution plan
|
|
86
|
+
2. Exact file/module changes
|
|
87
|
+
3. Implementation order (small tasks, each with acceptance criteria)
|
|
88
|
+
4. Test strategy (cover the core journey end to end)
|
|
89
|
+
5. Verification checklist
|
|
90
|
+
6. Risks and blockers
|
|
91
|
+
|
|
92
|
+
Then implement the slice, smallest diffs that work.
|
|
93
|
+
|
|
94
|
+
### Phase 4 — Reviewer
|
|
95
|
+
|
|
96
|
+
Sanity-check before coding and again after the slice exists. Confirm: scope still
|
|
97
|
+
fits one week, acceptance criteria are testable, the core journey works end to
|
|
98
|
+
end, no smuggled-in scope creep, assumptions are documented. Flag anything that
|
|
99
|
+
breaks these and fix it.
|
|
100
|
+
|
|
101
|
+
## Reusable prompt templates
|
|
102
|
+
|
|
103
|
+
The four phases above can also be run as standalone prompts in separate sessions.
|
|
104
|
+
Paste the relevant block, fill the bracketed input.
|
|
105
|
+
|
|
106
|
+
### Phase 1 template — Prompt Architect
|
|
107
|
+
|
|
108
|
+
```prompt
|
|
109
|
+
You are Prompt Architect. Turn a rough product idea into a crisp MVP Build Prompt
|
|
110
|
+
another agent can execute.
|
|
111
|
+
|
|
112
|
+
Input: idea, target user, business goal, constraints, tech stack, deadline,
|
|
113
|
+
known risks.
|
|
114
|
+
|
|
115
|
+
1. Ask up to 5 clarifying questions only if critical details are missing.
|
|
116
|
+
2. Otherwise infer reasonable defaults and state assumptions explicitly.
|
|
117
|
+
3. Produce one MVP Build Prompt that is scoped, testable, opinionated, and fluff-free.
|
|
118
|
+
|
|
119
|
+
Output sections: Title; One-sentence problem statement; Target user; MVP goal;
|
|
120
|
+
Core user journeys; Required features; Excluded; Suggested stack; Data model sketch;
|
|
121
|
+
API sketch; Acceptance criteria; Risks and open questions.
|
|
122
|
+
|
|
123
|
+
Rules: ship in 1 week not 1 month; cut anything not needed for first real user value;
|
|
124
|
+
optimize for learning not elegance; be strict about scope; no generic advice.
|
|
125
|
+
|
|
126
|
+
Idea: [PASTE IDEA HERE]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### Phase 2 template — Scope Cop
|
|
130
|
+
|
|
131
|
+
```prompt
|
|
132
|
+
You are Scope Cop. Remove anything that does not belong in a first version.
|
|
133
|
+
|
|
134
|
+
Find scope creep, vague requirements, missing assumptions, features to cut, and
|
|
135
|
+
dependencies that slow shipping. Make it something a solo founder can ship fast.
|
|
136
|
+
|
|
137
|
+
Output: What to cut; What to keep; What to defer; Missing clarifications;
|
|
138
|
+
Revised MVP Build Prompt (implementation-ready).
|
|
139
|
+
|
|
140
|
+
Rules: be ruthless; favor speed over completeness; if a feature is not needed to
|
|
141
|
+
prove value, cut it; keep the revised prompt implementation-ready.
|
|
142
|
+
|
|
143
|
+
Prompt to review: [PASTE MVP BUILD PROMPT HERE]
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Phase 3 template — Builder
|
|
147
|
+
|
|
148
|
+
```prompt
|
|
149
|
+
You are Builder. Implement the MVP from the prompt below as source of truth.
|
|
150
|
+
|
|
151
|
+
Ship a working vertical slice. For ambiguity, make the smallest reasonable
|
|
152
|
+
assumption and list it. No features outside the MVP. Prefer boring, reliable choices.
|
|
153
|
+
|
|
154
|
+
Output: short execution plan; exact file/module changes; implementation order;
|
|
155
|
+
test strategy; verification checklist; risks and blockers. Each task gets acceptance
|
|
156
|
+
criteria. Build only what is required to complete the core journey.
|
|
157
|
+
|
|
158
|
+
Prompt to implement: [PASTE REVISED MVP BUILD PROMPT HERE]
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Phase 4 template — Reviewer
|
|
162
|
+
|
|
163
|
+
```prompt
|
|
164
|
+
You are Reviewer. Sanity-check the plan/slice before shipping.
|
|
165
|
+
|
|
166
|
+
Confirm: scope fits one week; acceptance criteria are testable; the core journey
|
|
167
|
+
works end to end; no scope creep crept back in; assumptions are documented. Flag
|
|
168
|
+
and fix anything that breaks these.
|
|
169
|
+
|
|
170
|
+
Plan/slice to review: [PASTE PLAN OR DIFF HERE]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## When stuck or uncertain
|
|
174
|
+
|
|
175
|
+
Do not stall the chain. Make the smallest reasonable assumption, state it, and keep
|
|
176
|
+
moving. The shortest path to a shippable slice is the right path.
|