Verify Implementation

Run verification commands after implementing changes to ensure correctness.

Verification Sources

Check thoughts/notes/commands.md (created by discover-project-commands skill) for:

• •Available test commands
• •Linting commands
• •Build commands
• •Other project-specific verification

IMPORTANT: Always Use Verification Agent

DO NOT run verification commands directly in main context.

Spawn a verification agent to run checks and return summary:

Task(subagent_type="Bash",
     prompt="Run verification commands from plan success criteria:
     - make test
     - make lint
     - make build
     [list all automated checks from plan]

     Return concise summary:
     - If all pass: ✅ All verification passed
     - If any fail: ❌ Verification failed
       - List ONLY the failing checks
       - Include first few lines of error
       - Omit stack traces and verbose output

     Maximum output: 2k tokens")

Why use an agent:

• •Raw output can be 10k+ tokens (floods main agent context)
• •Agent filters to only essential info (1-2k tokens)
• •Keeps main agent focused on implementation
• •Part of token management strategy (see spawn-implementation-agents)

Agent returns:

• •✅ Pass status or ❌ Fail status
• •Only failed checks (not successful ones)
• •First few lines of errors (not full output)
• •Actionable information only

Common Verification Steps

1. Run Tests

Check commands.md, then run appropriate command:

• •make test - If Make target exists
• •npm test - If npm script exists
• •go test ./... - Direct Go command
• •pytest - Direct Python command

2. Run Linting

Check commands.md, then run:

• •make lint - If Make target exists
• •npm run lint - If npm script exists
• •golangci-lint run - Direct Go command
• •eslint . - Direct JavaScript command

3. Build Check

Check commands.md, then run:

• •make build - If Make target exists
• •npm run build - If npm script exists
• •go build ./... - Direct Go command

4. Type Checking (if applicable)

• •npm run typecheck - TypeScript
• •mypy . - Python
• •Go builds include type checking

Verification Workflow

1. •Check for commands.md: Read thoughts/notes/commands.md
2. •Run automated checks: Use commands from reference doc
3. •Report results: Show pass/fail for each check
4. •Manual verification: Prompt for manual testing if needed

Handling Failures

If verification fails:

1. •Show the error output
2. •Analyze the error
3. •Fix the issue
4. •Re-run verification
5. •Don't mark task complete until all checks pass

Example

# Read the commands reference
cat thoughts/notes/commands.md

# Run appropriate commands
make test
make lint
make build

# All pass? Mark phase complete in plan
# Any fail? Debug and fix before proceeding

Important

Always spawn agent for verification - never run commands directly in main context.

See spawn-implementation-agents skill for full orchestration pattern.