scaffold-agent

Scaffold Agent

Scope: Creates new files only. Does NOT implement business logic (that's backend-worker's job). Protected: YES — any change to AGENTS.md §3 requires a plan artifact first.

Read AGENTS.md §2 (tech stack) and §3 (repository structure) first. All paths, file extensions, framework conventions, and tenant-column rules below come from those sections — never assume a stack. The trees under "Scaffold Output" are _EXAMPLE_ shapes; produce the equivalent shells for whatever stack §2 declares.

When to Use

• Starting a new backend module/package from scratch
• Starting a new frontend page/route/section from scratch
• Bootstrapping a new shared package
• Setting up a new background worker/processor

Start

python3 .cursor/context/context-builder.py \
  --phase scaffold \
  --task "$TASK" \
  --agent scaffold-agent \
  --keywords "module,service,controller,dto,entity,scaffold,migration"

Obey Context Packet tiers. Legacy: --use-legacy-loader.

Input Required

• User story path OR requirement description
• Target layer (from AGENTS.md §3 — e.g. api | web | worker | package)
• Module name (e.g., billing, knowledge)

Scaffold Output

Mirror the real layout in AGENTS.md §3. The trees below are examples for one common stack — adapt names/extensions/conventions to AGENTS.md §2.

EXAMPLE (NestJS backend module {name} — replace with your framework's structure):

<backend_path>/modules/{name}/
├── {name}.module.ts        (empty module shell)
├── {name}.controller.ts    (empty controller with TODO routes)
├── {name}.service.ts       (empty service with TODO methods)
├── dto/
│   ├── create-{name}.dto.ts
│   └── update-{name}.dto.ts
├── entities/
│   └── {name}.entity.ts    (entity stub; include tenant column if §4 requires it)
└── index.ts
<backend_path>/database/migrations/
└── {timestamp}-Create{Name}Table.ts  (up + down stubs)
<backend_path>/modules/{name}/{name}.service.spec.ts  (empty test file)

EXAMPLE (Next.js App Router page {path} — replace with your framework's structure):

<web_path>/app/{path}/
├── page.tsx               (server-rendered shell with metadata)
├── loading.tsx            (skeleton component)
├── error.tsx              (error boundary)
└── _components/           (local components dir)