skills.rest
shakhovskiya-create
shakhovskiya-createCOMMUNITY
Explore all skills by this author →
GitHub

architecture

Generate C4 architecture designs and ADRs from an approved PRD.

Updated May 5, 2026
Search Tags:#design#architecture#documentation#adr#c4#architecture-design#systems
One-click install
npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill architecture-shakhovskiya-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/shakhovskiya-create/shakhoff-claude-marketplace/tree/main/plugins/solo-sdlc/skills/architecture
Command: npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill architecture-shakhovskiya-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design and plan scalable system architectures by translating an approved PRD into a detailed architecture design with ADRs and a C4-consistent layout.

Core Features & Use Cases

  • C4-level Architecture Design: produce context, containers, and components diagrams aligned to the PRD.
  • ADR Generation: capture architecture decisions with rationale in docs/architecture/adr.
  • Open Design Documentation: generate docs/architecture/<feature>/design.md with deployment, security, and performance notes.
  • Open Questions & Change Management: surface unresolved trade-offs for decision gating.

Quick Start

Trigger this skill after PRD approval and provide the feature scope to generate a complete architecture design draft with ADRs and a design.md.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate system architecture design from a PRD?▼

Generate architecture design from a PRD by translating the approved document into a structured design.md file featuring C4 diagrams, component contracts, and ADRs to guide implementation.

What is the best way to document architecture decisions and rationale?▼

Document architecture decisions by generating Architecture Decision Records, or ADRs, which capture specific trade-offs and rationale in a dedicated docs directory for future reference.

How do I create C4 diagrams for systems design?▼

Create C4 diagrams for systems design by mapping the approved PRD scope into context, containers, and components views to visualize deployment topology and data contracts.

Can I use this approach for deployment topology and security planning?▼

Yes, this approach handles deployment topology and security planning by generating dedicated sections for security, performance, and deployment considerations within the architecture design document.

When do I need to generate an architecture design document?▼

You need to generate an architecture design document after PRD approval to establish a structured layout covering API contracts, deployment topology, and unresolved trade-offs before implementation begins.

How to surface unresolved trade-offs during architecture design?▼

Surface unresolved trade-offs during architecture design by capturing open questions for decision gating, ensuring all architectural decisions and limitations are documented before implementation.

Related Skills

Explore More Software Engineering Skills→
az9713az9713

prompting-pattern-library

Provide prompting patterns, failure modes, and model-specific guidance for LLM workflows.

Community
Basic
I2olanDI2olanD

architecture-design

Generate and validate Solution Design Documents against PRD requirements.

Community
Advanced
matt-fell-aimatt-fell-ai
1

spatial

Translate visual sketches and diagrams into database schemas and project scaffolds.

Community
Advanced
adolfoaranaes12adolfoaranaes12
2

nfr-architecture-mapping

Generate system architecture documents with ADRs from requirements.

Community
Advanced