architecture-interview

Guide structured architecture decisions and generate draft ADRs.

8|4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/jscraik/Agent-Skills --skill architecture-interview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-interview
Source: https://github.com/jscraik/Agent-Skills/tree/main/interview/architecture-interview
Command: npx skills add https://github.com/jscraik/Agent-Skills --skill architecture-interview

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of making and documenting critical architecture decisions, ensuring clarity, audibility, and alignment with project constraints.

Core Features & Use Cases

  • Structured Decision Making: Guides users through a series of prompts to define decisions, drivers, constraints, and alternatives.
  • ADR Generation: Automatically drafts an Architecture Decision Record (ADR) in a proposed state.
  • Use Case: When faced with choosing between microservices and a modular monolith, this Skill will facilitate the decision-making process, document the trade-offs, and produce a draft ADR for review.

Quick Start

Use the architecture-interview skill to help choose between a modular monolith and microservices for our new application.

Frequently Asked Questions about architecture-interview

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

FAQPage Schema
How do I document system design trade-offs for a new architecture decision?

To document system design trade-offs, use a guided interview process to define drivers, constraints, and alternatives, then synthesize the outputs into a proposed Architecture Decision Record (ADR).

What is the best way to choose between a modular monolith and microservices?

The best way to choose between a modular monolith and microservices is to facilitate structured decision-making by clarifying technical constraints and explicitly comparing architectural trade-offs.

How does an ADR generation interview process work?

An ADR generation interview works by guiding users through a defined spine of prompts to capture decision context, evaluate alternatives, and synthesize the final architectural choice into a draft document.

Can I use this structured decision-making process for technical strategy planning?

Yes, you can use this structured decision-making process for technical strategy planning because it clarifies system constraints and documents architectural choices with explicit trade-offs for alignment.

When do I need to generate an Architecture Decision Record?

You need to generate an Architecture Decision Record when selecting between system design alternatives, ensuring your architectural choices are auditable, clear, and aligned with project constraints.

What are the limitations of relying on a proposed ADR format for system design?

A limitation of a proposed ADR format is that it remains a draft requiring human review, meaning the structured interview outputs must be validated before finalizing technical strategy decisions.