adk-archive-governance

Goal

• 治理 docs/archive 的可检索性、可审计性和安全边界。
• 修复缺 meta、topic 未登记、hash 漂移、命名不合规、重复 superseded 和敏感材料风险。

Prerequisites

• 已确认 archive 根目录和检查入口。
• 已拿到归档检查输出或明确的不合规文件。
• 已区分“创建新归档”和“治理已有归档”。

Workflow

1. 读取 archive README、registry/schema 和检查脚本说明。
2. 运行或规划 archive check，收集错误列表。
3. 分类问题：missing meta、bad filename、topic missing、hash mismatch、duplicate、sensitive、stale open item。
4. 最小修复：补 meta、登记 topic、更新 hash、规范文件名、标记 superseded。
5. 安全审查：排除 raw sessions、auth、cache、logs、private endpoints 和 secrets。
6. 查询验证：对受影响 topic 做 targeted archive search。
7. 最终运行 archive check 和项目总检查。

Commands

rtk rg -n "archive|meta|topic|registry|content_sha256" docs/archive scripts
rtk bash scripts/archive-check.sh
rtk bash scripts/archive-search.sh "<query>" --json

Evidence Template

status: pass | needs-fix | blocked
issues:
- path:
  class:
  action:
changed:
- path:
checks:
- archive-check:
- archive-search:
remaining:

Quality Gate

• 每个归档 Markdown 必须有合规 meta 或明确不归档决策。
• superseded 条目必须有 superseded_by。
• topic registry 必须能解释新增 topic。
• 修复后必须跑 archive check 或说明无法执行的原因。