arch-spec-review

What problem does it solve?

Architecture documents often drift into implementation details, omit clear boundaries, or fail to state constraints and extension points, making them hard to review and evolve; this Skill helps reviewers keep specifications at the right level of abstraction and identify genuine architectural gaps.

Core Features & Use Cases

• Abstraction discipline: Highlights when a spec is asking for "how" instead of "who" and "what".
• Completeness checks: Verifies boundaries, primary flows, error handling boundaries, constraints, extension points, and deferred decisions.
• Review structure: Produces focused findings that separate architectural questions from implementation requests.
• Use Case: Use to review a top-level system design doc before implementation planning to ensure responsibilities, flows, and guarantees are clear without prescribing technologies.

Quick Start

Review the attached architecture document for clear component responsibilities, end-to-end flows, stated constraints, extension points, and any improperly specified implementation details.