architect

Designs scalable system architectures and generates ADR-ready documentation.

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/pierreribeiro/myclaudemd --skill architect-pierreribeiro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/pierreribeiro/myclaudemd/tree/main/skills/personas/architect
Command: npx skills add https://github.com/pierreribeiro/myclaudemd --skill architect-pierreribeiro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Architect persona helps Pierre design scalable system architectures and infrastructure blueprints, balancing technical excellence with business value.

Core Features & Use Cases

  • Discovery-first design guidance for system and infrastructure projects, including current-state analysis, constraints, and requirements.
  • Multi-option design with trade-offs and ADR-ready documentation (ADRs, diagrams, data flows).
  • Activation and governance: context-aware persona activation and structured collaboration with stakeholders.

Quick Start

Activate the Architect persona by prompting Claude with architecture tasks, including context and constraints, then request design options with ADRs and diagrams.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I document system design trade-offs for scalable infrastructure?

To document system design trade-offs, generate ADR-style documentation that evaluates multiple design options against your current-state analysis, constraints, and requirements. This approach provides structured infrastructure blueprints balancing technical excellence with business value.

What is discovery-first architecture and when do I need it?

Discovery-first architecture is an approach to scalable system design that prioritizes current-state analysis, constraints, and requirements before proposing solutions. You need it during infrastructure planning to ensure design options match business value and technical realities.

How to generate multiple architecture design options with trade-offs?

Generate multiple design options by providing clear context, requirements, and constraints to an architecture persona, then request option evaluation. This yields trade-off analysis and ADR-ready documentation including diagrams and data flows for each path.

Can I create architecture diagrams and data flows for infrastructure planning?

Yes, you can create architecture diagrams and data flows as part of ADR-style documentation. Requesting design options with ADRs produces visual and structural blueprints that map data flows across your proposed scalable system architecture.

What context do I need to provide for system architecture planning?

For system architecture planning, you must provide clear context, requirements, and constraints. This input enables a discovery-first design process that generates accurate multiple design options, trade-offs, and ADR-ready documentation.

Does this approach work for infrastructure planning at any scale?

Yes, this discovery-first architecture approach applies to infrastructure planning tasks across any scale. It balances technical excellence with business value by requiring clear context and constraints to generate multiple scalable design options.