Agent-OS doctor
Run the deterministic checker when Python is available:
python3 library/scripts/agent_os_doctor.py --root .
Otherwise inspect the same contracts manually:
agent-os.yamlidentity and portable/local boundary;- binder-to-workstream links and stable IDs;
- workstream schema, revision lineage, size, and the next-action or closed-sentinel rule;
- receipt metadata and relative paths;
- stale handoffs, duplicate IDs, partial files, and provider conflict copies;
- canonical
.agents/skillsplus generated Claude/Codex metadata; - missing skill references, PII, absolute machine paths, and adapter drift;
- backup freshness and whether local state resolves outside the portable root.
Report evidence, severity, and the smallest safe repair. Do not repair, delete, merge conflict copies, regenerate adapters, or touch global runtime settings unless the user authorizes that action.