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 logs are optional records, while transcript and pull request evidence remain valid. ## 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 | `.agents/sessions/YYYY-MM-DD-session-NN[-slug].json` | `session-init` skill | `scripts/validate_session_json.py`, validate-if-present via the `session-policy` pre-commit hook or on demand (a session log is optional) | | 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 skeleton + `/retro fill`, or `retrospective` skill | `INDEX.md` row (auto-appended, incomplete; see Phase 4) | | Serena memor