Ring:Verifying Code

Code Verification

When to use

• Before creating a pull request
• After completing implementation and wanting to confirm everything passes
• When user wants a quick "is this ready?" check

Skip when

• Project is not Go (no go.mod found)
• User only wants to run a single specific command
• Already inside a ring:running-dev-cycle execution (use the cycle gates instead)

Related

Complementary: ring:running-dev-cycle, ring:reviewing-code

Run everything. Get a verdict. This skill only REPORTS — it does NOT fix anything.

Step 0: Discover Commands

1. Verify go.mod exists → if not, STOP: "Not a Go project."
2. Read Makefile to discover available targets
3. Check tool availability: goimports, gofmt

Command resolution:

If Makefile target doesn't exist: use default command. If neither exists: SKIP (not a failure).

Phase 1: Static Analysis + Unit Tests (parallel)

Run all 6 in parallel. Capture stdout, stderr, exit code, duration for each.

Phase 1 gate: ALL pass → proceed to Phase 2. ANY fails → still run Phase 2, but verdict will be NEEDS_FIX.

Phase 2: Integration + E2E Tests (sequential)

Run sequentially. Continue even if first fails.

If target doesn't exist → SKIP (not a failure).

Phase 3: Executive Summary

Copy code
============================================
  VERIFICATION SUMMARY
============================================

Phase 1 — Static Analysis + Unit Tests: PASS / FAIL
Phase 2 — Integration + E2E Tests:      PASS / FAIL / SKIP
Total time: Xs

┌───┬──────────────────────┬────────┬──────────┐
│ # │ Check                │ Status │ Duration │
├───┼──────────────────────┼────────┼──────────┤
│ 1 │ lint                 │ PASS   │ 3.2s     │
│ 2 │ vet                  │ PASS   │ 1.1s     │
│ 3 │ imports              │ FAIL   │ 0.4s     │
│ 4 │ format               │ PASS   │ 0.3s     │
│ 5 │ docs                 │ PASS   │ 2.1s     │
│ 6 │ unit tests           │ PASS   │ 8.5s     │
│ 7 │ integration tests    │ PASS   │ 22.3s    │
│ 8 │ e2e tests            │ SKIP   │ -        │
└───┴──────────────────────┴────────┴──────────┘

ERRORS (first 10 lines per failure):
─────────────────────────────────────
#3 imports:
  internal/handler/user.go
  internal/service/auth.go

VERDICT: NEEDS_FIX

Verdict Rules

Error Display

For each failed command: show first 10 lines of stderr (or stdout if stderr empty).

• goimports -l / gofmt -l output = list of files to fix
• make generate-docs changed files = list modified files