[Docs] Create comprehensive AGENTS.md aligned with other projects #34
Description
Problem
Current AGENTS.md is only 5 lines with minimal project hints. Other projects (daphne, v10r, ratcher) have comprehensive 600-800 line agent configuration files.
Requirements
Create a comprehensive AGENTS.md for opencode that includes:
From All Projects (Common Standards)
- context7 protocol - mandatory documentation lookup before coding
- Minimalist engineering philosophy
- Zero technical debt policy (no TODOs, FIXMEs, stubs)
- Module size limits (500 lines max)
- Scope control protocol
- Pre-creation challenge protocol
From daphne (Agent Hierarchy)
- Agent hierarchy & delegation rules (PM orchestrates, specialists execute)
- Agent tool restrictions
- Documentation quality guidelines (200-PR test)
- Quality enforcement flow
From v10r (Quality Gates)
- Pre-push verification checklist (mandatory)
- Work completion gates
- Test skip prohibition (zero tolerance)
- Dual coverage metrics (overall + per-file 80%)
- Conventional commits
From ratcher (Auto-Merge & Workflow)
- Auto-merge policy after agent review
- GitHub workflow (Issue → Branch → TDD → PR → Review → Merge)
- No deprecated/legacy code policy
TypeScript/Bun Specific
- Bun test runner commands
- TypeScript typecheck requirements
- Style guide integration (from STYLE_GUIDE.md)
- Package-specific commands (bun dev, bun run build)
Reference Files
~/git/daphne/AGENTS.md(666 lines) - Python, comprehensive agent hierarchy~/git/v10r/AGENTS.md(841 lines) - Python, strictest quality gates~/git/ratcher/AGENTS.md(604 lines) - Rust, auto-merge policy
Acceptance Criteria
- AGENTS.md is 400-600 lines (comprehensive but not bloated)
- All common standards included
- TypeScript/Bun specific guidance
- Integrates with existing STYLE_GUIDE.md
- context7 protocol prominently featured