abildtoft/kramme:siw:remove

Remove Structured Implementation Workflow Files

Delete SIW-related files from the siw/ folder in the current working directory. This is the destructive cleanup path for SIW workflow documents after implementation is complete.

If you want to preserve accumulated knowledge as permanent documentation, use /kramme:siw:close instead. If you want to start a fresh iteration on the same project, use /kramme:siw:reset.

Target Files

Temporary (always candidates for deletion):

• siw/LOG.md — Session progress and decisions
• siw/OPEN_ISSUES_OVERVIEW.md — Issue tracking table
• siw/AUDIT_IMPLEMENTATION_REPORT.md — Spec compliance audit report
• siw/AUDIT_SPEC_REPORT.md — Spec quality audit report
• siw/PRODUCT_AUDIT.md — Product audit report
• siw/SIW_*.md — Other temporary SIW artifacts
• siw/SPEC_STRENGTHENING_PLAN.md — Refinement discovery output (this command deletes it, unlike /kramme:siw:close)
• siw/DISCOVERY_BRIEF.md — Greenfield discovery output
• siw/issues/ — Individual issue files
• siw/qa-intake/ — QA intake parent summaries

Permanent (optional, requires explicit confirmation):

• Specification files in siw/ matching *SPEC*.md, *SPECIFICATION*.md, *PLAN*.md, or *DESIGN*.md, excluding SPEC_STRENGTHENING_PLAN.md, DISCOVERY_BRIEF.md, AUDIT_*.md, PRODUCT_AUDIT.md, and SIW_*.md
• siw/supporting-specs/ — Numbered supporting specs
• siw/contracts/ — Contract specs selected by transfer-to-Linear migrations

Only files discovered in Step 1 are deleted, listed in the confirmation prompt, or reported as deleted. Items in the lists above that do not exist on disk are ignored.

Workflow

Step 1: Scan for SIW Files

Discover what exists. Record two lists from the output:

• found_temporary — temp files and directories
• found_permanent — spec/permanent files plus siw/supporting-specs/ and siw/contracts/ if present

ls -d siw/LOG.md siw/OPEN_ISSUES_OVERVIEW.md siw/AUDIT_IMPLEMENTATION_REPORT.md siw/AUDIT_SPEC_REPORT.md siw/PRODUCT_AUDIT.md siw/SIW_*.md siw/SPEC_STRENGTHENING_PLAN.md siw/DISCOVERY_BRIEF.md siw/issues siw/qa-intake 2> /dev/null
# Synced SIW spec-exclusion contract (keep aligned across SIW spec detectors): `LOG.md`, `OPEN_ISSUES_OVERVIEW.md`, `DISCOVERY_BRIEF.md`, `SPEC_STRENGTHENING_PLAN.md`, `AUDIT_*.md`, `PRODUCT_AUDIT.md`, `SIW_*.md`.
find siw -maxdepth 1 -type f \( -name "*SPEC*.md" -o -name "*SPECIFICATION*.md" -o -name "*PLAN*.md" -o -name "*DESIGN*.md" \) \
  ! -name "SPEC_STRENGTHENING_PLAN.md" \
  ! -name "DISCOVERY_BRIEF.md" \
  ! -name "AUDIT_*.md" \
  ! -name "PRODUCT_AUDIT.md" \
  ! -name "SIW_*.md" \
  2> /dev/null
for dir in siw/supporting-specs siw/contracts; do
  [ -d "$dir" ] && printf '%s\n' "$dir"
done

If both lists are empty:

No SIW workflow files found in this directory.

Stop.

Step 2: Check for Uncommitted Changes

git status --porcelain -- siw/ 2> /dev/null

If any output exists, warn the user before proceeding to confirmation:

Warning: There are uncommitted changes to SIW files:
{paths from porcelain output, one per line}

If `trash` is available, these will be recoverable from the system Trash. Otherwise they will be permanently lost.

If the working tree is clean or not a git repo, skip the warning. Continue to Step 3 either way.

Step 3: Confirm Deletion

Use AskUserQuestion. Build option descriptions from the actual contents of found_temporary and found_permanent — do not list files that were not found in Step 1.

header: "Delete SIW Files"
question: "Found {len(found_temporary)} temporary item(s){, plus {len(found_permanent)} permanent item(s) if non-empty}. Which should I delete?"
options:
  - label: "Temporary files only"
    description: "Delete: {comma-separated paths in found_temporary}. Keep permanent files."
  - label: "All SIW files"
    description: "Delete the temporary items plus: {comma-separated paths in found_permanent}."
  - label: "Abort"
    description: "Cancel and keep all files"

If found_permanent is empty, omit the "All SIW files" option.

Step 4: Delete Files

Determine the deletion set from the user's selection:

• "Temporary files only" → delete_set = found_temporary
• "All SIW files" → delete_set = found_temporary + found_permanent

Prefer trash for recoverability. Build delete_set from paths that were discovered in Step 1 and selected in Step 3. Expand any globs before deletion so unmatched patterns are never reported as deleted. If delete_set is empty after filtering to existing paths, skip the deletion command and report that nothing matched the selection.

Delete directories by passing them to trash as normal path arguments; do not pass recursive flags to trash. Do not suppress deletion errors. Capture stderr/stdout so any failure can be reported.

trash <each path in delete_set>

If trash is not installed, warn and fall back to rm:

Warning: 'trash' command not found. Files will be permanently deleted.
Install with `brew install trash` (macOS) or your distro's `trash-cli` package (Linux).

# Ask for explicit confirmation after the permanent-deletion warning, then run:
rm -rf <each path in delete_set>

After deletion, verify every target with [ ! -e "$path" ]. Record only verified-absent paths in deleted_paths. Record any surviving paths in failed_delete_paths with the captured error output; these must be reported as failures instead of "Deleted".

Step 5: Clean Up Empty siw/

After deletion, remove leftover .gitkeep placeholders only from directories included in the confirmed delete_set. Do not remove .gitkeep files from directories the user chose to keep. Then remove only directories from the confirmed delete_set, plus siw/ itself, and only when they are empty.

Record whether siw/ itself was removed for the report.

Step 6: Report Results

Report only paths that were actually in delete_set:

SIW Cleanup Complete

Deleted:
{each path in deleted_paths, one per line}

Failed to delete:
{each path in failed_delete_paths with error, one per line; omit section if empty}

{If using trash: Files moved to Trash and can be restored if needed.}
{If siw/ was removed: siw/ directory removed.}

Important Notes

1. trash keeps deletions recoverable — prefer it over rm whenever it is installed.
2. Permanent files default to kept — the "All SIW files" option must be explicitly selected to delete spec files, siw/supporting-specs/, and siw/contracts/.
3. Works with /kramme:siw:init — the workflow can be re-initialized after cleanup.