Architecture Interview

Analyze, review, and plan architecture alternatives through a structured interview. Use when the user needs tradeoffs surfaced before implementation or a Linear decision note instead of an ADR.

9 stars 4 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill architecture-interview
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/product-strategy/architecture-interview ~/.claude/skills/architecture-interview

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Architecture Interview

Analyze, review, or plan architecture alternatives through a structured interview when the user needs tradeoffs surfaced before implementation or Linear decision capture.

## Philosophy
- Architecture is decision-making under constraints, not a tour of every possible pattern.
- The useful output names what is chosen, what is sacrificed, and what must be verified.
- For Jamie projects, capture durable decisions in Linear-ready notes instead of ADR files unless explicitly requested.

## When To Use
- Choosing between viable system design alternatives.
- Surfacing tradeoffs before implementation starts.
- Producing a concise Linear decision note with assumptions, consequences, and validation criteria.

## Avoid
- The user is asking for implementation details before the decision is framed.
- There is no real tradeoff or reversible architecture consequence.
- The output would create an ADR by default in a project that uses Linear for decisions.

## Inputs
- Decision statement or architecture problem.
- Candidate options and known constraints.
- Dominant drivers such as simplicity, security, performance, cost, operability, or speed.
- Existing Linear issue, spec, plan, or decision context when available.

## Outputs
- One-question-at-a-time interview path when the decision is still unclear.
- Recommended option with sacrifices, assumptions, risks, and validation criteria.
Read the full skill on GitHub

Details

Skill name
architecture-interview
Path
Skills/product-strategy/architecture-interview/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Architecture Interview skill do?

Analyze, review, and plan architecture alternatives through a structured interview. Use when the user needs tradeoffs surfaced before implementation or a Linear decision note instead of an ADR.

How do I install the Architecture Interview skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill architecture-interview. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Architecture Interview popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.