Skip to content

Commit 0712195

Browse files
Ubuntuclaude
andcommitted
feat: Add Repo Guardian templates to gh-aw-adoption skill
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>
1 parent d85ccfa commit 0712195

File tree

4 files changed

+45
-242
lines changed

4 files changed

+45
-242
lines changed

.claude/skills/gh-aw-adoption/SKILL.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -286,12 +286,57 @@ Before using this skill, ensure:
286286
4. **Authentication**: GitHub token with appropriate scopes
287287
5. **Optional: Integration branch**: For staging workflow changes before main
288288

289+
## Repo Guardian: Featured First Workflow
290+
291+
**Repo Guardian** is the recommended first workflow to adopt in any repository. Ready-to-copy
292+
templates are included in this skill directory:
293+
294+
- **`repo-guardian.md`** — The gh-aw agentic workflow (natural language prompt for the AI agent)
295+
- **`repo-guardian-gate.yml`** — Standard GitHub Actions workflow that enforces agent findings as a blocking CI check
296+
297+
### What It Does
298+
299+
Reviews every PR for **ephemeral content that doesn't belong in the repo**:
300+
301+
- Meeting notes, sprint retrospectives, status updates
302+
- Temporary scripts (`fix-thing.sh`, `one-off-migration.py`)
303+
- Point-in-time documents that will become stale
304+
- Files with date prefixes suggesting snapshots
305+
306+
Posts a PR comment with findings. Collaborators can override with `repo-guardian:override <reason>`.
307+
308+
### Quick Setup
309+
310+
```bash
311+
# 1. Copy templates
312+
mkdir -p .github/workflows
313+
cp .claude/skills/gh-aw-adoption/repo-guardian.md .github/workflows/repo-guardian.md
314+
cp .claude/skills/gh-aw-adoption/repo-guardian-gate.yml .github/workflows/repo-guardian-gate.yml
315+
316+
# 2. Compile the agentic workflow (pins the gh-aw version)
317+
cd .github/workflows
318+
gh aw compile repo-guardian
319+
320+
# 3. Add COPILOT_GITHUB_TOKEN secret (PAT with read:org + repo scopes)
321+
# Repository Settings → Secrets and variables → Actions → New repository secret
322+
323+
# 4. Commit and push all three files
324+
git add .github/workflows/repo-guardian.md \
325+
.github/workflows/repo-guardian.lock.yml \
326+
.github/workflows/repo-guardian-gate.yml
327+
git commit -m "feat: Add Repo Guardian agentic workflow"
328+
git push
329+
```
330+
331+
---
332+
289333
## Common Workflows to Adopt
290334

291335
Based on analysis of 100+ workflows in the gh-aw repository, these are high-impact workflows to consider:
292336

293337
**Security & Compliance** (High Priority):
294338

339+
- `repo-guardian.md` - Block PRs containing ephemeral content (included as template — see above)
295340
- `secret-validation.md` - Monitor secrets for expiration and leaks
296341
- `container-security-scanning.md` - Scan container images for vulnerabilities
297342
- `license-compliance.md` - Verify dependency licenses
File renamed without changes.
File renamed without changes.

.claude/skills/gh-aw-setup/SKILL.md

Lines changed: 0 additions & 242 deletions
This file was deleted.

0 commit comments

Comments
 (0)