software-architect

Produces ADRs and design patterns to guide architectural decisions.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/cffrank/paperclip-skills-agents --skill software-architect-cffrank
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-architect
Source: https://github.com/cffrank/paperclip-skills-agents/tree/main/skills/software-architect
Command: npx skills add https://github.com/cffrank/paperclip-skills-agents --skill software-architect-cffrank

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams make architecture decisions by producing structured ADRs, documenting trade-offs, and aligning on patterns before implementation.

Core Features & Use Cases

  • ADR Template and decision logging to capture context, options, and consequences.
  • Architecture Pattern Selection Matrix to choose between modular monolith, microservices, or event-driven patterns.
  • Domain-Driven Design guidance with bounded contexts, aggregates, and event modeling.
  • Architecture review checklists and best practices to ensure durable, scalable designs.

Quick Start

Draft an ADR for a new service and outline its bounded contexts.

Frequently Asked Questions about software-architect

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

FAQPage Schema
How do I write an architecture decision record for a new service?

To write an architecture decision record (ADR), capture the context, evaluate available options, and document the trade-offs and consequences. Using a structured ADR template ensures your team aligns on the rationale before implementation begins.

What is the best way to choose between a modular monolith and microservices?

Choosing between a modular monolith and microservices requires an architecture pattern selection matrix. This matrix evaluates your system design needs against trade-offs like deployment complexity and domain decomposition to determine the most durable and scalable pattern.

How does domain-driven design help with system architecture decomposition?

Domain-driven design helps system architecture decomposition by defining bounded contexts and aggregates. This event modeling approach breaks complex domains into manageable components, ensuring durable designs and clear boundaries for cloud-native and edge-first applications.

Can I use architecture review checklists for cloud-native and edge-first applications?

Yes, you can apply architecture review checklists to cloud-native and edge-first applications. These checklists provide best practices and decision records to evaluate system design, ensuring your architecture captures necessary context and maintains scalable, durable structures.

When should I document architecture trade-offs during technology selection?

You should document architecture trade-offs during technology selection whenever evaluating competing frameworks or patterns. Capturing these trade-offs in decision records provides clear rationale for future reviews and aligns engineering teams on the chosen system design approach.