What are the five dimensions of interrogation?

The skill evaluates your design based on Scale (load and volume), Data (storage and access patterns), Security (authorization and isolation), UX Impact (latency and feedback), and Coherence (contracts and type consistency).

When should I use the System Design Interrogation skill?

You should invoke this skill during the planning or brainstorming phase, ideally after defining a feature but before writing any implementation code, to identify architectural risks early.

Does this skill help with security audits?

Yes, it specifically interrogates how tenant isolation is enforced, how authorization is handled, and what attack vectors might be introduced by a new feature.

How does this prevent breaking changes?

The Coherence dimension focuses on identifying which layers of the stack a change touches and whether it alters existing API contracts or shared TypeScript types.

System Design Interrogation

Name: System Design Interrogation
Author: yonatangross

byyonatangross

•

API Development

Evaluates architectural plans across five critical dimensions to prevent technical debt and scalability issues before implementation.

The System Design Interrogation skill acts as an architectural safety net within Claude Code, forcing a structured review of feature designs before development begins. By systematically questioning Scale, Data, Security, UX Impact, and Coherence, it helps developers identify potential bottlenecks, security vulnerabilities, and integration conflicts. This skill is essential for maintaining production-grade standards, ensuring that decisions regarding tenant isolation, data retention, and API contracts are documented and validated early in the lifecycle.

Key Features

01Coherence checking for frontend-backend contracts and type safety

02Proactive identification of scalability bottlenecks and 100x growth risks

03Structured assessment templates for consistent architectural reviews

04Security-first validation of tenant isolation and attack vectors

05Multidimensional analysis covering Scale, Data, Security, UX, and Coherence

0669 GitHub stars

Use Cases

01Pre-implementation planning for complex features to identify hidden technical debt

02Reviewing database schema changes to ensure proper tenant isolation and data access patterns

03Assessing high-traffic feature requirements to plan for expected request rates and data volume

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit system-design-interrogation

For use in Claude.ai and ChatGPT

Download Skill