ci-workflow

name	CI Workflow
description	Push accountability, CI monitoring after push, background agent CI verification, verification command sequencing.

CI Workflow

Push Accountability

Use the branch that is currently under CI verification. In a develop/main topology this is often develop. In a main-only repo it is usually the temporary branch or PR branch being validated before merge.

Wrong -- push and move on:

git push origin <branch-under-test>
# Start next task immediately, never check CI

Right -- spawn background agent to monitor CI:

git push origin <branch-under-test>
# Background agent:
gh run list --branch <branch-under-test> --limit 1
# If CI fails: investigate with gh run view <id> --log-failed
# Fix and re-push. The push isn't done until CI is green.

Verification Command Sequencing

Wrong -- run typecheck, lint, test as parallel tool calls:

# Parallel call 1: pnpm run typecheck
# Parallel call 2: pnpm run lint
# Parallel call 3: pnpm run test
# If one fails, all parallel calls are killed (Error #1)

Right -- chain sequentially with semicolons:

pnpm run typecheck 2>&1; pnpm run lint 2>&1; pnpm run test 2>&1

Pre-Commit Verification

Wrong -- commit first, discover failures from pre-commit hook:

git commit -m "feat: add feature"
# Pre-commit hook fails: lint errors, type errors

Right -- run checks before committing:

pnpm run typecheck 2>&1; pnpm run lint 2>&1
git add <files> && git commit -m "feat: add feature"

Config Change Blast Radius

Wrong -- change tsconfig and continue coding:

# Edit tsconfig.json
# Continue implementing next feature
# Discover 200 type errors at commit time

Right -- run full test suite immediately after config changes:

# Edit tsconfig.json
pnpm run typecheck 2>&1; pnpm run lint 2>&1; pnpm run test 2>&1
# Fix any breakage before proceeding