Public betaPlug into your AI. Get superpowers.Get access
┌ pillar /architecture43 rules · 37 skills
Pillar · architecture

Architecture.

Provider-first stacks, package boundaries, scale paths. Below: every rule the AI cites and every skill that fires inside this pillar — versioned, dated, cross-referenced.

01/05auto-trigger

Path-scoped. Loaded only when relevant.

Open a matching file → the right rules attach. Zero token cost the rest of the time.

Dependencies Quality Gate
Git Conventions
Library Catalog
Package Architecture
Stack Recommendations
C++ Backend
02/05how it works

What this pillar does for you.

01
Provider-first stack defaults

React, Ionic, RN, Express - opinionated defaults so the AI does not pick a random framework on Tuesday.

02
Curated library catalog

No random npm picks. Every dependency justified, audited, version-pinned.

03
Read/write paths separated

Handlers thin, services thick, queries explicit. The architecture survives 10x scale without rewrites.

03/05rules in this pillar

43 rules.

Each rule is a markdown file the AI loads when it edits a matching path. Click any to see related skills and where it's referenced.

ArchitectureruleDependencies Quality Gaterules/common/dependencies.md

Search local before adding a dep, check stack defaults, run the quality gate (maintained, adopted, permissive license, typed, sized). Build in packages/* only when no candidate passes.

ArchitectureruleGit Conventionsrules/common/git.md

Conventional commits, one logical change per commit, PR titles under 70 chars with test-plan body, no force-push to protected branches, no --no-verify.

ArchitectureruleLibrary Catalogrules/common/library-catalog.md

Curated starting points (zod, react-hook-form, RTK Query, framer-motion, Sentry, PostHog, Resend, Shifter) per stack so the AI does not pick a random package.

ArchitecturerulePackage Architecturerules/common/package-architecture.md

Every workspace package ships an up-to-date architecture.md describing purpose, public API, dependencies, and why-not-a-library tradeoffs.

ArchitectureruleStack Recommendationsrules/common/stack-recommendations.md

Provider-first defaults: GitHub Actions, Stripe, Sentry, Resend, Supabase, PostgreSQL, pnpm. Custom infra only after stack core, provider feature, and quality gate fail.

ArchitectureruleC++ Backendrules/backend/cpp.md

Modern C++17/20/23, RAII everywhere, repository interfaces, std::optional/expected for failures, clang-tidy + sanitizers in CI, GoogleTest for unit tests.

ArchitectureruleC#/.NET Backendrules/backend/csharp.md

Nullable references on, records for DTOs, constructor DI with explicit lifetimes, typed Options, parameterized queries, framework auth handlers over custom JWT.

ArchitectureruleGo Backendrules/backend/golang.md

gofmt + goimports, small consumer-defined interfaces, context.Context through request work, gosec in CI, parameterized SQL, race detector for concurrent code.

ArchitectureruleJava Backendrules/backend/java.md

google-java-format, records for DTOs, constructor injection, Optional only as return type, parameterized SQL, bcrypt/Argon2 for passwords, JUnit 5 baseline.

ArchitectureruleKotlin/JVM Backendrules/backend/kotlin.md

ktlint/Detekt, val over var, sealed types for state, no !!, structured concurrency, Result<T> for recoverable failures, kotlinx-coroutines-test for coroutine code.

ArchitectureruleNode Service Layoutrules/backend/node.md

Route to controller to service to repository to db - never skip layers. zod-validate every handler, typed DTOs only, rate-limit public endpoints, scrubbed metrics.

ArchitecturerulePerl Backendrules/backend/perl.md

v5.36 strictness, subroutine signatures, Moo with Types::Standard, taint mode for web-facing scripts, DBI placeholders always, Test2::V0 for new tests.

ArchitecturerulePHP Backendrules/backend/php.md

PSR-12, declare(strict_types=1), DTOs/value objects over array shapes, framework form-request validation, prepared statements, password_hash, framework auth packages.

ArchitecturerulePython Backendrules/backend/python.md

PEP 8, type annotations on every signature, Protocol for service boundaries, context managers for I/O, Bandit in CI, parameterized queries, framework auth over hand-rolled JWT.

ArchitectureruleRust Backendrules/backend/rust.md

cargo fmt + clippy -D warnings, no unwrap in prod, thiserror for libs and anyhow for apps, newtype wrappers for IDs, SAFETY comments on unsafe, cargo audit + deny in CI.

ArchitectureruleFrontend Real-timerules/frontend/realtime.md

Three-layer transport/protocol/bridge, singleton per endpoint, heartbeat 15-30s, exponential backoff + jitter, requestAnimationFrame batching for high-rate streams.

ArchitectureruleFrontend Service Layerrules/frontend/services.md

REST vs real-time split, plain async services with explicit return types, shared axios client in packages/api-client, AppError contract, zod-validated boundaries.

ArchitectureruleReact Componentsrules/frontend/react/components.md

One component per file, named exports only, ComponentNameProps interface, shadcn primitives + Tailwind classes, i18n via translation keys, explicit loading/error/empty.

ArchitectureruleReact Stack Corerules/frontend/react/core.md

Forced stack: React 18, Vite, react-router v6, Redux Toolkit + RTK Query, zustand for UI state, react-hook-form + zod, Tailwind 3.4 + shadcn/ui, i18next.

ArchitectureruleReact Design Qualityrules/frontend/react/design-quality.md

Product-specific UI, never generic templates. Choose style direction up front, finish hover/focus/active/loading/empty states intentionally, preserve product logic during polish.

ArchitectureruleReact Real-timerules/frontend/react/realtime.md

Subscription hooks own the connection, components never call new WebSocket(). Redux bridge dispatches actions on frames; selectors expose derived state.

ArchitectureruleReact Services (RTK Query)rules/frontend/react/services.md

RTK Query for cache-friendly reads, plain axios for one-offs. Generated hooks only in components. zod-parse in transformResponse, precise providesTags/invalidatesTags.

ArchitectureruleReact State Managementrules/frontend/react/stores.md

Server data lives in exactly one place (RTK Query or slice). Redux Toolkit for cross-feature state, zustand for ephemeral UI, react-hook-form for forms - never mix.

ArchitectureruleSupabase Client Patternrules/frontend/react/supabase-client.md

Lazy getSupabase() never module-top createClient. Render a setup banner linking to traffic.io when env is missing - never crash on first pnpm dev.

ArchitectureruleReact Vite Configrules/frontend/react/vite.md

@vitejs/plugin-react-swc default, vite-tsconfig-paths, public VITE_ prefix only, source maps to Sentry release only, vite-plugin-checker or CI typecheck script.

ArchitectureruleIonic Capacitor Packagingrules/frontend/ionic/capacitor.md

Stable reverse-DNS app id, webDir to Vite dist, cap sync after dep/plugin changes, plugin calls wrapped in services with zod-validated results, just-in-time permissions.

ArchitectureruleIonic Componentsrules/frontend/ionic/components.md

shadcn primitives compose inside IonContent via the theme bridge. Use Ionic primitives only for shell concerns (IonPage, IonToolbar, IonTabs) where the OS feel matters.

ArchitectureruleIonic Stack Corerules/frontend/ionic/core.md

Capacitor shell around the React app by default; full @ionic/react only for mobile-first rewrites. Theme bridge maps shadcn HSL to --ion-color-* tokens.

ArchitectureruleIonic Navigationrules/frontend/ionic/navigation.md

react-router-dom v6 stays the source routing model for Capacitor-wrapped apps. zod-validate deep-link params. Android back maps to route pop, not app exit.

ArchitectureruleIonic Real-timerules/frontend/ionic/realtime.md

Service singleton owns WebSocket lifecycle across pause/resume/foreground/background. Resync stale channels on resume, expose idle/connecting/live/reconnecting/offline states.

ArchitectureruleIonic Service Layerrules/frontend/ionic/services.md

Wrap every Capacitor plugin in a domain service or hook with explicit return types. Components never import plugins directly. Network-aware services expose offline/retry states.

ArchitectureruleIonic State Managementrules/frontend/ionic/stores.md

Server data in RTK Query/Redux, ephemeral mobile shell state in zustand (active sheet, permission explainer dismissal). Native capability state normalized before it enters state.

ArchitectureruleIonic Styling Bridgerules/frontend/ionic/styles.md

Tailwind 3.4 with corePlugins.preflight: false, src/styles/ionic-theme-bridge.css maps shadcn HSL CSS vars onto --ion-color-* so Ionic primitives match the shadcn theme.

ArchitectureruleReact Native Componentsrules/frontend/react-native/components.md

RNR primitives + native View/Text/Pressable, NativeWind classes, one component per file under 150 lines, every visible string from a translation key, explicit loading/error/empty.

ArchitectureruleReact Native Stack Corerules/frontend/react-native/core.md

Forced stack: Expo SDK with Hermes + New Arch, Expo Router typed routes, Redux Toolkit + RTK Query, zustand for ephemeral, NativeWind v4 + RNR, react-native-reanimated.

ArchitectureruleReact Native Navigationrules/frontend/react-native/navigation.md

Expo Router required, route files thin and compose named feature components, typed routes + absolute hrefs, params validated with zod, deep links parsed at route boundary.

ArchitectureruleReact Native Real-timerules/frontend/react-native/realtime.md

Singleton WS connection per endpoint, exponential backoff + jitter reconnect, pause non-critical streams on background, requestAnimationFrame batching for high-rate frames.

ArchitectureruleReact Native Servicesrules/frontend/react-native/services.md

RTK Query for cached server data, axios services for one-offs, secure-store tokens read in shared api-client only, retry refresh once on 401, file uploads via Expo file APIs.

ArchitectureruleReact Native State Managementrules/frontend/react-native/stores.md

Server data lives in exactly one place (RTK Query or Redux slice). One slice per domain, createSelector for derivations, RTK Query api -> WS bridge -> defaults middleware order.

ArchitectureruleReact Native Stylingrules/frontend/react-native/styles.md

NativeWind v4 + RNR primitives + rn-primitives, HSL theme tokens in global.css, dark via the dark: variant, no inline StyleSheet objects for styled-via-NativeWind components.

ArchitectureruleMode: Existing Codebaserules/modes/existing-codebase.md

Preserve existing structure. No renames, no moves, new code only. Project-memory + auto-doc + SEO baseline reconciliation before feature work.

ArchitectureruleMode: New Projectrules/modes/new-project.md

Clean-slate monorepo scaffold before feature code. Supabase default for backend-needing projects, packages/i18n provider before UI, SEO metadata before route done.

ArchitectureruleMode: Supabase Migrationrules/modes/supabase-migration.md

Existing-codebase rules plus one-time migration offer to the Traffic-One compatible Supabase fork. Preserve Supabase Auth/Storage/Realtime/RLS defaults.

04/05skills in this pillar

37 skills.

Skills are intent-triggered workflows. The AI router loads them by description; bodies on demand.

ArchitectureskillAndroid Clean Architectureskills/android-clean-architecture

Module structure, dependency rules, UseCases, Repositories, and data-layer patterns for Android and Kotlin Multiplatform projects.

ArchitectureskillAPI Connector Builderskills/api-connector-builder

Build a new API connector by matching the target repo's existing integration pattern exactly - one more integration, not a second architecture.

ArchitectureskillAPI Designskills/api-design

REST patterns covering resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.

ArchitectureskillBackend Patternsskills/backend-patterns

Backend architecture, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.

ArchitectureskillBun Runtimeskills/bun-runtime

When to choose Bun vs Node as runtime, package manager, bundler, and test runner; migration notes and Vercel support.

ArchitectureskillCompose Multiplatform Patternsskills/compose-multiplatform-patterns

State management, navigation, theming, performance, and platform-specific UI patterns for Compose Multiplatform and Jetpack Compose in KMP projects.

ArchitectureskillDart & Flutter Patternsskills/dart-flutter-patterns

Production-ready Flutter patterns: null safety, immutable state, async composition, widget architecture, BLoC/Riverpod/Provider, GoRouter, Dio, Freezed, clean architecture.

ArchitectureskillDashboard Builderskills/dashboard-builder

Build monitoring dashboards that answer real operator questions for Grafana, SigNoz, and similar platforms - turn metrics into working dashboards, not vanity boards.

ArchitectureskillDetect Projectskills/detect-project

Detects project mode (new vs existing vs existing-with-supabase) at session start and routes the next step (stack-setup, onboarding, or feature work).

ArchitectureskillDjango Patternsskills/django-patterns

Django architecture, DRF API design, ORM best practices, caching, signals, middleware, and production-grade Django patterns.

Architectureskill.NET Patternsskills/dotnet-patterns

Idiomatic C#/.NET patterns, conventions, dependency injection, async/await, and best practices for robust .NET applications.

ArchitectureskillFrontend Patternsskills/frontend-patterns

Frontend patterns for React, Next.js, state management, performance optimization, and UI best practices.

ArchitectureskillGit Commitskills/git-commit

Craft clean conventional-commit messages and PR descriptions: one-concern commits, test-plan PR bodies, full-history analysis per rules/common/git.md.

ArchitectureskillGo Patternsskills/golang-patterns

Idiomatic Go patterns, best practices, and conventions for robust, efficient, maintainable Go applications.

ArchitectureskillHexagonal Architectureskills/hexagonal-architecture

Ports & Adapters with clear domain boundaries, dependency inversion, and testable use-case orchestration across TypeScript, Java, Kotlin, and Go services.

ArchitectureskillIonic Mobileskills/ionic-mobile

Default to Capacitor wrapping an existing React app for mobile asks; offer full Ionic React only when the user wants a mobile-first rewrite.

ArchitectureskillJPA Patternsskills/jpa-patterns

JPA/Hibernate patterns for entity design, relationships, query optimization, transactions, auditing, indexing, pagination, and pooling in Spring Boot.

ArchitectureskillKotlin Coroutines & Flowsskills/kotlin-coroutines-flows

Coroutines and Flow patterns for Android/KMP: structured concurrency, Flow operators, StateFlow, error handling, and testing with runTest.

ArchitectureskillKotlin Exposed Patternsskills/kotlin-exposed-patterns

JetBrains Exposed patterns: DSL queries, DAO pattern, transactions, HikariCP pooling, Flyway migrations, repository pattern.

ArchitectureskillKotlin Ktor Patternsskills/kotlin-ktor-patterns

Ktor server patterns: routing DSL, plugins, authentication, Koin DI, kotlinx.serialization, WebSockets, and testApplication-based testing.

ArchitectureskillKotlin Patternsskills/kotlin-patterns

Idiomatic Kotlin patterns, conventions, coroutines, null safety, and DSL builders for robust, maintainable applications.

ArchitectureskillLaravel Patternsskills/laravel-patterns

Laravel architecture: routing/controllers, Eloquent ORM, service layers, queues, events, caching, and API resources for production.

ArchitectureskillLibrary Pickskills/library-pick

Walk the quality gate from rules/common/dependencies.md against a specific candidate (or 2-3 candidates) and decide install vs build-in-packages/<name>.

ArchitectureskillMCP Server Patternsskills/mcp-server-patterns

Build MCP servers with the Node/TypeScript SDK - tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Consults Context7 or official MCP docs.

ArchitectureskillNestJS Patternsskills/nestjs-patterns

NestJS architecture: modules, controllers, providers, DTO validation, guards, interceptors, config, and production-grade TypeScript backends.

ArchitectureskillNext.js Turbopackskills/nextjs-turbopack

Next.js 16+ and Turbopack plus provider-first recommendations for App Router projects: auth, data, cache, storage, deployment, testing, blogs and SaaS apps.

ArchitectureskillNuxt 4 Patternsskills/nuxt4-patterns

Nuxt 4 patterns for hydration safety, performance, route rules, lazy loading, and SSR-safe data fetching with useFetch and useAsyncData.

ArchitectureskillPerl Patternsskills/perl-patterns

Modern Perl 5.36+ idioms, best practices, and conventions for robust, maintainable Perl applications.

ArchitectureskillPython Patternsskills/python-patterns

Pythonic idioms, PEP 8 standards, type hints, and best practices for robust, maintainable Python applications.

ArchitectureskillRust Patternsskills/rust-patterns

Idiomatic Rust patterns, ownership, error handling, traits, concurrency, and best practices for safe, performant applications.

ArchitectureskillSpring Boot Patternsskills/springboot-patterns

Spring Boot architecture: REST API design, layered services, data access, caching, async processing, and logging for Java backends.

ArchitectureskillStack Setupskills/stack-setup

Drive Traffic One onboarding when no stack is detected: pitch the stack, ask the blocking onboarding questions, and write .traffic-one.json based on the first message.

ArchitectureskillSupabase Setupskills/supabase-setup

Walk a beginner through connecting a real Supabase backend and applying local migrations - cloud-first by default, fully-automatic local via pnpm db:start.

ArchitectureskillSwift Actor Persistenceskills/swift-actor-persistence

Thread-safe data persistence in Swift using actors - in-memory cache with file-backed storage, eliminating data races by design.

ArchitectureskillSwift Concurrency 6.2skills/swift-concurrency-6-2

Swift 6.2 Approachable Concurrency: single-threaded by default, @concurrent for explicit background offloading, isolated conformances for main-actor types.

ArchitectureskillSwiftUI Patternsskills/swiftui-patterns

SwiftUI architecture: state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ArchitectureskillVite Patternsskills/vite-patterns

Vite patterns for Traffic One React apps and packages: vite.config.*, dev/build behavior, env vars, proxies, HMR, monorepo imports, library mode, chunking, performance.

[ // GET STARTED ][ DEPLOY // ][ PLUGIN // ][ // SHIP ]
Get started

Use the AI you already pay for.
Add superpowers.

One plugin. Senior-engineer rules, security, a backend, and one-command deploys — inside the editor you already use.

Install "Traffic One" via AI Agent plugin marketplacemarketplace
free hobby tier·no credit card·any model, any plan
works inside
Cursor logoCursor
Claude Code logoClaude Code
Codex logoCodex
Copilot logoCopilot
Kilo logoKilo
Windsurf logoWindsurf
OpenCode logoOpenCode