architecture

Generate standardized Architecture Decision Records and compare technology stacks.

4|2|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/saitarrun/devforge-ai --skill architecture-saitarrun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/saitarrun/devforge-ai/tree/main/skills/architecture
Command: npx skills add https://github.com/saitarrun/devforge-ai --skill architecture-saitarrun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the risk of undocumented, inconsistent architectural choices that lead to technical debt, team misalignment, and costly rework when systems need to scale or adapt to new requirements.

Core Features & Use Cases

  • Standardized ADR Creation: Generate consistent Architecture Decision Records that capture context, trade-offs, and consequences to ensure team alignment and preserve institutional knowledge.
  • Tech Stack Evaluation: Compare multiple technology options against objective criteria like performance, scalability, learning curve, and team expertise to make defensible, data-driven choices.
  • Architecture Compliance Checks: Implement fitness functions to automatically enforce rules around coupling, cohesion, and dependency structure, preventing architectural drift over time.
  • Use Case: When building a new customer-facing platform, use this skill to document why you chose a microservices architecture over a monolith, validate that services maintain low coupling, and ensure all API endpoints have documented schemas.

Quick Start

Use the architecture skill to create an ADR documenting the decision to use PostgreSQL as the primary database for your new inventory management system.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I create an Architecture Decision Record to document tech stack choices?

To create an Architecture Decision Record, use standardized templates that capture context, trade-offs, and consequences. This ensures team alignment and preserves institutional knowledge when evaluating technology options against objective criteria like performance and scalability.

What are fitness functions in system design and how do they prevent architectural drift?

Fitness functions are automated checks that enforce architectural rules around coupling, cohesion, and dependency structure. They prevent architectural drift by continuously validating that your system design maintains consistent standards as it scales and evolves over time.

How do I evaluate a microservices architecture for service granularity and coupling?

To evaluate a microservices architecture, apply coupling and cohesion guidelines to validate service granularity. Use comparison frameworks to assess whether services maintain low coupling and documented schemas, ensuring defensible, data-driven architectural decisions.

Can I use this skill for technology stack selection in a new software engineering project?

Yes, you can use this skill for technology stack selection in software engineering projects of all sizes. It provides objective criteria to compare multiple technology options, ensuring defensible choices that prevent technical debt and cross-team misalignment.

What is the best way to document why we chose a microservices architecture over a monolith?

The best way to document architectural choices is generating standardized Architecture Decision Records. These records capture the context and consequences of choosing microservices over a monolith, preventing undocumented decisions that cause technical debt.

When should I implement architecture compliance checks for my tech stack?

You should implement architecture compliance checks when building new platforms or scaling systems. Automated fitness functions enforce dependency structure rules and validate that services maintain low coupling, preventing architectural drift and costly rework.