Skip to content

Commit 18bb31e

Browse files
docs: document 5 new agentic workflows added April 8, 2026
Add entries to the examples documentation for the five new workflows merged on 2026-04-08: - Test Quality Sentinel (#25353): PR-triggered test quality analysis - Approach Validator (#25354): label-triggered multi-agent approach review - Design Decision Gate (#25323): ADR enforcement before implementation merges - Refactoring Cadence (#25352): daily code health tracking with auto-issue - Architecture Guardian (#25334): daily code structure violation detection Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 9961bc4 commit 18bb31e

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed

docs/src/content/docs/examples/issue-pr-events/quality-testing.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,3 +25,15 @@ Identifies performance bottlenecks, runs benchmarks, and implements optimization
2525
### Test Failure Investigation
2626

2727
Automatically investigates failed workflow runs by analyzing logs, identifying root causes, and creating detailed investigation reports with actionable recommendations to prevent similar failures. [Learn more](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-detector.md)
28+
29+
### Test Quality Sentinel
30+
31+
Analyzes test quality beyond code coverage percentages on every PR. Detects implementation-detail tests, happy-path-only tests, test inflation, and duplication, then posts a structured quality report as a PR review comment. Triggered when a pull request is marked ready for review. Workflow file: `.github/workflows/test-quality-sentinel.md`
32+
33+
### Approach Validator
34+
35+
Evaluates proposed technical approaches before implementation begins using a sequential four-agent panel: Devil's Advocate (failure modes), Alternatives Scout (alternative approaches), Implementation Estimator (complexity), and Dead End Detector (rewrite risk). Triggered by adding an `approach-proposal` label to a PR or `needs-design` label to an issue. Requires human approval (react with ✅ or ❌) before implementation proceeds. Workflow file: `.github/workflows/approach-validator.md`
36+
37+
### Design Decision Gate
38+
39+
Enforces Architecture Decision Records (ADRs) before implementation work can merge. Detects whether a PR introduces new architectural decisions without a corresponding ADR, then generates a draft ADR and pushes it directly to the PR branch for human review. Triggered when a PR is labeled `implementation` or marked ready for review. Workflow file: `.github/workflows/design-decision-gate.md`

docs/src/content/docs/examples/scheduled/research-planning.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,3 +35,11 @@ Searches for information on a given topic, analyzes results, and creates structu
3535
### Model Context Protocol (MCP) Inspector
3636

3737
Analyzes all [MCP](/gh-aw/reference/glossary/#mcp-model-context-protocol) configuration files, extracts server details, and generates comprehensive inventory reports to maintain visibility into available [MCP servers](/gh-aw/reference/glossary/#mcp-server) and their capabilities. Runs weekly on Mondays at 10am UTC, or manually via workflow_dispatch. Workflow file: `.github/workflows/mcp-inspector.md`
38+
39+
### Refactoring Cadence
40+
41+
Tracks repository code health over time using file length, cyclomatic complexity, file growth, and TODO/FIXME/HACK churn metrics. Automatically opens a refactoring issue when the health score drops below a configurable threshold, giving teams a forcing function for continuous structural improvement. Uses cache memory to compare health trends across runs. Runs daily on weekdays. Workflow file: `.github/workflows/refactoring-cadence.md`
42+
43+
### Architecture Guardian
44+
45+
Analyzes commits from the last 24 hours to detect code structure violations in Go and JavaScript files — including large files, oversized functions, high export counts, and import cycles. Opens a GitHub issue when violations are found so teams can track and resolve structural debt before it accumulates. Runs daily on weekdays. Workflow file: `.github/workflows/architecture-guardian.md`

0 commit comments

Comments
 (0)