kiro-retrospective

Generates evidence-backed session feedback and skill-improvement reports from kiro workflow sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? After a development session that used the kiro spec-driven workflow, there is no structured way to capture what actually worked, what wasted time, and which parts of the framework need fixing. This Skill turns a finished session into two dated, comparable reports: an engineer-experience feedback report and a triaged skill-improvement backlog for the framework maintainer. ## Core Features & Use Cases - Bounded developer interview: Runs a fixed-core interview (reuse intent, what it caught, what wasted time) with a strict question budget, logging every question and answer verbatim. - Evidence-chained friction analysis: Every reported friction must cite a trigger, signal, and cost anchored to spec artifacts, gate verdicts, or in-session corrections, with near-misses flagged as latent risks. - Triage-filtered improvement backlog: Routes each finding to SKILL-FIX, PROCESS, one-off, or LEARNING buckets so feedback does not translate 1:1 into skill edits. - Use Case: At the end of a feature implementation driven by /kiro:* commands, ask for a retro to produce feedback-<ts>.md and skill-improvements-<ts>.md under .kiro/, giving the maintainer comparable session rows over time. ## Quick Start Ask the agent to retro this session and generate the feedback and skill-improvement reports for the feature you just completed.

Frequently Asked Questions about kiro-retrospective

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

FAQPage Schema
How do I run a retrospective on a kiro workflow session?

Invoke the kiro-retrospective skill at the end of a session that used /kiro:* commands, optionally passing a feature name. It checks the session marker, interviews you with a fixed question set, and writes feedback and skill-improvements reports under .kiro/.

What reports does the kiro retrospective generate?

It writes two dated files: feedback-<ts>.md capturing the engineer's experience with verbatim interview logs and evidence-chained frictions, and skill-improvements-<ts>.md containing a triage-filtered backlog of proposed framework changes for the maintainer.

Can I run the retrospective in a different session than the one that did the work?

The check-retro-session.py script warns if the current session appears fresh, since a retro without the original transcript loses verbatim quotes and corrections. You can continue anyway, but the report is marked as reconstructed with explicit blind spots.

Does the retrospective modify my specs or skill files?

No. It is read-only on the codebase except for writing the two report files under .kiro/feedback/ and .kiro/retrospective/. Proposed changes to skills or processes go into the skill-improvements report for the maintainer to apply.

Why does the retrospective use fixed question wording and vocabulary tokens?

Fixed wording and canonical criteria tokens make every session produce one comparable row, so feedback can be measured the same way across sessions. Human-facing sections use plain-English labels while frontmatter keeps the machine-readable tokens.