Upkeep v1

Upkeep is a reusable GitHub Action that audits a repository for drift — stale docs, orphaned files, convention violations, spec/flow mismatches — by dispatching a team of specialized AI reviewers (powered by Claude). It treats your repo's own conventions as the rubric, reports divergence with evidence + severity, and never auto-edits.

What it checks

Seven reviewers (i18n opt-in):

• docs_staleness — outdated docs/READMEs, incl. multilingual-sync drift
• code_hygiene — dead code, leftovers, smells
• spec_flow — spec ↔ implementation/flow divergence
• visual_icon — stale or duplicate visuals & icons
• duplicate_orphan — duplicate & unreferenced files
• convention — your repo's own CLAUDE.md / skills / workflows as the rubric
• i18n — localization completeness (opt-in)

Usage

jobs:
  audit:
    uses: wei18/upkeep/.github/workflows/audit.yml@v1
    permissions:
      contents: read
      issues: write
      id-token: write
    secrets:
      claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

Set the repo secret with claude setup-token (uses your Claude Pro/Max plan — no separate API billing).

Outputs

• Self-contained HTML report artifact
• One upserted GitHub tracking issue (label audit)

Options

model · max_turns · issue_label · rubric_lang (reviewer language: en | zh-TW)

Docs

README + design docs in English · 繁體中文 · 简体中文 · 日本語 · 한국어