feat: Add GitHub Agentic Workflows for docs, testing, and CLI consistency

[danielmeppiel]

Summary

Adds 3 GitHub Agentic Workflows to automate documentation maintenance, test improvement, and CLI consistency checking.

All workflows were installed/created using the gh aw CLI and compiled with gh aw compile (0 errors, 0 warnings).

Setup

• gh aw init — initialized repo with .gitattributes, agent dispatcher (.github/agents/), and VS Code settings
• gh aw compile — generated .lock.yml files for all 3 workflows

Workflows Added

1. Daily Documentation Updater

Installed via: gh aw add githubnext/agentics/daily-doc-updater

• Source: githubnext/agentics gallery (96% merge rate)
• Runs daily, scans merged PRs/commits, updates docs/ directory
• Creates PRs with [docs] prefix, auto-merge enabled

2. Daily Test Improver

Installed via: gh aw add githubnext/agentics/daily-test-improver

• Source: githubnext/agentics gallery
• Runs daily + supports /test-assist slash command
• Round-robin tasks: command discovery, coverage gaps, test implementation, PR maintenance
• Fixed incompatible max fields in safe-outputs for current gh-aw v0.42.2

3. CLI Consistency Checker (Custom)

Created via: gh aw new cli-consistency-checker + custom content

• Re-engineered from the gh-aw gallery CLI Consistency Checker (original was hardcoded for gh aw commands)
• Runs weekdays at 1 PM UTC
• Installs APM from source, runs all 22+ CLI commands/subcommands with --help
• Cross-references against docs/cli-reference.md and README.md
• Creates consolidated GitHub issues with severity levels

Files Added (10 files, ~4560 lines)

File	Source
.gitattributes	gh aw init
.github/agents/agentic-workflows.agent.md	gh aw init
.vscode/settings.json	gh aw init
.github/workflows/daily-doc-updater.md	gh aw add (gallery)
.github/workflows/daily-doc-updater.lock.yml	gh aw compile
.github/workflows/daily-test-improver.md	gh aw add (gallery)
.github/workflows/daily-test-improver.lock.yml	gh aw compile
.github/workflows/cli-consistency-checker.md	gh aw new + custom
.github/workflows/cli-consistency-checker.lock.yml	gh aw compile
.github/workflows/agentics-maintenance.yml	gh aw compile (auto-generated for expires field cleanup)

Security

All workflows use read-only default permissions with scoped safe-outputs for write operations. No write permissions are granted by default.

Note on Secrets

gh aw init flagged that GH_AW_GITHUB_TOKEN, GH_AW_AGENT_TOKEN, and GH_AW_GITHUB_MCP_SERVER_TOKEN are not configured as repository secrets. These will need to be set up for the workflows to function in CI.

[Copilot]

Pull request overview

This PR introduces three GitHub Agentic Workflows (gh-aw) that automate documentation maintenance, test improvement, and CLI consistency checking for the APM repository. These workflows use the gh-aw framework's markdown-based workflow syntax, which differs from standard GitHub Actions YAML format and requires compilation via gh aw compile before execution.

Changes:

• Adds daily-doc-updater.md to automatically sync documentation with code changes from merged PRs
• Adds daily-test-improver.md with 7 round-robin testing tasks and /test-assist command support
• Adds cli-consistency-checker.md to validate CLI help text against documentation

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 11 comments.

File	Description
.github/workflows/daily-doc-updater.md	Scans last 24h of commits, identifies doc drift, creates PRs to update docs/ files while flagging README.md changes for human review
.github/workflows/daily-test-improver.md	Comprehensive testing assistant with command discovery, opportunity identification, test implementation, PR maintenance, and monthly reporting
.github/workflows/cli-consistency-checker.md	Validates all APM CLI commands by running --help, cross-referencing docs, and reporting inconsistencies via consolidated issues

Comments suppressed due to low confidence (2)

.github/workflows/daily-test-improver.md:169

• The workflow references src/AGENTS.md which does not exist in the repository. AGENTS.md is a generated output file, not a source file. Consider removing this reference or replacing it with appropriate documentation files.

   - Read `src/AGENTS.md` for any coding conventions or guidelines.

.github/workflows/daily-test-improver.md:267

• The workflow references src/AGENTS.md which does not exist in the repository. AGENTS.md is a generated output file, not a source file. Consider removing this reference or replacing it with appropriate documentation files.

- Read `src/AGENTS.md` before every run to stay aligned with project conventions.

[Copilot]

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 9 comments.

[danielmeppiel]

Review Comment Resolution Summary

After thoroughly verifying all 22 review threads against the actual gh-aw documentation and source, here's what was done:

Fixes Applied (2 commits)

Commit 0b75ae2 — 3 real issues fixed:

1. Agent file synced with upstream main (addresses @SebastienDegodez's comments)

   • All prompt route URLs updated from stale commit SHAs to main
   • Added disable-model-invocation: true
   • Added all 8 prompt routes (create, update, debug, upgrade, report, shared, dependabot, test-coverage)
   • Added single-file output note

2. pip install -e . → uv sync in cli-consistency-checker.md

   • Now uses curl -LsSf https://astral.sh/uv/install.sh | sh && uv sync && source .venv/bin/activate
   • Matches project conventions (CONTRIBUTING.md, CI)

3. Added auto-merge: true + reviewers: [copilot] to daily-doc-updater.md

   • PR description claimed auto-merge behavior; config now matches

Commit d72a12c — Version upgrade v0.42.2 → v0.50.5:

• All 3 lock files recompiled with gh aw compile --action-tag v0.50.5
• agentics-maintenance.yml manually updated to v0.50.5
• All 18 actions/setup@ references now at v0.50.5

Review Comments Assessed as Non-Issues (with rationale)

Comment	Verdict	Reason
ubuntu-slim not a standard runner (×3)	Non-issue	Standard gh-aw compiled runner label, used across 900+ public repos. Injected by compiler.
permissions: read-all too broad	Non-issue	Valid GitHub Actions syntax, appropriate for read-only workflows
daily cron shorthand	Non-issue	Valid gh-aw frontmatter; compiler translates to randomized cron in lock file
bash: true / grep '*' patterns	Non-issue	Bash allowlist patterns (shell glob), not regex
Slash command reaction indentation	Non-issue	Correct gh-aw YAML schema — reaction is a peer field under on:
README.md edits	Non-issue	doc-sync.instructions.md already guards README as special case
expires: 2d too short	Design choice	With auto-merge + Copilot reviewer, 2d is reasonable. Will monitor.

Verdict

PR is ready to merge. All legitimate issues from both human reviewers and Copilot reviewer have been addressed. The remaining unresolved threads are false positives from the automated reviewer not being familiar with gh-aw's domain-specific conventions.