software-architect

Validates technology stacks and produces architecture decision records before feature development begins.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often start coding significant features without validating whether the chosen stack, patterns, and infrastructure will scale, leading to costly rewrites, security gaps, and undocumented decisions. This Skill performs a structured architecture review before development starts and records every significant decision as an ADR. ## Core Features & Use Cases - Architecture Validation: Reviews the existing tech stack, database schema, and API design against project requirements, identifying scalability bottlenecks, security gaps, and tech debt risks. - Architecture Decision Records (ADRs): Documents every significant decision with context, alternatives, trade-offs, and status, stored in a docs/adr/ directory. - Security & Scalability Planning: Defines authentication flows (JWT, RBAC), caching and queue strategies, threat models (STRIDE), and scaling plans for expected load. - Use Case: Before building a new multi-tenant SaaS module, activate this Skill to validate the PostgreSQL schema, compare Prisma vs Drizzle with explicit trade-offs, and produce ADRs plus a C4 system diagram for the engineering team. ## Quick Start Review the architecture for my new billing module and write ADRs for the stack and database decisions before I start coding.

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 (ADR)?▼

An ADR documents the context requiring a decision, the decision itself, alternatives considered with pros and cons, and consequences including risks. Store each ADR as a markdown file in a docs/adr/ directory with a status of Proposed, Accepted, Deprecated, or Superseded.

When should I do an architecture review before coding?▼

Run an architecture review before any significant new feature, module, or project. It validates the tech stack against requirements, identifies scalability bottlenecks and security gaps early, and produces decision records that guide the engineering team.

Prisma vs TypeORM vs Drizzle — which ORM should I choose?▼

Compare ORMs with explicit trade-off analysis covering TypeScript support, maintenance activity, migration tooling, and licensing. The Skill evaluates each option against your project's query patterns and records the final choice in an ADR.

How do I design authentication with JWT and RBAC?▼

Define the authentication flow using JWT with refresh tokens and session management, then model authorization with RBAC roles and resource-level permissions. Validate the design against OWASP Top 10 risks and document it in the security architecture.

What are the limitations of a pre-coding architecture review?▼

An architecture review validates decisions on paper but cannot catch runtime issues like actual query performance or integration failures. It should be revisited as the system evolves, with ADRs updated when decisions are superseded.