Architect Skill

Design high-complexity architecture with ADRs, DDD, and C4 diagrams.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/paulojoseph/next-generation-aec --skill architect-skill-paulojoseph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architect Skill
Source: https://github.com/paulojoseph/next-generation-aec/tree/main/.claude/skills/architect
Command: npx skills add https://github.com/paulojoseph/next-generation-aec --skill architect-skill-paulojoseph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Architect skill formalizes and documents architectural decisions for high‑complexity changes before detailed specifications, ensuring a disciplined, ADR‑driven design process that reduces risk and rework.

Core Features & Use Cases

  • Defines Architecture Decisions (ADRs) with alternatives and trade-offs to guide long‑term maintainability.
  • Maps bounded contexts, aggregates, entities, and value objects using DDD Tactical Co‑Located patterns.
  • Produces C4 diagrams and Arc42‑based documentation to communicate the system architecture to stakeholders.
  • Validates design against project specs and quality rules before proceeding to the Specification phase.

Quick Start

Trigger the Architect skill when proposal.md indicates Complexity: HIGH or Requires Design Phase: YES to produce a complete design doc.

Frequently Asked Questions about Architect Skill

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

FAQPage Schema
How do I document architecture decisions for high-complexity software changes?

Document architecture decisions by creating ADRs with alternatives and trade-offs, mapping bounded contexts using DDD tactical patterns, and generating C4 diagrams within an Arc42-based design.md to reduce risk and rework.

When do I need a formal architecture design phase before writing specifications?

You need a formal architecture design phase when proposal.md indicates Complexity: HIGH or Requires Design Phase: YES, signaling that changes affect multiple bounded contexts and require infrastructure decisions before detailing specifications.

How do I map bounded contexts and aggregates using DDD tactical design?

Map bounded contexts by applying DDD Tactical Co-Located patterns to define aggregates, entities, and value objects, ensuring a structured domain model that validates against project specs and quality rules before specification.

What is the best way to communicate system architecture to stakeholders before a design review?

Communicate system architecture to stakeholders by producing C4 diagrams and Arc42-based documentation that visualize the system structure, ensuring the design.md is ready for Gatekeeper review before proceeding to the Specification phase.

Does this architecture design process work for changes affecting multiple bounded contexts?

Yes, the architecture design process specifically targets high-complexity changes affecting multiple bounded contexts, requiring documented Architecture Decisions, DDD tactical design, and C4 diagrams to validate infrastructure decisions.

How do I validate my architecture design against project specs and quality rules?

Validate your architecture design by formalizing decisions in ADRs and structuring the design.md with DDD tactical design and C4 diagrams, ensuring it passes Gatekeeper review before moving to the Specification phase.