review-spec

name	review-spec
description	Interactive specification review session. Pulls all specs and architecture decisions for the current project and walks through them with the user to verify accuracy, update, or archive. Use when reviewing technical documentation, validating architecture decisions, or cleaning up outdated specs.

Dude Review Specs - Interactive Spec Review

Walk through all specifications and architecture decisions for the current project with the user.

Workflow

When this skill is invoked, follow these steps in order:

Step 1: Fetch Specs

Call these in parallel:

dude_list_records { "kind": "spec", "status": "open" }
dude_list_records { "kind": "arch", "status": "open" }
dude_list_records { "kind": "spec", "status": "archived" }

Step 2: Present Summary

Show the user a summary of what exists:

• Total active specs
• Total active architecture decisions
• Total archived specs
• Group active records by prefix: AUTH, API, ARCH, DATA, UI, Other
• List each active record with its ID, kind, and title

Step 3: Walk Through Active Specs

For each active spec, present it (including body if present) and ask the user:

1. Still accurate? — If not, ask what changed and update it
2. Outdated? — If yes, archive it
3. Needs refinement? — If yes, ask for updates
4. Keep as-is? — Move on

Apply changes immediately using:

dude_upsert_record { "id": <record_id>, "kind": "spec", "title": "<updated_title>", "body": "<updated_body>", "status": "<new_status>" }

Step 4: Walk Through Architecture Decisions