kiro-discovery

Routes new feature requests to the correct spec path and writes discovery briefs to disk.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-discovery-j5ik2o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-discovery
Source: https://github.com/j5ik2o/marp-ai-base/tree/main/.agents/skills/kiro-discovery
Command: npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-discovery-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting new work in a spec-driven project, it is unclear whether a request needs a new spec, an update to an existing spec, a multi-spec decomposition, or no spec at all. This Skill removes that ambiguity by scanning project state and guiding a structured discovery dialogue before any spec work begins. ## Core Features & Use Cases - Action Path Routing: Scans .kiro/specs and .kiro/steering metadata to classify requests into five paths: existing spec update, no spec needed, new single spec, multi-spec decomposition, or mixed decomposition. - Structured Discovery Dialogue: Asks sequential clarifying questions about users, outcomes, boundaries, and constraints, then proposes 2-3 approaches with trade-offs and a viability check. - Persistent Artifacts: Writes brief.md files for new specs and roadmap.md for decomposed projects to disk so discovery results survive session boundaries. - Use Case: A user asks to add real-time collaboration to an existing app. The Skill detects overlapping specs, decomposes the work into three ordered specs, writes a roadmap and briefs, then suggests running the batch spec command. ## Quick Start Ask the assistant to run discovery for your new feature idea so it can determine the right spec path and produce an actionable brief.

Frequently Asked Questions about kiro-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide whether a feature request needs a new spec?

Run discovery to scan existing specs and steering files, then classify the request into a path: update an existing spec, create a new spec, decompose into multiple specs, or skip specs entirely for trivial changes.

How to decompose a large feature into multiple specs?

The Skill identifies natural responsibility boundaries through sequential questions, then writes a roadmap.md listing specs in dependency order plus a brief.md for each new spec, enabling parallel spec creation.

What files does the discovery process create?

It writes brief.md under .kiro/specs/<feature-name>/ for each new spec and roadmap.md under .kiro/steering/ for multi-spec or mixed decompositions. Files are written before any next command is suggested.

When should a request skip the spec process entirely?

Bug fixes, config changes, simple refactors, and trivial additions follow Path B and proceed directly to implementation without creating or updating any spec.

What happens if a roadmap already exists from a previous session?

The Skill reads the existing roadmap.md to restore project context, writes a brief only for the next pending spec, and appends new phases without overwriting completed items.