kiro-discovery

Routes new work ideas to the correct spec workflow through structured critique dialogue.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/scapia-oss/compass --skill kiro-discovery-scapia-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-discovery
Source: https://github.com/scapia-oss/compass/tree/main/tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-discovery
Command: npx skills add https://github.com/scapia-oss/compass --skill kiro-discovery-scapia-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting new work without scoping leads to mis-sized specs, duplicated features, and silent drift between specs and code. This Skill analyzes a raw idea against existing specs, steering documents, and learnings to determine the right action path before any code or spec is written. ## Core Features & Use Cases - Action Path Routing: Classifies each request into update-existing-spec, no-spec-needed, new single spec, multi-spec decomposition, or mixed decomposition based on project state. - Architect Critique Dialogue: Pressure-tests problem framing, scope boundaries, and blast radius through one-question-per-turn dialogue grounded in the actual codebase. - Durable Briefs and Roadmaps: Writes brief.md files for new specs and roadmap.md for multi-spec decompositions so discovery analysis survives session boundaries. - Use Case: You type an idea like "add user notifications". The Skill scans existing specs, asks targeted scoping questions, proposes approaches with trade-offs, writes a brief, and recommends whether to run spec-quick or spec-init next. ## Quick Start Ask the assistant to run kiro-discovery with a description of your idea, such as "add dark mode toggle to settings page", and answer the scoping questions it asks.

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 new feature needs a spec?

Run kiro-discovery with a description of the idea. It inventories existing specs, checks whether an implemented spec already covers the change, and classifies the work as a spec update, new spec, decomposition, or direct implementation.

What is the difference between spec-quick and spec-init?

spec-quick is the faster path for small, bounded, single-domain work with up to roughly nine tasks. spec-init is the guided path for large or risky work such as public API contracts, auth, money, data migrations, or multi-repo changes, with per-phase approval gates.

Can I skip discovery for a cosmetic change like a typo fix?

Yes. When the wording clearly indicates a cosmetic or non-behavioral change, the Skill asks for explicit consent to fast-route directly to spec-quick. If you are unsure, choose No and normal discovery runs with full repo lookup.

What happens if my change affects an already implemented spec?

Behavioral changes overlapping an implemented spec are routed to update that spec's requirements before any implementation. Direct implementation is blocked because it would desync the spec from the code permanently.

Does kiro-discovery write any files or edit code?

It never edits code. It writes brief.md files for new specs and roadmap.md for multi-spec decompositions under the kiro specs directory, then recommends the next command and stops.