What problem does it solve?
Documentation in the Marin repository drifts out of sync with the code, confusing coding agents that rely on docs as their primary context source. This Skill de-rots Markdown docs in lib/iris, lib/zephyr, and lib/fray by updating or archiving outdated content.
Core Features & Use Cases
- Scoped doc repair: Fixes Markdown only within lib/iris, lib/zephyr, and lib/fray, never touching docs outside those directories.
- Rot handling: Updates recently changed docs in place or archives historical-only design docs to .agents/projects/<YYYYMMDD>_<filename>.md, dated from the first git commit.
- Agent-oriented standards: Enforces AGENTS.md, OPS.md, and SKILL.md conventions so agents know where to find token-efficient documentation.
- Use Case: After a refactor of the iris library, ask the agent to fix the docs; it dispatches sub-agents to parse code and docs, applies corrections, and commits everything as a single local commit.
Quick Start
Ask the agent to fix the outdated documentation in lib/iris, lib/zephyr, and lib/fray and commit the changes locally.