A template for building software with coding agents. It gives agents the context, patterns and checks they need to work in the same codebase. Executable standards beat written promises. Consistency is infrastructure. The TypeScript, React and tRPC greeting app gives every gate real code to check. A person owns the change, reviews the proof, merges and deploys.
Follow the seven-step walkthrough: clear intent, useful checks, executable architecture, fast feedback and a human review decision. Each stop pairs a readable example with the real source.
Requires Node 22.18 or higher and pnpm. Start with AGENTS.md for the operating contract and full command list.
pnpm install # install dependencies
pnpm e2e:install # one-time: download the pinned Chromium that pnpm e2e and the pre-push hook need
pnpm dev # web at http://localhost:5173 and api at :3001
pnpm lint:policy # Oxlint: policy, Tailwind, React hooks, Compiler and Doctor rules
pnpm lint:styles # Tailwind tokens only in CSS and index.html: no arbitrary values or colour literals
pnpm arch:check # architecture, structure, diagrams, and API reports
pnpm verify # the full local gate suite
pnpm e2e # every result's behaviour map and accessibility scansThe greeting is deliberately small: enter a name and the api greets it back. Follow that slice when adding a feature.
| Start here | What it covers |
|---|---|
| Context and harnesses | Agent entry points, commands, hooks and settings. |
| Quality gates | Local and CI checks, with the required-check inventory. |
| Fifteen-minute software factory tour | Seven readable stops with illustrated examples, source links and a clear path through the repository. |
| Definition of Done and PR contract | Completion criteria and the proof a reviewer needs. |
| Architecture and conventions | Module roles, allowed imports and code patterns; templates to copy. |
| Product intent and North Star | The greeting's promises and the template's direction; ADRs record decisions. |
| Visual regression | How the reference app's Playwright baselines are captured and updated. |
| Skills | Workflows for adoption, tests, browser verification and PR proof. |
| Trials | Running the Todo and Notes trials and reading their evidence. |
| CI speed | The best current knowledge on fast CI: measuring it, the bar before paying for faster runners, every technique with its measured gain, runner costs, and our baseline. |
| Optional local Mini Fleet CI | Running Linux and macOS CI on your own Macs with Cua Spaces, and a proposed Dagger layer with its benchmarks. |
Choose Use this template for a new project, or use the adoption skill in an existing repo. Follow the hosted setup checklist to configure security and merge enforcement.
Fallow checks dead code, cycles,
complexity and architecture. It also supplies the import graph for the role diagram.
Install the Fallow skill in Claude Code with /install fallow-rs/fallow-skills.
MIT.