ForgeLM/.agents/workflows/4-verify.md

description

description
Verify phase - run full validation suite

Phase 4: Verify

Purpose

Run all linters, static analysis, and tests to ensure code quality.

Note: Paths below follow the project structure defined in project-structure.md. Adjust paths to match the actual project layout (e.g. apps/backend, apps/frontend).

Phase 3 Gate

• Were any storage/database adapter files modified? List them: ___
• Were any external API adapters modified? List them: ___
• If YES to either: are integration tests written and passing?
• If NO to both: state why Phase 3 was skipped

CRITICAL: If you modified *_pg.go, *_integration*.go, or any SQL query, Phase 3 is MANDATORY. Do not proceed without integration tests.

Phase 3.5 Gate

• Were any UI changes or modified? List them: ___
• If YES: are E2E tests written and passing?
• If NO to both: state why Phase 3.5 was skipped

CRITICAL: If you modified frontend/* or any frontend component and integration point, Phase 3.5 is MANDATORY. Do not proceed without E2E tests.

If This Phase Fails

If lint/test/build fails:

1. Do not proceed to Ship
2. Fix the issue (go back to Phase 2 or 3 as needed)
3. Re-run full verification
4. Only proceed when ALL checks pass

Steps

Set Mode: Use task_boundary to set mode to VERIFICATION.

1. Backend Validation

Run the FULL validation suite for the backend path as defined in project-structure.md:

# // turbo
# Adjust path per project-structure.md (default: apps/backend)
cd apps/backend && gofumpt -l -e -w . && go vet ./... && staticcheck ./... && gosec -quiet ./... && go test -race ./...

2. Frontend Validation

# // turbo
# Adjust path per project-structure.md (default: apps/frontend)
cd apps/frontend && pnpm run lint --fix && npx vue-tsc --noEmit && pnpm run test

3. Build Check

# Backend (path per project-structure.md)
cd apps/backend && go build ./...

# Frontend (path per project-structure.md)
cd apps/frontend && pnpm run build

4. Check Coverage

Report actual coverage in task summary.

Go:

go test -cover ./internal/features/...

Frontend:

pnpm run test -- --coverage

Completion Criteria

• All lint checks pass
• All tests pass
• Build succeeds
• Coverage reported (target >85% on domain logic)

On Success

Mark task as [x] in task.md (verification passed = task complete).

Next Phase

Proceed to Phase 5: Ship (/5-commit)