Pillar Specification & Hub Directory

ARCHITECTURE.md System Spec Generator

Teach AI agents your system architecture, unidirectional data flows, and non-negotiable boundaries.

Open Blank Studio Editor

Target: ./ (Repository Root)ARCHITECTURE.md

01 / SPECIFICATION & RUNTIME BEHAVIOR

How ARCHITECTURE.md Specification Operates in Production

AI coding agents frequently propose solutions that work in isolation but violate broader architectural patterns. ARCHITECTURE.md establishes high-level invariants: state management boundaries, data mutation rules, service contracts, and forbidden anti-patterns that every AI agent must obey before proposing code changes.

State Flow & Boundary DirectivesSpec Syntax

Defines unidirectional data flows and schema validation gates.

## Data Flow & State Management
1. Unidirectional flow: state flows top-down.
2. Boundary validation: all inputs validated with Zod.
3. Surgical edits: preserve surrounding code.

02 / REPOSITORY PLACEMENT

./ARCHITECTURE.mdRepository Root

Authoritative architectural blueprint read by AI pair programmers and human engineers alike.

03 / PRESET SPOKE MATRIX

Available Tech Stack Presets (27)

Click any tech stack below to open the client-side editor preloaded with this verified configuration.

Next.js 15 App Router

Generate an AI-optimized ARCHITECTURE.md invariant specification for Next.js 15 App Router.

Enforced Invariant:

"Enforce React Server Components (RSC) by default; restrict 'use client' strictly to interactive leaf components."

React 19 & Vite

Generate an AI-optimized ARCHITECTURE.md invariant specification for React 19 & Vite.

Enforced Invariant:

"Use React 19 action hooks (useActionState, useOptimistic, useFormStatus) for async mutations."

Python FastAPI & Pydantic v2

Generate an AI-optimized ARCHITECTURE.md invariant specification for Python FastAPI & Pydantic v2.

Enforced Invariant:

"Use strict Pydantic v2 BaseModels with Field validation for all input and output schemas."

Fullstack & DBLaunch

Supabase & PostgreSQL

Generate an AI-optimized ARCHITECTURE.md invariant specification for Supabase & PostgreSQL.

Enforced Invariant:

"Always include `ENABLE ROW LEVEL SECURITY;` on every created table."

Fullstack & DBLaunch

Prisma ORM

Generate an AI-optimized ARCHITECTURE.md invariant specification for Prisma ORM.

Enforced Invariant:

"Always use `select` to specify required fields; avoid raw `findMany()` fetching unused relations."

Fullstack & DBLaunch

Drizzle ORM

Generate an AI-optimized ARCHITECTURE.md invariant specification for Drizzle ORM.

Enforced Invariant:

"Define schemas using pgTable/sqliteTable with explicit foreign keys and constraints."

Go (Golang) & Fiber

Generate an AI-optimized ARCHITECTURE.md invariant specification for Go (Golang) & Fiber.

Enforced Invariant:

"Check every `if err != nil` explicitly; never swallow errors or ignore returned values."

Rust & Axum

Generate an AI-optimized ARCHITECTURE.md invariant specification for Rust & Axum.

Enforced Invariant:

"Never call `.unwrap()` or `.expect()` in production route handlers; propagate errors via `Result<T, AppError>`."

Tailwind CSS v4

Generate an AI-optimized ARCHITECTURE.md invariant specification for Tailwind CSS v4.

Enforced Invariant:

"Configure themes directly in globals.css using `@theme` and `@import 'tailwindcss';`."

Vue 3 & Nuxt 3

Generate an AI-optimized ARCHITECTURE.md invariant specification for Vue 3 & Nuxt 3.

Enforced Invariant:

"Always use `<script setup lang='ts'>` and the Composition API; ban legacy Options API."

SvelteKit 5 & Svelte 5

Generate an AI-optimized ARCHITECTURE.md invariant specification for SvelteKit 5 & Svelte 5.

Enforced Invariant:

"Use Svelte 5 runes: `$state()`, `$derived()`, and `$props()`."

Specialist PersonaLaunch

Universal Cursor Pro

Generate an AI-optimized ARCHITECTURE.md invariant specification for Universal Cursor Pro.

Enforced Invariant:

"Deliver surgical, targeted diffs; never replace entire files unnecessarily."

Specialist PersonaLaunch

Pragmatic Rapid Prototyping

Generate an AI-optimized ARCHITECTURE.md invariant specification for Pragmatic Rapid Prototyping.

Enforced Invariant:

"Prioritize working software over complex design patterns or deep inheritance hierarchies."

Specialist PersonaLaunch

Zero-Trust Security

Generate an AI-optimized ARCHITECTURE.md invariant specification for Zero-Trust Security.

