kiro-spec-cleanup

Consolidate specification documents by removing implementation details while preserving design decisions.

1.5k|242|Updated Feb 16, 2017
One-click install
npx skills add https://github.com/growilabs/growi --skill kiro-spec-cleanup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kiro-spec-cleanup
Source: https://github.com/growilabs/growi/tree/main/.claude/skills/kiro-spec-cleanup
Command: npx skills add https://github.com/growilabs/growi --skill kiro-spec-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize and trim specification documents after implementation, removing implementation details while preserving essential context for future refactoring.

Core Features & Use Cases

  • Load context from spec files and identify core sections to preserve
  • Maintain design decisions, boundary commitments, and traceability while removing HOW-to content
  • Enable interactive confirmation and migration planning to research/design sections

Quick Start

Validate the implementation with /kiro-validate-impl <feature> and then initiate the cleanup workflow with /kiro-spec-cleanup <feature>.

Frequently Asked Questions about kiro-spec-cleanup

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

FAQPage Schema
How do I clean up specification documents after implementation without losing context?▼

Spec cleanup consolidates specification documents by removing implementation-specific HOW-to content while preserving essential design decisions and boundary commitments. This refactoring maintains traceability for future feature updates and ensures safe, auditable documentation.

When should I refactor design docs to remove implementation details?▼

Refactor design docs during post-implementation workflows when you need to transition active development documents into long-term reference material. This process prunes clutter while documenting boundary constraints and design decisions for future audits.

How do I preserve design rationale and boundary constraints during documentation refactoring?▼

Documentation refactoring preserves rationale by maintaining core sections that document design decisions and boundary commitments. It identifies and retains traceability references while migrating implementation-specific details to research or design sections.

Does spec cleanup support interactive confirmation before removing content?▼

Yes, spec cleanup supports interactive confirmation and migration planning. This allows you to review identified implementation-specific content and safely migrate HOW-to details to research or design sections before they are pruned from the document.

What is the best way to prepare specification files for future feature refactoring?▼

The best way to prepare is to validate the implementation first, then initiate a cleanup workflow that prunes implementation clutter while preserving core sections, design decisions, and boundary commitments. This ensures documentation remains a reliable foundation for future work.