jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/.dochygiene-rules.json

81 lines
3.1 KiB
JSON
Raw Normal View History

os-doc-hygiene: lifecycle-aware hygiene implementation + calibration pass #1 (map #31) Implements the lifecycle-aware-doc-hygiene change (ADR-0038..0041): rulebook loader (global rulebook.json + per-project .dochygiene-rules.json, add-only merge, two-axis precedence, IGNORE-sentinel zero-emission prune), scanner lifecycle signals + temporary/delete-once-served tiers, report schema delete/extract-then-delete ops with git-state tier derivation, promotion_candidates from conventions.json, patch-applier deletion ops with apply-time git re-verification, and the /os-doc-hygiene:calibrate skill. Calibration pass #1 (cc-os) PASSED: protected-set hard gate + recall floor 9/10 with all 4 mandatory rows; 4 human-approved rules persisted to repo-root .dochygiene-rules.json. invariants.md #3 (.cc-os/dochygiene per ADR-0027) and #9 (rulebook IGNORE as third ignore mechanism) corrected with explicit human approval per the META-RULE. test_no_global_index_created now runs against an isolated HOME (the real ~/.cc-os legitimately exists since os-backlog's projects registry). Suite: 408 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LAw7YxP71Fk6K9AHNaYPj2
2026-07-15 11:41:59 +00:00
{
"schema_version": 1,
"rules": [
{
"glob": "autoresearch/*/",
"lifetime": "temporary",
"retain_recent": 3,
"max_age_days": 30,
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "calibration pass #1 (lifecycle-aware-doc-hygiene)",
"note": "Autoresearch run directories are disposable run output; keep the 3 newest, age out the rest."
},
{
"glob": "docs/orchestration-audit/factsheets/*.md",
"lifetime": "temporary",
"retain_recent": 10,
"max_age_days": 90,
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "calibration pass #1 (lifecycle-aware-doc-hygiene)",
"note": "Regenerable precompute for the orchestration IRL audit; the audit skill rebuilds them on each run."
},
{
"glob": "plugins/*/.pytest_cache/",
"lifetime": "temporary",
"retain_recent": 0,
"max_age_days": 7,
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "calibration pass #1 (lifecycle-aware-doc-hygiene)",
"note": "Regenerable pytest cache. Judge noted a .gitignore entry may be preferable long-term."
},
os-doc-hygiene: post-calibration follow-ups - Rules: 4 new lifecycle rules for OpenSpec trees (specs/** keep; changes/archive/*/ temporary retain 3 / 90d), root + plugins/* - Fill TBD Purpose placeholders in doc-check + doc-clean specs (the doc-check one was a check-run miss: sat under file_length thresholds) - Report header: "findings: N" + "cleared: K of M evaluated entries" (cleared no longer masquerades as files-scanned) - CLAUDE.md: vault user-guide pointer; fix stale .dochygiene/ state path to .cc-os/dochygiene/ (ADR-0027) Suite: 408 passed, 3 skipped. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LAw7YxP71Fk6K9AHNaYPj2
2026-07-15 14:22:41 +00:00
{
"glob": "openspec/specs/**",
"lifetime": "keep",
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "conversation 2026-07-15 (openspec lifecycle rules)",
"note": "Live OpenSpec capability specs — source of truth future changes diff against; never age out."
},
{
"glob": "plugins/*/openspec/specs/**",
"lifetime": "keep",
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "conversation 2026-07-15 (openspec lifecycle rules)",
"note": "Live OpenSpec capability specs — source of truth future changes diff against; never age out."
},
{
"glob": "openspec/changes/archive/*/",
"lifetime": "temporary",
"retain_recent": 3,
"max_age_days": 90,
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "conversation 2026-07-15 (openspec lifecycle rules)",
"note": "Archived change dirs are redundant once synced into specs/ and stay recoverable from git history; age out after a quarter."
},
{
"glob": "plugins/*/openspec/changes/archive/*/",
"lifetime": "temporary",
"retain_recent": 3,
"max_age_days": 90,
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "conversation 2026-07-15 (openspec lifecycle rules)",
"note": "Archived change dirs are redundant once synced into specs/ and stay recoverable from git history; age out after a quarter."
},
os-doc-hygiene: lifecycle-aware hygiene implementation + calibration pass #1 (map #31) Implements the lifecycle-aware-doc-hygiene change (ADR-0038..0041): rulebook loader (global rulebook.json + per-project .dochygiene-rules.json, add-only merge, two-axis precedence, IGNORE-sentinel zero-emission prune), scanner lifecycle signals + temporary/delete-once-served tiers, report schema delete/extract-then-delete ops with git-state tier derivation, promotion_candidates from conventions.json, patch-applier deletion ops with apply-time git re-verification, and the /os-doc-hygiene:calibrate skill. Calibration pass #1 (cc-os) PASSED: protected-set hard gate + recall floor 9/10 with all 4 mandatory rows; 4 human-approved rules persisted to repo-root .dochygiene-rules.json. invariants.md #3 (.cc-os/dochygiene per ADR-0027) and #9 (rulebook IGNORE as third ignore mechanism) corrected with explicit human approval per the META-RULE. test_no_global_index_created now runs against an isolated HOME (the real ~/.cc-os legitimately exists since os-backlog's projects registry). Suite: 408 passed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LAw7YxP71Fk6K9AHNaYPj2
2026-07-15 11:41:59 +00:00
{
"glob": "plugins/*/HANDOFF-*.md",
"lifetime": "delete-once-served",
"served_when": "The handoff it describes has been picked up and its follow-on work completed in a later session.",
"confirmed_by": "human",
"confirmed_on": "2026-07-15",
"source": "calibration pass #1 (lifecycle-aware-doc-hygiene)",
"note": "Classifier-judged served_when — always confirm-tier by ADR-0039; never auto-deleted."
}
]
}