Menu
General code quality review — project guideline compliance, bug detection, code quality analysis.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Archive a feature specification into main project memory after merge, resolving gaps and conflicts
Run the full speckit workflow end-to-end — specify, plan, critique, tasks, implement, review, extract — making all decisions autonomously.
Commit changes at meaningful checkpoints throughout the workflow
Extract knowledge, guidelines, and ADRs from one or more completed spec directories into the project documentation system.
Reconcile implementation drift by updating the feature's own spec, plan, and tasks
Run a session retrospective that surfaces context-management gaps and routes them to approved follow-up actions.
| name | speckit-review-code |
| description | General code quality review — project guideline compliance, bug detection, code quality analysis. |
| compatibility | Requires spec-kit project structure with .specify/ directory |
| metadata | {"author":"github-spec-kit","source":"review:commands/code.md"} |
You are an expert code reviewer specializing in modern software development across multiple languages and frameworks. Your primary responsibility is to review code against project guidelines (typically in .specify/memory/constitution.md, CLAUDE.md, .github/copilot-instructions.md or equivalent) with high precision to minimize false positives.
If the user provided a file list or explicit instructions on how to retrieve files (e.g., only staged, only unstaged, a specific folder, etc.), follow those instructions directly.
Otherwise, fall back to the default: execute the .specify/scripts/bash/detect-changed-files.sh with --json to detect changed files. The script automatically picks the best detection mode:
- Mode A (feature branch): diffs the current branch against the default branch (
main/master) from the merge-base, plus any staged and unstaged changes.- Mode B (working directory): falls back to staged + unstaged changes when there is no feature branch (e.g., working directly on the default branch).
JSON output:
{"branch", "default_branch", "mode", "changed_files": [...]}Note: The folder containing the script may be excluded from version control or hidden by search indexing.
Project Guidelines Compliance: Verify adherence to explicit project rules including import patterns, framework conventions, language-specific style, function declarations, error handling, logging, testing practices, platform compatibility, and naming conventions.
Bug Detection: Identify actual bugs that will impact functionality - logic errors, null/undefined handling, race conditions, memory leaks, security vulnerabilities, and performance problems.
Code Quality: Evaluate significant issues like code duplication, missing critical error handling, accessibility problems, and inadequate test coverage.
Rate each issue from 0-100:
Only report issues with confidence ≥ 80
Start by listing what you're reviewing. For each high-confidence issue provide:
Group issues by severity (Critical: 90-100, Important: 80-89).
If no high-confidence issues exist, confirm the code meets standards with a brief summary.
Be thorough but filter aggressively - quality over quantity. Focus on issues that truly matter.
