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.