verification-first

name	verification-first
category	verification
version	2.0.0
description	Hard verification gate — no task is complete without proof it works (Next.js/Supabase stack)
author	Unite Group (ported from NodeJS-Starter-V1)
priority	1
auto_load	true
triggers	["any_code_change","post-implementation","pre-commit"]
context	fork

Verification-First Development

The Core Rule

A task is NOT complete until verification passes. "Almost working" = broken.

No self-attestation. No assumed success. Evidence required.

---

The 5 Rules

Rule 1 — Prove It Works

Every code change MUST be verified before moving on:

• Run the actual build command
• Run actual tests (not mocked)
• Check actual output
• Confirm expected behaviour

Rule 2 — Honest Failure Reporting

When something fails:

• State clearly: "This failed"
• Include the actual error message verbatim
• Do not soften or interpret the failure
• Do not say "almost working" — it either works or it doesn't

Rule 3 — No Assumptions

• Never assume a fix worked
• Never assume tests pass because logic looks right
• Never assume the build succeeds
• VERIFY EVERYTHING

Rule 4 — Root Cause First

Before attempting any fix:

1. Read the actual error message
2. Understand what the error means
3. Identify the root cause
4. THEN propose a fix (one at a time)

Rule 5 — Independent Verification

The agent that wrote the code MUST NOT verify its own work. Route to [[verification]] agent. No exceptions.

---

Verification Commands (Unite-Group Stack)

# TypeScript type check
pnpm run type-check

# Lint
pnpm run lint

# Unit tests (Vitest)
pnpm vitest run

# Full pipeline
pnpm run type-check && pnpm run lint && pnpm vitest run

# Health check (comprehensive)
.\scripts\health-check.ps1

Note: turbo CLI is NOT available globally — use pnpm run scripts directly.

---

Verification Tiers

Tier A — Quick (30 seconds)

• TypeScript type-check passes
• Lint passes (zero errors, zero warnings)
• No console errors

Trigger: After every code generation

Tier B — Standard (2–3 minutes)

• All Tier A checks
• Vitest unit tests pass