AGENTS.md@.ocr/skills · git:20260126.4957715 · 2026-01-26 · sha256 50bf3284d7e6342a
AGENTS.md@.ocr/skills git:20260126.4957715A
Immutable. This exact content never changes and is served at /api/v1/blob/50bf3284d7e6342a.
# Open Code Review - Agent Instructions
These instructions are for AI assistants performing code reviews in this project.
## Quick Start
When asked to perform a code review:
1. **Read** `SKILL.md` for the Tech Lead role and responsibilities
2. **Follow** `references/workflow.md` for the 8-phase review process
3. **Use** reviewer personas from `references/reviewers/` for multi-perspective analysis
4. **Store** session artifacts in `.ocr/sessions/{timestamp}-{branch}/`
## Available Commands
| Command | Description |
|---------|-------------|
| `/ocr-review` | Start a full code review session |
| `/ocr-doctor` | Check OCR installation and dependencies |
| `/ocr-reviewers` | List available reviewer personas |
| `/ocr-history` | Show past review sessions |
| `/ocr-show` | Display a specific past review |
| `/ocr-post` | Post review to GitHub PR |
## Review Workflow Summary
1. **Context Discovery** - Understand codebase structure and standards
2. **Change Context** - Analyze the specific changes being reviewed
3. **Tech Lead Analysis** - Initial assessment and reviewer team selection
4. **Parallel Reviews** - Each reviewer analyzes from their perspective
5. **Discourse** - Reviewers discuss and debate findings
6. **Synthesis** - Aggregate findings into actionable feedback
7. **Presentation** - Generate final review output
## Key Files
- `SKILL.md` - Core skill definition and Tech Lead role
- `references/workflow.md` - Complete 8-phase workflow
- `references/synthesis.md` - How to synthesize findings
- `references/discourse.md` - Multi-agent discourse rules
- `references/reviewers/` - Reviewer persona definitions