Spec Reviewer Conventions — Testing & QA agent for Claude Code
Review an engineering spec for adherence to repo conventions and prior decisions.
How to install Spec Reviewer Conventions
Installs to ~/.claude/agents/ziomancer-vigil-skills-spec-reviewer-conventions.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/ziomancer/vigil-skills/HEAD/agents/spec-reviewer-conventions.md -o ~/.claude/agents/ziomancer-vigil-skills-spec-reviewer-conventions.md Restart Claude Code, or start a new session, for it to be picked up.
What Spec Reviewer Conventions does
name: spec-reviewer-conventions description: Review an engineering spec for adherence to repo conventions and prior decisions. Reads CLAUDE.md, the project wiki (if any), and greps the codebase for established patterns. Flags premature abstractions, contradictions with prior decisions, and unneeded backwards-compat shims. Returns severity-ranked findings with a machine-parseable STATUS line.
You are a conventions reviewer for an engineering spec. Your single job: critique the spec on wh
Alternatives in Testing & QA
- Senior Code Reviewer — Fullstack code reviewer with 15+ years experience analyzing security vulnerabilities, performance bottlenecks 1.2k ★
- Backend Unit Tests — Add focused backend unit tests aligned with current package test conventions 720 ★
- Review Code Quality — Reviews code changes for code quality, conventions, readability, DRY violations, error handling, test coverage 432 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Prior Art Reviewer
Collegium spec reviewer — hunts reinvented wheels and grandfathered decisions. For every mechanism the spec pr
Research Architecture
Maps architecture patterns and conventions in an existing codebase. Dispatched by /spec for brownfield project
Fresh Eyes Reviewer
First-time reader perspective on a paper. Reads cold with no prior context — not the spec, not the lit review,
Review Spec Testability
Test engineering auditor for specs. Evaluates whether each invariant is testable — flags vague invariants and
Selenium Test Specialist.Agent
Create Selenium WebDriver tests following best practices, the POM pattern, and project conventions with focus
Staff Eng
Staff Engineer / Engineering Manager for the software factory. Owns technical decisions, breaks down work, ass
Related Skills
Does This Clash
Analyze whether code fits with established codebase patterns and conventions
Adopt Project
Existing-codebase entry point — infer stack, layering, conventions and decisions from the code; produce workfl
Scope Creep Detector
Reads a PRD, spec, or project brief line by line and flags every sentence that will cause scope creep. Identif