Add scheduled repository cleanup workflow

README.md

@@ -61,6 +61,7 @@ Use only the files that fit the project. For a tiny script repo, `AGENTS.md`, `R
 | `files/project.md` | `.codex/project.md` |
 | `files/build-gitea.yml` | `.gitea/workflows/build.yml` |
 | `files/security-scan-gitea.yml` | `.gitea/workflows/security-scan.yml` |
+| `files/repo-cleanup-gitea.yml` | `.gitea/workflows/repo-cleanup.yml` |
 | `files/release-checklist.md` | `docs/release-checklist.md` |
 | `files/security-review.md` | `docs/security-review.md` |
 | `files/blueprint.md` | `blueprint.md` |
@@ -125,6 +126,7 @@ When applying this kit, an agent should:
 - update `README.md` whenever README blueprint files change,
 - update security and release docs when release behavior changes,
 - add or preserve scheduled security automation for releasable projects,
+- add or preserve scheduled repository cleanup checks for active projects,
 - update `docs/agent-handoff.md` when work is interrupted, risky, or multi-session,
 - run `git diff --check` before finishing,
 - run the cheapest reliable verification command,
@@ -147,6 +149,21 @@ The workflow is intentionally conservative. If it fails, an agent should inspect
 
 <p align="center"><img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----------------------------------------------------" width="100%"></p>
 
+## Scheduled Repository Cleanup
+
+`files/repo-cleanup-gitea.yml` provides an optional weekly Gitea workflow for active repositories.
+
+It reports:
+
+- generated files or dependency folders that were accidentally tracked,
+- large tracked files that may belong in release artifacts or package storage,
+- secret-prone local config files,
+- stale remote branch candidates.
+
+The workflow is intentionally non-destructive. It must not delete files, branches, packages, or releases. Agents should treat failures as maintenance reports, document intentional exceptions, and only remove repository data after explicit user approval.
+
+<p align="center"><img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----------------------------------------------------" width="100%"></p>
+
 ## Gitea API Token
 
 When working with private repositories on `git.wilkensxl.de`, Codex agents may find a local `GITEA_TOKEN` environment variable on the machine.