Enforced Invariant:

"Flag and prevent any dynamic SQL query string interpolation."

DevOps & ToolingLaunch

Docker & CI/CD

Generate an AI-optimized ARCHITECTURE.md invariant specification for Docker & CI/CD.

Enforced Invariant:

"Always use multi-stage Docker builds to separate builder tools from the lean production image."

Specialist PersonaLaunch

Vitest & Playwright TDD

Generate an AI-optimized ARCHITECTURE.md invariant specification for Vitest & Playwright TDD.

Enforced Invariant:

"Write unit tests covering happy paths and at least two edge/error cases for every new function."

Specialist PersonaLaunch

Automated Code Reviewer

Generate an AI-optimized ARCHITECTURE.md invariant specification for Automated Code Reviewer.

Enforced Invariant:

"Scan repository manifests to map stack idioms before evaluating logic."

Specialist PersonaLaunch

Multi-Agent System Orchestration

Generate an AI-optimized ARCHITECTURE.md invariant specification for Multi-Agent System Orchestration.

Enforced Invariant:

"Define subagent roles: Lead Architect, Frontend Engineer, Backend Specialist, Security Reviewer."

Django 5 & Ninja / DRF

Generate an AI-optimized ARCHITECTURE.md invariant specification for Django 5 & Ninja / DRF.

Enforced Invariant:

"Use asynchronous ORM operations (aget(), acreate(), afirst()) inside async def view handlers."

Bun & Elysia / Hono

Generate an AI-optimized ARCHITECTURE.md invariant specification for Bun & Elysia / Hono.

Enforced Invariant:

"Use Elysia's native t schema builder (powered by TypeBox) for request body, query, and parameter validation."

React Native & Expo Router

Generate an AI-optimized ARCHITECTURE.md invariant specification for React Native & Expo Router.

Enforced Invariant:

"Use Expo Router file-based filesystem routing (app/_layout.tsx, app/(tabs)/index.tsx); ban legacy React Navigation container boilerplate."

Flutter 3 & Riverpod / Dart

Generate an AI-optimized ARCHITECTURE.md invariant specification for Flutter 3 & Riverpod / Dart.

Enforced Invariant:

"Always add const constructors wherever possible to maximize Flutter element rebuild caching."

DevOps & ToolingLaunch

Kubernetes & Helm Charts

Generate an AI-optimized ARCHITECTURE.md invariant specification for Kubernetes & Helm Charts.

Enforced Invariant:

"Always specify explicit resources.requests and resources.limits (both CPU and memory) on every container."

DevOps & ToolingLaunch

Terraform & OpenTofu IaC

Generate an AI-optimized ARCHITECTURE.md invariant specification for Terraform & OpenTofu IaC.

Enforced Invariant:

"Pin explicit version constraints for all providers and required Terraform/OpenTofu core versions (required_providers)."

DevOps & ToolingLaunch

Playwright End-to-End Testing

Generate an AI-optimized ARCHITECTURE.md invariant specification for Playwright End-to-End Testing.

Enforced Invariant:

"Strictly ban hardcoded delays (page.waitForTimeout()); rely exclusively on Playwright web-first auto-waiting assertions (expect(locator).toBeVisible())."

Spring Boot 3 & Java 21

Generate an AI-optimized ARCHITECTURE.md invariant specification for Spring Boot 3 & Java 21.

Enforced Invariant:

"Use jakarta.* packages for persistence, validation, and servlets; ban legacy javax.* imports."

.NET 8 & C# 12 Minimal APIs

Generate an AI-optimized ARCHITECTURE.md invariant specification for .NET 8 & C# 12 Minimal APIs.

Enforced Invariant:

"Use modern C# 12 features: primary constructors, collection expressions, file-scoped namespaces, and nullable reference types (#nullable enable)."

04 / BEST PRACTICES

Document architectural invariants rather than fleeting implementation details.

Explicitly list anti-patterns that AI models commonly attempt to introduce.

Keep the document updated during major architectural refactors.

Other Format DirectoriesHub Network

Cursor Rules/cursor-rules

Claude Skill/claude-skills

CLAUDE.md/claude-md

AGENTS.md/agents-md

MCP Config/mcp-config

Windsurf/windsurf-rules

Copilot/copilot-instructions

OpenAI/openai-instructions

Gemini/gemini-prompts

.cursorignore/cursorignore

.claudeignore/claudeignore

llms.txt/llms-txt

05 / FREQUENTLY ASKED QUESTIONS

How is ARCHITECTURE.md different from CLAUDE.md or .cursorrules?

CLAUDE.md and .cursorrules contain editor-specific triggers and commands. ARCHITECTURE.md provides deep architectural principles, data flows, and invariant contracts that apply across all tools.