Skip to content

Commit 87a72e6

Browse files
zircotezircote
committed
feat: add /aw-daily autonomous pipeline and /aw-merge weekly cadence
- /aw-daily: 9-phase autonomous daily pipeline (research → discussion → gap analysis → implementation → PR to develop → review → merge) - /aw-merge: weekly develop-to-main merge with squash and reset - gh-aw scheduled workflows with fuzzy scheduling (daily-intelligence.md, weekly-develop-merge.md) - Gap analysis targets and tracked GitHub repos for activity queries - .claude/ mirrors for all commands and skills
1 parent 881956d commit 87a72e6

17 files changed

Lines changed: 1572 additions & 0 deletions

File tree

‎.claude/README.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
# aw-author Tools
2+
3+
Daily intelligence reporting and contextual knowledge for the **GitHub Agentic Workflows (gh-aw)** ecosystem.
4+
5+
## What It Does
6+
7+
The `aw-author` plugin gives Claude persistent, up-to-date knowledge of the gh-aw space and the tools to refresh that knowledge daily. It covers:
8+
9+
- GitHub Agentic Workflows (`github/gh-aw`, `gh aw` CLI)
10+
- GitHub Actions AI features and deprecations
11+
- GitHub Copilot Workspace & Agent Mode
12+
- GitHub Copilot CLI (agentic terminal coding)
13+
- GitHub Models API
14+
- GitHub MCP Server (`github/github-mcp-server`)
15+
- Claude Code × GitHub integrations
16+
- Agentic CI/CD patterns and community ecosystem
17+
18+
## Commands
19+
20+
### `/aw-report`
21+
Runs a full intelligence sweep — 8+ web searches across the gh-aw landscape — and produces a dated Markdown report saved to `outputs/gh-aw-reports/YYYY-MM-DD.md`. Updates the persistent knowledge base and posts to GitHub Discussions (`project-news` category) for historical record.
22+
23+
Flags: `--deep` (extended queries), `--no-post` (skip Discussions), `--domains domain1,domain2` (filter domains)
24+
25+
**Use when**: You want today's news, a briefing before a meeting, or to populate the knowledge base.
26+
27+
### `/aw-status`
28+
Reads the knowledge base and delivers a quick 300–400 word briefing on current versions, active deprecations, and recommended actions. No web searches needed.
29+
30+
Flags: `--domain domain` (focus on one domain), `--since YYYY-MM-DD` (filter by date)
31+
32+
**Use when**: You need a fast reminder of the current state without running a full report.
33+
34+
### `/aw-daily`
35+
Fully autonomous daily pipeline: research → Discussion posting → gap analysis → implementation → PR to `develop` → review → merge. Designed for zero human intervention.
36+
37+
Flags: `--dry-run` (research + analysis only), `--skip-research` (start at gap analysis), `--skip-implementation` (no file edits), `--no-merge` (create PR without merging)
38+
39+
**Use when**: Scheduled daily (via gh-aw workflow) or invoked manually to update reference files from the latest ecosystem intelligence.
40+
41+
### `/aw-merge`
42+
Weekly merge of `develop` into `main`. Creates a PR, waits for CI, squash merges, and resets `develop`.
43+
44+
Flags: `--dry-run` (show what would merge), `--no-reset` (skip develop reset after merge)
45+
46+
**Use when**: Weekly cadence to promote accumulated daily updates from `develop` to `main`.
47+
48+
## Skills
49+
50+
### `gh-aw-report`
51+
The core intelligence skill. Directs Claude to:
52+
1. Execute 8 targeted web searches across the gh-aw ecosystem
53+
2. Synthesize findings into a structured report with 7 standard sections
54+
3. Save the report to `outputs/gh-aw-reports/`
55+
4. Update the knowledge base with stable, persistent facts
56+
57+
## Knowledge Base
58+
59+
`skills/gh-aw-report/knowledge-base.md` is a persistent, append-only log of stable facts about the gh-aw ecosystem — versions, deprecations, architecture notes, and breaking changes. Every Claude session with this plugin starts with this context loaded.
60+
61+
### `aw-daily`
62+
The autonomous pipeline skill. Extends `gh-aw-report` with gap analysis against reference files, issue creation, implementation, and PR management. 9-phase pipeline targeting the `develop` branch.
63+
64+
## Scheduled Use
65+
66+
The primary daily pipeline runs via a gh-aw scheduled workflow (`.github/workflows/daily-intelligence.md`) with fuzzy scheduling (`daily around 07:00`). This runs on GitHub Actions using the Copilot engine.
67+
68+
The weekly `develop` → `main` merge runs via `.github/workflows/weekly-develop-merge.md` (`weekly on monday around 09:00`).
69+
70+
For local alternative execution, use `/aw-daily` or `/aw-merge` directly. Idempotency checks prevent duplicate work if the gh-aw workflow already ran.
71+
72+
## Reference Files
73+
74+
- `skills/gh-aw-report/references/gh-aw-architecture.md` — Stable system architecture facts
75+
- `skills/gh-aw-report/references/search-queries.md` — Extended query library for deep dives
76+
- `skills/gh-aw-report/knowledge-base.md` — Persistent cross-session knowledge store

