architect/architecture-design

Designs system architecture including pattern selection, layering, and directory structures.

553|50|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/echoVic/boss-skill --skill architect-architecture-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect/architecture-design
Source: https://github.com/echoVic/boss-skill/tree/main/skill/skills/architect/architecture-design
Command: npx skills add https://github.com/echoVic/boss-skill --skill architect-architecture-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After technical research is complete, teams often struggle to translate findings into a concrete system architecture. This Skill provides a structured methodology for choosing architecture patterns, designing system layers, and defining project directory structures so the architecture document is consistent and grounded in framework conventions.

Core Features & Use Cases

  • Architecture Pattern Selection: Decision trees and comparison tables for choosing between monolith, frontend-backend separation, microservices, and serverless based on project scale and team size.
  • System Layering & Diagrams: Templates for layered architecture and Mermaid-based system architecture diagrams covering clients, gateways, services, and data layers.
  • Directory Structure Templates: Ready-made project structures for Next.js App Router, Express + React, Python FastAPI, and Go, plus a tech stack overview table format.
  • Use Case: After completing technology research for a new web product, the architect agent uses this methodology to produce the architecture overview and directory structure chapters of the architecture document.

Quick Start

Ask the architect agent to design the system architecture for your project based on the completed technology research, including pattern selection, an architecture diagram, and a directory structure.

Frequently Asked Questions about architect/architecture-design

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

FAQPage Schema
How do I choose between monolith, microservices, and serverless architecture?

Choose based on project scale and team size: monoliths suit small projects with 1-3 people, frontend-backend separation fits medium projects with 3-10 people, and microservices fit large projects with 10+ people. Serverless works for event-driven workloads with fluctuating traffic regardless of team size.

What should a system architecture document include?

It should include the chosen architecture pattern with rationale, a Mermaid system architecture diagram, a tech stack overview table with versions, and a directory structure with explanations for each folder. These typically form the architecture overview and directory structure chapters.

What is the standard directory structure for a Next.js App Router project?

Use app/ for routes and API endpoints, components/ split into ui and features, lib/ for database, auth, and utilities, prisma/ for the ORM schema, public/ for static assets, and tests/ for test files. Follow framework conventions rather than inventing custom structures.

When should I avoid using a microservices architecture?

Avoid microservices for small projects or teams under 10 people, since they add operational complexity, deployment overhead, and distributed-systems costs. A monolith or frontend-backend separation is simpler to develop, deploy, and maintain at that scale.

What are common mistakes when designing project directory structures?

Common mistakes include inventing custom structures instead of following framework conventions, over-engineering small projects, mixing business logic with data access and UI code, and failing to plan where test files live.