Write an ADR once.
Enforce it everywhere.

---
id: ARCH-003
title: API Route Conventions
domain: backend
rules: true
files:
  - "src/api/**/*.ts"
---

## Decision

All API route handlers must use the
createRoute() factory function.
Direct export default is prohibited.

## Do's and Don'ts

DO:  Use createRoute({ handler })
DON'T: Use export default function

import { defineRules } from "archgate/rules";

export default defineRules((ctx) => [
  {
    name: "require-createRoute",
    severity: "error",
    async run() {
      const files = await ctx.glob("src/api/**/*.ts");

      for (const file of files) {
        const hits = await ctx.grep(
          file, /export\s+default\s+function/
        );
        for (const hit of hits) {
          ctx.report({
            file, line: hit.line,
            message: "Use createRoute() factory",
          });
        }
      }
    },
  },
]);