docs: update documentation for repogen (#20)

* docs: ensure CLAUDE.md documentation block

* docs: update documentation [doc-maintainer]

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: frostyardyeti[bot]

CLAUDE.md

@@ -0,0 +1,9 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with code in this repository.
+
+## Documentation
+
+**update documentation** After any change to source code, update relevant documentation in CLAUDE.md, README.md and the yeti/ folder. A task is not complete without reviewing and updating relevant documentation.
+
+**yeti/ directory** The `yeti/` directory contains documentation written for AI consumption and context enhancement, not primarily for humans. Jobs like `doc-maintainer` and `issue-worker` instruct the AI to read `yeti/OVERVIEW.md` and related files for codebase context before performing tasks. Write content in this directory to be maximally useful to an AI agent understanding the codebase — detailed architecture, patterns, and decision rationale rather than user-facing guides.

yeti/OVERVIEW.md

@@ -137,9 +137,9 @@ repeated compilation during scanning.
 2. Whether file sizes match
 3. Whether SHA256 checksums match
 
-Used by the RPM and Homebrew generators to skip unnecessary copies during
-generation. For existing packages in remote storage (S3/R2), the file may not
-exist locally — this is handled gracefully by returning `needsCopy=false`.
+Used by all six generators to skip unnecessary copies during generation.
+For existing packages in remote storage (S3/R2), the file may not exist
+locally — this is handled gracefully by returning `needsCopy=false`.
 
 ## Configuration
 

yeti/ci-cd.md

@@ -89,6 +89,20 @@ build packages and want to add them to a repository incrementally.
 |--------|-------------|
 | `packages-added` | Number of packages added to the repository |
 
+## Dependabot
+
+`.github/dependabot.yml` configures automated dependency updates:
+
+- **Ecosystem**: `gomod` — monitors `go.mod` for dependency updates.
+- **Schedule**: Weekly checks.
+- **Commit prefix**: `deps:` — follows the conventional-commit style used in
+  this repo (e.g., `perf:`, `fix:`, `docs:`).
+- **Labels**: PRs are labeled `dependencies`.
+
+Dependabot respects the `go` directive in `go.mod` and will not propose updates
+requiring a newer Go version. Dependabot PRs trigger the `Test` workflow
+automatically, providing CI validation before merge.
+
 ## Makefile Targets
 
 | Target | Description |