recsys-architecture-review
Review recommendation-system code, architecture, experiment, or design for correctness, serving safety, offline-online consistency, capacity, observability, and rollback gaps.
SKILL.md.agents/skills/recsys-architecture-review/SKILL.md
GitHubRecommendation architecture review
- Inspect the target and its callers before judging it.
- Run
python3 tools/recsys_agent.py review <path>for the domain checklist. - Search released PDFs for each material finding; read cited pages.
- Prioritize consumer-visible correctness, leakage, version mismatch, unbounded work, timeout/overload, empty fallback, missing metrics, and unsafe rollout.
- Report findings by severity with exact location, failure scenario, proposed fix, and verification. No style-only filler.
- Keep book evidence distinct from engineering judgment.