Verifying Before Completion
Quick Start
- Functional - All acceptance criteria met, happy path works, edge cases handled
- Technical - Tests pass, coverage met, lint clean, build succeeds
- Security - No secrets exposed, input sanitized, auth verified
- Performance - Response time acceptable, no N+1, no memory leaks
- Documentation - Code comments, API docs, README updated
- Evidence - Collect screenshots, test output, metrics for proof
Features
| Feature |
Description |
Guide |
| Universal Checklist |
Comprehensive validation |
Functional, technical, security, perf, docs |
| Evidence Collection |
Proof of verification |
Test output, screenshots, metrics |
| Automated Pipeline |
CI/CD validation |
Type check, lint, test, build, audit |
| Type-Specific Checks |
Context-aware validation |
UI, API, migration, bug fix, optimization |
| Pre-Commit Hooks |
Catch issues early |
lint-staged, related tests |
| Sign-Off Template |
Formal completion record |
Verified by, date, evidence links |
Common Patterns
# Universal Verification Checklist
FUNCTIONAL:
[ ] All acceptance criteria met
[ ] Happy path works correctly
[ ] Edge cases handled
[ ] Error handling works
[ ] Input validation works
TECHNICAL:
[ ] Tests pass (unit, integration, E2E)
[ ] Coverage meets threshold (80%+)
[ ] No TypeScript/lint errors
[ ] Build succeeds
[ ] No security vulnerabilities
DOCUMENTATION:
[ ] Complex logic commented
[ ] API documentation updated
[ ] README updated if needed
# Automated Verification Script
npm run lint # Lint check
npm run typecheck # Type check
npm test # Unit tests
npm run build # Build verification
npm audit # Security audit
# Full verification
npm run verify # Runs all checks
# Evidence Documentation Template
## Test Evidence
$ npm test
Test Suites: 15 passed
Tests: 87 passed
Coverage: 85.2%
## Manual Verification
| Step | Expected | Actual | Status |
|------|----------|--------|--------|
| Login | Form appears | Works | Pass |
| Submit | Success msg | Shows | Pass |
## Performance Metrics
| Metric | Baseline | Current | Status |
|--------|----------|---------|--------|
| Bundle | 245 KB | 248 KB | Pass |
| API | 150ms | 145ms | Pass |
## Sign-Off
[x] All tests pass
[x] Manual testing complete
[x] Ready for review
Verified by: [Name] on [Date]
# Type-Specific Checklists
UI COMPONENT:
[ ] Renders in all browsers
[ ] Responsive mobile/tablet/desktop
[ ] Loading/error/empty states
[ ] Keyboard accessible
[ ] Matches design specs
API ENDPOINT:
[ ] Correct status codes
[ ] Response matches schema
[ ] Auth/authz enforced
[ ] Input validated
[ ] Documented in OpenAPI
BUG FIX:
[ ] Root cause identified
[ ] Fix addresses root cause
[ ] Regression test added
[ ] No new bugs introduced
Best Practices
| Do |
Avoid |
| Run all tests before marking complete |
Skipping verification steps |
| Document evidence of verification |
Marking complete without evidence |
| Test both happy and unhappy paths |
Assuming tests are enough |
| Verify on multiple browsers/devices |
Ignoring edge cases |
| Check performance impact |
Skipping security checks |
| Use automated verification |
Merging without green CI |
| Include screenshots for UI |
Forgetting mobile testing |
| Self-review before requesting |
Rushing verification |
Related Skills
finishing-development-branches - Complete branch preparationexecuting-plans - Quality gates during executiondebugging-systematically - Verify fixes workdeveloping-test-driven - Build verification into process
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: verifying-before-completion3description: AI agent validates work through evidence-based verification with comprehensive checklists, automated validation, and proof-of-work documentation. Use when completing tasks, preparing for review, or ensuring quality. Use when this capability is needed.4---56# Verifying Before Completion78## Quick Start9101. **Functional** - All acceptance criteria met, happy path works, edge cases handled112. **Technical** - Tests pass, coverage met, lint clean, build succeeds123. **Security** - No secrets exposed, input sanitized, auth verified134. **Performance** - Response time acceptable, no N+1, no memory leaks145. **Documentation** - Code comments, API docs, README updated156. **Evidence** - Collect screenshots, test output, metrics for proof1617## Features1819| Feature | Description | Guide |20|---------|-------------|-------|21| Universal Checklist | Comprehensive validation | Functional, technical, security, perf, docs |22| Evidence Collection | Proof of verification | Test output, screenshots, metrics |23| Automated Pipeline | CI/CD validation | Type check, lint, test, build, audit |24| Type-Specific Checks | Context-aware validation | UI, API, migration, bug fix, optimization |25| Pre-Commit Hooks | Catch issues early | lint-staged, related tests |26| Sign-Off Template | Formal completion record | Verified by, date, evidence links |2728## Common Patterns2930```31# Universal Verification Checklist32FUNCTIONAL:33[ ] All acceptance criteria met34[ ] Happy path works correctly35[ ] Edge cases handled36[ ] Error handling works37[ ] Input validation works3839TECHNICAL:40[ ] Tests pass (unit, integration, E2E)41[ ] Coverage meets threshold (80%+)42[ ] No TypeScript/lint errors43[ ] Build succeeds44[ ] No security vulnerabilities4546DOCUMENTATION:47[ ] Complex logic commented48[ ] API documentation updated49[ ] README updated if needed50```5152```bash53# Automated Verification Script54npm run lint # Lint check55npm run typecheck # Type check56npm test # Unit tests57npm run build # Build verification58npm audit # Security audit5960# Full verification61npm run verify # Runs all checks62```6364```65# Evidence Documentation Template66## Test Evidence67$ npm test68Test Suites: 15 passed69Tests: 87 passed70Coverage: 85.2%7172## Manual Verification73| Step | Expected | Actual | Status |74|------|----------|--------|--------|75| Login | Form appears | Works | Pass |76| Submit | Success msg | Shows | Pass |7778## Performance Metrics79| Metric | Baseline | Current | Status |80|--------|----------|---------|--------|81| Bundle | 245 KB | 248 KB | Pass |82| API | 150ms | 145ms | Pass |8384## Sign-Off85[x] All tests pass86[x] Manual testing complete87[x] Ready for review88Verified by: [Name] on [Date]89```9091```92# Type-Specific Checklists93UI COMPONENT:94[ ] Renders in all browsers95[ ] Responsive mobile/tablet/desktop96[ ] Loading/error/empty states97[ ] Keyboard accessible98[ ] Matches design specs99100API ENDPOINT:101[ ] Correct status codes102[ ] Response matches schema103[ ] Auth/authz enforced104[ ] Input validated105[ ] Documented in OpenAPI106107BUG FIX:108[ ] Root cause identified109[ ] Fix addresses root cause110[ ] Regression test added111[ ] No new bugs introduced112```113114## Best Practices115116| Do | Avoid |117|----|-------|118| Run all tests before marking complete | Skipping verification steps |119| Document evidence of verification | Marking complete without evidence |120| Test both happy and unhappy paths | Assuming tests are enough |121| Verify on multiple browsers/devices | Ignoring edge cases |122| Check performance impact | Skipping security checks |123| Use automated verification | Merging without green CI |124| Include screenshots for UI | Forgetting mobile testing |125| Self-review before requesting | Rushing verification |126127## Related Skills128129- `finishing-development-branches` - Complete branch preparation130- `executing-plans` - Quality gates during execution131- `debugging-systematically` - Verify fixes work132- `developing-test-driven` - Build verification into process133134---135> Converted and distributed by [TomeVault](https://tomevault.io/claim/doanchienthangdev) — claim your Tome and manage your conversions.136<!-- tomevault:4.0:skill_md:2026-04-13 -->
tomevault-io