arch-inquisitor

Interrogates software architecture designs to produce implementation-grade specifications with verified seams.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fusuyfusuy/dot-agents --skill arch-inquisitor-fusuyfusuy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-inquisitor
Source: https://github.com/fusuyfusuy/dot-agents/tree/main/skills/arch-inquisitor
Command: npx skills add https://github.com/fusuyfusuy/dot-agents --skill arch-inquisitor-fusuyfusuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture discussions often end with vague diagrams, hand-waved abstractions, and unexamined failure modes that collapse during implementation. This Skill systematically stress-tests every component boundary, protocol, data path, and failure semantic until the design is unambiguous enough to implement without further questions. ## Core Features & Use Cases - Adversarial Seam Auditing: Applies a 5-point contract (transport, schema, failure semantics, concurrency, backpressure) to every boundary between components, rejecting vague terms like "standard auth" or "eventually consistent". - Structured 5-Phase Interrogation: Walks the design from product constraints and ingress write paths through async seams, failure modes, read paths, and auth/audit, asking at most 2 targeted questions per turn. - Live System Ledger & Mermaid Diagrams: Maintains a running seam status table and a Mermaid diagram where unverified paths are explicitly marked, ending with an implementation-ready blueprint artifact. - Use Case: Before building a new order-processing service, run an interrogation session to lock down the queue broker, idempotency strategy, retry policies, and transactional boundaries so engineers can implement without ambiguity. ## Quick Start Ask the agent to interrogate the architecture of your planned system, starting with the target audience, scale expectations, and the core write path.

Frequently Asked Questions about arch-inquisitor

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

FAQPage Schema
How do I validate a software architecture before writing code?▼

Run a structured interrogation that audits every component seam against transport, schema, failure, concurrency, and backpressure contracts. The process continues until no unverified boundaries remain and the specification is detailed enough for direct implementation.

What questions should I ask when designing a distributed system?▼

Focus on the seams: delivery guarantees for message brokers, idempotency keys for writes, timeout and retry policies for external calls, and cache invalidation triggers. Vague answers like "eventually consistent" should be forced into concrete numeric bounds.

How to document system architecture with Mermaid diagrams?▼

Render only verified components and seams as solid connections, marking open questions with dotted lines labeled as unverified. Update the diagram alongside a seam ledger tracking protocol, concurrency, and failure handling status for each boundary.

When should I use an architecture interrogation process?▼

Use it before implementing complex features, new services, or subsystem boundaries where failure modes and data paths are unclear. It is less useful for trivial CRUD changes or prototypes where operational constraints do not yet matter.

What makes an architecture specification implementation-ready?▼

Every seam has explicit transport, serialization, timeout, retry, and backpressure definitions, transactional boundaries are declared for all state mutations, and a senior engineer could build the system without asking any clarifying questions.