Curated Engineering Archetypes
This directory contains battle-tested, standardized engineering archetypes that AI coding agents follow when scaffolding new projects, authoring code, or refactoring services.
Available Archetypes
| Archetype | Primary Stack | Key Highlights | Blueprint |
|---|---|---|---|
| Fullstack Simulation & Control | C# .NET 10 + React + SQL | Dapper, Stored Procedures (.sql files), SQLite WAL / MSSQL, Zustand, Simulation & Control Harness, Playwright Layout Inspector, Git Flow, 4-Stage CI/CD. | View Archetype |
| C# Console & CLI | C# .NET 10 | System.CommandLine, full DI, Native AOT ready, --json stream, -v debug dumps, --dry-run, subprocess harness. | View Archetype |
| Python FastAPI & FastMCP | Python 3.12+ | APIs First, MCP Later: uv, typed FastAPI REST endpoints first, thin FastMCP tool wrappers second, Pydantic v2 schemas, aiosqlite, pytest. | View Archetype |
| React, TypeScript & Vite UI | React / TypeScript / Vite | Zustand domain stores, pure CSS Modules + custom properties, zero heavy UI bloat, 4-point layout audit. | View Archetype |
| Modern C++ Native Systems | C++20/23 | MSBuild / CMake, vcpkg, strict RAII, GoogleTest boundary sweeps, ASan/UBSan, Benchmark, C# / Python interop. | View Archetype |
Agent Execution Workflow
Project Scaffolding and Git Flow
- Git Flow Discipline: Always work on isolated
feature/*branches offdevelopand create atomic Conventional Commits (see Traditional Git Flow Discipline). - Automated Scaffolding: Invoke the
scaffold-projectskill with--archetype <name>to instantiate a compilable baseline. - APIs First, MCP Later: Implement and test core domain logic and typed APIs before exposing MCP adapter tools (see APIs First, MCP Later).
Implementation and Verification Cadence
- Modularity Discipline: Adhere to persistence, state management, and file size limits (≤ 500 LOC) specified in the Master Engineering Style Guide.
- Tiered Verification: Execute Tier 1 unit tests during development, Tier 2 simulation harnesses and layout audits before manual verification, and Tier 3 quality gates before opening Pull Requests (see Tiered Testing Cadence).