‎.claude/commands/aw-daily.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: aw-daily
3+
description: >
4+
Fully autonomous daily pipeline: research, discussion posting, gap analysis,
5+
implementation, and PR to develop. Designed for unattended execution.
6+
Use with: /aw-daily [--dry-run] [--skip-research] [--skip-implementation] [--no-merge]
7+
tools:
8+
- WebSearch
9+
- WebFetch
10+
- Write
11+
- Edit
12+
- Bash
13+
- Read
14+
---
15+
16+
Run the `aw-daily` skill to execute the full daily intelligence and update pipeline.
17+
18+
## Flags
19+
20+
Parse the argument string for these optional flags:
21+
22+
- `--dry-run` — Research + gap analysis only, show diff, no commit/PR
23+
- `--skip-research` — Start at gap analysis using latest report
24+
- `--skip-implementation` — Research + gap analysis + issues, no file edits/PR
25+
- `--no-merge` — Create PR but do not auto-merge
26+
27+
## Steps
28+
29+
1. Load the aw-daily skill by reading `skills/aw-daily/SKILL.md`.
30+
2. Follow the skill's 9-phase instructions exactly.
31+
3. Do not prompt the user for input at any point.
32+
4. Report the final summary table when complete.
33+
34+
This command is designed for scheduled unattended execution.

‎.claude/commands/aw-merge.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: aw-merge
3+
description: >
4+
Weekly develop-to-main merge with PR, CI check, and squash merge.
5+
Use with: /aw-merge [--dry-run] [--no-reset]
6+
tools:
7+
- Bash
8+
- Read
9+
---
10+
11+
Merge `develop` into `main` via PR.
12+
13+
1. Check if `develop` is ahead of `main`
14+
2. If so, create a PR from `develop` to `main`
15+
3. Wait for CI checks (max 5 minutes)
16+
4. Squash merge
17+
5. Unless `--no-reset`, reset `develop` to new `main` HEAD
18+
19+
If `develop` is not ahead of `main`, report "Nothing to merge" and exit.
20+
If `--dry-run`, show what would be merged but take no action.

