feat: Add Repo Guardian templates to gh-aw-adoption skill#2402
Conversation
Adds a new `gh-aw-setup` skill that guides users through setting up GitHub Agentic Workflows (gh-aw) in any repository, focusing on the Repo Guardian workflow. ## What's Included **Skill** (`.claude/skills/gh-aw-setup/`): - `SKILL.md` — Setup guide with prerequisites, 3-step quick start, secrets configuration, branch protection, override mechanism, troubleshooting, and comparison to gh-aw-adoption skill - `repo-guardian.md` — gh-aw workflow template (AI agent prompt that reviews PRs for ephemeral content: meeting notes, temp scripts, point-in-time documents) - `repo-guardian-gate.yml` — Standard GitHub Actions workflow that enforces Repo Guardian findings as a blocking CI check ## What Repo Guardian Does AI-powered PR reviewer that detects and blocks: - Meeting notes, sprint retrospectives, status updates - Temporary/one-off scripts (fix-thing.sh, debug-auth.sh) - Point-in-time documents that will become stale - Files with date prefixes suggesting snapshots Uses gh-aw with GitHub Copilot CLI engine, safe-outputs (max 1 comment), read-only GitHub access, and an override mechanism for legitimate exceptions. Source: Adapted from cybergym repo's production repo-guardian workflow. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
|
🤖 Auto-fixed version bump The version in If you need a minor or major version bump instead, please update |
Repo Guardian - PassedAll 4 changed files have been reviewed:
No ephemeral content detected. All files are permanent, reusable project components.
|
Adds ready-to-copy Repo Guardian workflow templates to the existing gh-aw-adoption skill, and updates SKILL.md with setup instructions. ## Changes **New files in `.claude/skills/gh-aw-adoption/`:** - `repo-guardian.md` — gh-aw agentic workflow template (AI agent prompt that reviews PRs for ephemeral content: meeting notes, temp scripts, point-in-time documents). Adapted from cybergym production workflow. - `repo-guardian-gate.yml` — Standard GitHub Actions enforcement gate that makes Repo Guardian a blocking CI check **Updated `.claude/skills/gh-aw-adoption/SKILL.md`:** - Added "Repo Guardian: Featured First Workflow" section with what it does, template locations, and quick 4-step setup instructions - Added `repo-guardian.md` to the Security & Compliance workflow list ## What Repo Guardian Does Reviews every PR for ephemeral content that doesn't belong in the repo: - Meeting notes, sprint retrospectives, status updates - Temporary scripts (fix-thing.sh, one-off-migration.py) - Point-in-time documents that will become stale Two-workflow architecture: 1. repo-guardian.md: AI agent reviews PR, posts one comment (safe-outputs max:1) 2. repo-guardian-gate.yml: Enforces findings as blocking CI check Requires COPILOT_GITHUB_TOKEN secret (PAT with read:org + repo scopes). Override: add PR comment `repo-guardian:override <reason>`. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
b4451e8 to
0712195
Compare
|
🤖 Auto-fixed version bump The version in If you need a minor or major version bump instead, please update |
Repo Guardian - PassedAll 4 changed files have been reviewed:
No ephemeral content detected. All files are permanent, reusable project components.
|
|
I restarted my session on my attempt to port repo guardian to amplihack with pre commit hook this afternoon, and somehow i've driven it into deterministic pattern matching and grep-like checks. |
Summary
repo-guardian.mdandrepo-guardian-gate.ymltemplate files to the existinggh-aw-adoptionskillSKILL.mdwith a featured "Repo Guardian" section including quick setup instructions (4 steps)What's Changed
.claude/skills/gh-aw-adoption/repo-guardian.md(new).claude/skills/gh-aw-adoption/repo-guardian-gate.yml(new).claude/skills/gh-aw-adoption/SKILL.md(updated)Two-Workflow Architecture
Test plan
repo-guardian.mdto a test repo and compile withgh aw compile repo-guardian.lock.ymlmatches the cybergym production version structurerepo-guardian-gate.ymlis valid GitHub Actions YAML🤖 Generated with Claude Code