ai-agents-docs-of-record

Solid

Runbook for this repo's documents of record. Session logs, ADRs, retrospectives, Serena memories, per-issue handoffs, plus the templates, validators, naming rules, and house prose style that bind them. Use when you say `write the session log`, `create an ADR`, `fill the retro`, `save this to memory`, `which document of record`. Do NOT use for authoring skills (use `SkillForge`) or research write-ups (use `ai-agents-research-methodology`).

AI & Automation 38 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 77/100

Stars 20%
53
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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: work that is not recorded in a document of record did not happen (SESSION-PROTOCOL.md, "Trust-Based vs Verification-Based"). This skill is the operating manual for the five record systems, the house style they share, and the decision table for which record a given fact belongs in. Jargon: a "document of record" is an artifact a later session or CI gate treats as authoritative evidence, as opposed to chat output, which evaporates. ## 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`; CI `ai-session-protocol.yml` | | 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...

Details

Author
rjmurillo
Repository
rjmurillo/ai-agents
Created
7 months ago
Last Updated
today
Language
Markdown
License
MIT

Integrates with

Anthropic · AI

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

night-market-docs-and-writing

Maintain docs of record, ADRs, changelog, and house style. Use when writing repo docs. Do not use for release steps; use night-market-operations instead.

323 Updated today
athola
AI & Automation Solid

ai-agents-failure-archaeology

The chronicle of this repo's settled battles. Maps each major incident to symptom, root cause, evidence path, and the artifact that fixed it, so nobody re-fights a decided question. Use when you say `has this failed before`, `why does this rule exist`, `failure archaeology`, `what happened with issue 2205`. Do NOT use for triaging a live failure (use `ai-agents-debugging-playbook`) or for extracting learnings from the current session (use `retrospective`).

38 Updated today
rjmurillo
AI & Automation Listed

compound

Capture this session's durable learnings and route each to the right knowledge store, every write user-gated. Use at loop end when the commit tail prompts a session scan, when diagnosing-bugs closes out a fix, or when the user wants to capture, remember, or write down a learning, convention, gotcha, or preference.

1 Updated yesterday
toverux