‎.claude/commands/aw-report.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
name: aw-report
3+
description: >
4+
Generate today's GitHub Agentic Workflows intelligence report. Searches the web
5+
for the latest news, features, breaking changes, and community activity across
6+
the gh-aw ecosystem, then produces and saves a structured Markdown report and
7+
posts it to GitHub Discussions for historical record.
8+
Use with: /aw-report [--deep] [--no-post] [--domains domain1,domain2]
9+
tools:
10+
- WebSearch
11+
- WebFetch
12+
- Write
13+
- Bash
14+
- Read
15+
---
16+
17+
Run the `gh-aw-report` skill to produce today's GitHub Agentic Workflows intelligence report.
18+
19+
## Flags
20+
21+
Parse the argument string for these optional flags:
22+
23+
- `--deep` — Run additional deep-dive queries from the extended query library beyond the 8 primary searches
24+
- `--no-post` — Skip posting to GitHub Discussions (still saves report locally and updates knowledge base)
25+
- `--domains` — Comma-separated list of domains to sweep. Valid: `gh-aw`, `actions`, `workspace`, `agent-mode`, `models`, `mcp-server`, `claude-code`, `community`
26+
27+
## Steps
28+
29+
1. Load the gh-aw-report skill by reading `skills/gh-aw-report/SKILL.md`.
30+
2. Follow the skill's instructions exactly — perform all 8 required web searches (or filtered if `--domains` specified), synthesize findings, and produce the full structured report.
31+
3. If `--deep` is passed, run additional deep-dive queries from `skills/gh-aw-report/references/search-queries.md`.
32+
4. Save the report to `outputs/gh-aw-reports/YYYY-MM-DD.md` (today's date).
33+
5. Update the knowledge base at `skills/gh-aw-report/knowledge-base.md`.
34+
6. Unless `--no-post`, post the report to GitHub Discussions in the `Project News` category at `zircote/github-agentic-workflows` using the GraphQL API (see skill Phase 6).
35+
7. Present the saved report link, discussion URL, and a 3-sentence summary of the most important findings.
36+
37+
Do not produce placeholder content. Every section must reflect real search results from today's run.

‎.claude/commands/aw-status.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: aw-status
3+
description: >
4+
Summarize the current state of the GitHub Agentic Workflows ecosystem from the
5+
persistent knowledge base. Provides a quick briefing without running new web
6+
searches. Use with: /aw-status [--domain domain] [--since YYYY-MM-DD]
7+
tools:
8+
- Read
9+
---
10+
11+
Read the knowledge base at `skills/gh-aw-report/knowledge-base.md`
12+
and provide a concise status briefing covering:
13+
14+
## Flags
15+
16+
Parse the argument string for these optional flags:
17+
18+
- `--domain` — Focus the briefing on a specific domain: `gh-aw`, `actions`, `workspace`, `agent-mode`, `models`, `mcp-server`, `claude-code`, `community`
19+
- `--since` — Only include knowledge base entries from this date forward
20+
21+
## Briefing Format
22+
23+
1. **Current versions & GA status** — gh-aw CLI, Copilot CLI, Copilot Workspace, GitHub MCP Server
24+
2. **Active deprecations & breaking changes** — what needs migration now
25+
3. **Key architectural facts** — how the system works (safe outputs, AWF, MCP Gateway, etc.)
26+
4. **Last report date** — when the knowledge base was last updated
27+
5. **Recommended immediate actions** — top 2–3 things a practitioner should do right now
28+
29+
Keep the briefing to 300–400 words. If the knowledge base has not been updated in more
30+
than 3 days, note this and recommend running `/aw-report` to refresh.
31+
32+
Entries marked `[SUPERSEDED]` should be excluded from the briefing.

‎.claude/skills/aw-daily/SKILL.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
name: aw-daily
3+
description: >
4+
Fully autonomous daily pipeline for the aw-author plugin. Executes intelligence
5+
research (web search + GitHub activity queries), posts to Discussions, performs
6+
gap analysis against reference files, creates issues, implements changes on
7+
develop branch, creates PR, requests review, and auto-merges.
8+
---
9+
10+
Load and follow the instructions in `skills/aw-daily/SKILL.md` exactly.
11+
12+
This is the Claude Code mirror of the main skill. The full 9-phase pipeline
13+
(Pre-flight → Research → KB Update → Discussion → Gap Analysis → Issues →
14+
Implementation → PR → Review & Merge) is defined in the main skill file.
15+
16+
Parse flags from arguments: `--dry-run`, `--skip-research`, `--skip-implementation`, `--no-merge`.

0 commit comments

Comments
 (0)