ai-agents-docs-of-recordlisted

# ai-agents-docs-of-record <!-- vendor-portability: contributor-facing knowledge pack for the rjmurillo/ai-agents repo itself; intentionally references upstream paths (.agents/, .claude/, scripts/, build/) because its audience is repo contributors, not plugin consumers (issue #2050) --> This repo runs on verification-based governance. Continuity lives in per-issue handoffs and Serena memory. Session log creation is discontinued; transcript and pull request evidence remain valid, and the ~1,500 historical logs under `.agents/sessions/` stay in the repo as history. ## Triggers - `write the session log` - `create an ADR` - `fill the retro` - `save this to memory` - `which document of record does this go in` ## The Record System Map | Record | Location | Create with | Validated by | |--------|----------|-------------|--------------| | Session log (historical only, creation discontinued) | `.agents/sessions/YYYY-MM-DD-session-NN[-slug].json` | do not create new ones | `scripts/validate_session_json.py`, validate-if-present via the `session-policy` pre-commit hook, applies only if one is somehow staged | | Per-issue handoff | `.agents/sessions/handoffs/{YYYY-MM-DD}-{ISSUE}-handoff.md` | copy `.agents/templates/HANDOFF.md` | resume-verification checklist at next session start | | ADR | `.agents/architecture/ADR-NNN-slug.md` | `adr-generator` skill | `scripts/validation/check_adr_uniqueness.py`; `adr-review` debate gate | | Retrospective | `.agents/retrospective/` | auto-retro s