Architect

Generate architecture guidance for contract, schema, and runtime-impacting changes.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/anderson-joyle/claude-a-team --skill architect-anderson-joyle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architect
Source: https://github.com/anderson-joyle/claude-a-team/tree/main/skills/architect
Command: npx skills add https://github.com/anderson-joyle/claude-a-team --skill architect-anderson-joyle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Architect skill helps teams turn contract, schema, and runtime-impacting requests into clear design guidance so downstream engineers can implement changes safely without breaking existing behavior.

Core Features & Use Cases

  • Interface and boundary review: Defines what will change, where it will change, and which contracts are impacted, including cross-repo considerations.
  • Migration and operational impact planning: Identifies migration constraints, rollout risks, and operational considerations that must be addressed.
  • Tradeoff-driven recommendations without code: Proposes the smallest valid approach, states assumptions, and asks only blocking questions when information is missing.
  • Gate decision correctness: Ensures routing and gate_decision.required are set appropriately when policy or explicit request triggers an architectural review.

Quick Start

Ask the AI architect to review your API or schema change request and return a scoped design recommendation with migration and operational impact notes.

Frequently Asked Questions about Architect

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

FAQPage Schema
How do I plan a safe database schema migration across multiple repositories?

To plan a safe schema migration across multiple repositories, you need architecture guidance that defines contract impacts, identifies operational risks, and outlines rollout constraints before implementation begins. This ensures downstream engineers apply changes without breaking runtime behavior.

When do I need an architecture review for API contract changes?

An architecture review for API contract changes is required when a request crosses repository boundaries, introduces new interface constraints, or carries operational risk that necessitates design tradeoffs and migration planning prior to writing code.

What is the best way to document design tradeoffs for operational risk?

Documenting design tradeoffs for operational risk involves proposing the smallest valid approach, explicitly stating assumptions, and flagging only blocking questions when information is missing, which provides clear migration and operational impact notes for engineers.

How do I review cross-repo design impacts for new interface constraints?

Reviewing cross-repo design impacts involves analyzing where interface boundaries will change, which existing contracts are affected, and generating a scoped design recommendation with migration paths to prevent breaking established behavior.

Does the architecture guidance include code implementation for schema changes?

Architecture guidance for schema changes does not include code implementation, but instead provides tradeoff-driven recommendations, scoped design approaches, and operational impact notes to safely direct downstream engineering efforts.