Skip to content

VidyFoo/antigravity-skill-engine / .agent/skills/1-dev/architecting

architecting

Verified

Architects new features through the full lifecycle. Use when designing, planning, implementing, or extending features. Triggers on 'new feature', 'design', 'plan', 'implement', 'architect', 'prd', 'spec'.

resources/architecture-patterns.md

View on GitHub
# Architecture Patterns (Mermaid Templates)

Use these templates to visualize the system structure before coding.

## 1. Indie App Pattern (Monolith / Simple 3-Tier)

Direct connection from Frontend to Backend API, sharing types.

```mermaid
C4Context
    title Indie App Architecture (Speed & Simplicity)

    Person(user, "User", "Uses the app web/mobile")
    
    System_Boundary(b1, "The Application") {
        Container(spa, "Single Page App", "React/Vite", "MUI v7, TanStack Query")
        Container(api, "Backend API", "Node/Express", "Layered Arch, Prisma")
        ContainerDb(db, "Database", "PostgreSQL", "Main application data")
    }

    Rel(user, spa, "Uses", "HTTPS")
    Rel(spa, api, "API Calls", "JSON/REST", "Shared Zod Types")
    Rel(api, db, "Reads/Writes", "Prisma Client")

    UpdateLayoutConfig($c4ShapeInRow="3", $c4BoundaryInRow="1")
```

## 2. Enterprise App Pattern (Microservices / Modular)

Introduction of API Gateway, separate services, and strict boundaries.

```mermaid
C4Context
    title Enterprise App Architecture (Scale & Stability)

    Person(user, "User", "Composite UI usage")
    
    System_Boundary(frontend, "Frontend Layer") {
        Container(mfe1, "Dashboard MFE", "React/Vite", "Feature: Analytics")
        Container(mfe2, "Admin MFE", "React/Vite", "Feature: User Mgmt")
    }

    System_Boundary(gateway, "Gateway Layer") {
        Container(bff, "API Gateway / BFF", "Node.js", "Auth, Rate Limiting, Aggregation")
    }

    System_Boundary(services, "Backend Services") {
        Container(svc_auth, "Auth Service", "Express", "Identity Mgmt")
        Container(svc_core, "Core Features", "Express", "Business Logic")
        Container(svc_rpt, "Reporting Service", "Python/Go", "Heavy Compute")
    }

    ContainerDb(db_core, "Core DB", "PostgreSQL", "Transaction Data")
    ContainerDb(db_rpt, "Analytics DB", "ClickHouse", "OLAP Data")

    Rel(user, mfe1, "Uses")
    Rel(mfe1, bff, "API Calls")
    Rel(mfe2, bff, "API Calls")
    
    Rel(bff, svc_auth, "gRPC/REST")
    Rel(bff, svc_core, "gRPC/REST")
    Rel(bff, svc_rpt, "gRPC/REST")
    
    Rel(svc_core, db_core, "SQL")
    Rel(svc_rpt, db_rpt, "SQL")
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall