feat(#130): /validate-idea skill — lightweight 5-question pre-spec gate#131
Merged
Conversation
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
User Story
As a solo founder running ApexYard, I want a lightweight 5-question idea-validation skill I can invoke either standalone (
/validate-idea IDEA-NNN) or as an offered follow-up step inside/ideaand/handover, so that I have a 10-minute pre-spec gate that catches "this idea isn't worth a PRD" without needing event storming, Wardley mapping, or any heavyweight strategy ceremony.Summary
New skill at
.claude/skills/validate-idea/SKILL.md. Five questions (target user, current alternative, smallest version, kill criteria, build/buy/rent), asked one at a time, ending in a GREEN / YELLOW / RED verdict. RED automatically updates the IDEA-NNN row inprojects/ideas-backlog.mdtoWONTDO.Two integrations:
/idea— at the end of the capture flow (after the optional GitHub Issue offer), a third optional step: "Validate now? Run /validate-idea IDEA-NNN — y/n (default n)". Default-no respects the lightweight-capture intent./handover— at the end of the integration-plan emit, a conditional offer gated on a dormancy heuristic (last commit > 90 days AND zero open PRs AND no recent issue activity). Active projects don't see the prompt; dormant ones do.Why this and not something heavier
The user-and-I pair-debated the "should we add validation tooling?" question and rejected event storming + Wardley mapping as too heavy for the audience (solo founders). Both are 4–5-stakeholder workshops, neither fits the "single-Claude-session, 10 minutes max" shape ApexYard's other skills hold to (
/idea,/decide,/write-spec).The lighter alternative — five plain questions with a one-page output — fits. It nudges the user to think falsifiably (Q4 — kill criteria) and surface the build-or-rent call early (Q5), without imposing a methodology.
Testing
Skills are markdown specs — no shell test fixture. Conformance is exercised by the agent following the spec.
Smoke check on the skill structure:
The actual dogfood will be the next idea I capture — the spec is followable as-is.
Scope — what this does NOT do
/write-specon GREEN. The user makes that call separately. Decoupling validation from spec-authoring keeps each step's intent explicit.Glossary
/ideacapture and/write-specPRD authoring./handover's integration: last commit > 90d AND zero open PRs AND no recent issue activity. Triggers the "validate this is worth investing in?" prompt.Closes #130