Skip to content

Commit 96b5b99

Browse files
github-actions[bot]zircoteCopilot
authored
docs(references): daily intelligence update 2026-04-18 (#44)
* chore: bump plugin version to 1.3.1 * refactor: move skills and commands to .claude/ layout, add Copilot issue assignment Relocate aw-daily, gh-aw-report skills and all commands from top-level directories to .claude/skills/ and .claude/commands/ per correct plugin layout. Update all internal path references across workflow, SKILL.md files, and CLAUDE.md. Add assign-to-agent safe-output to daily-intelligence workflow so issues created in Phase 5 are automatically assigned to Copilot for implementation. * docs(references): daily intelligence update 2026-04-18 - Update gh-aw-architecture.md: MCP Gateway v0.1.9 → v0.2.24 - Add AWF version v0.25.24 to gh-aw-architecture.md - Add SideRepoOps context (workflowRepo/eventRepo) to architecture - Add resolved 'Redact secrets in logs' gotcha to production-gotchas.md - Add set_issue_fields, resolve_review_thread tools to tools-reference.md - Add copilot, pull_request_granular, issues_granular toolsets to tools-reference.md - Add list_commits path/since/until parameters to tools-reference.md - Update knowledge-base.md with 2026-04-18 findings - Add intelligence report outputs/gh-aw-reports/2026-04-18.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Robert Allen <zircote@gmail.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent b558aac commit 96b5b99

25 files changed

Lines changed: 1088 additions & 1646 deletions

File tree

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

Lines changed: 33 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,43 @@
11
---
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
2+
description: Fully autonomous daily intelligence, gap analysis, implementation, and PR cycle
3+
argument-hint: "[--dry-run] [--skip-research] [--skip-implementation] [--no-merge]"
144
---
155

16-
Run the `aw-daily` skill to execute the full daily intelligence and update pipeline.
6+
# /aw-daily
7+
8+
Fully autonomous daily pipeline: research the gh-aw ecosystem, post to Discussions, analyze gaps in reference files, implement fixes, create PR to `develop`, review, and merge. Designed for unattended execution.
9+
10+
## Usage
11+
12+
```
13+
/aw-daily → Full autonomous cycle
14+
/aw-daily --dry-run → Research + gap analysis only, show diff, no commit
15+
/aw-daily --skip-research → Start at gap analysis using latest report
16+
/aw-daily --skip-implementation → Research + gap analysis + issues only, no file edits
17+
/aw-daily --no-merge → Create PR but do not auto-merge
18+
```
1719

1820
## Flags
1921

20-
Parse the argument string for these optional flags:
22+
- `--dry-run` — Run research and gap analysis, show what would change, do not commit or create PR
23+
- `--skip-research` — Skip intelligence sweep, start at gap analysis using the most recent report in `outputs/gh-aw-reports/`
24+
- `--skip-implementation` — Run research, gap analysis, and issue creation, but do not edit files or create PR
25+
- `--no-merge` — Create PR but do not auto-merge to `develop`
26+
27+
## Workflow
2128

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
29+
You are an autonomous operations agent performing the daily intelligence and update cycle. Execute all phases without user prompting.
2630

27-
## Steps
31+
**Do not prompt the user for input at any point.** This command is designed for scheduled unattended execution.
2832

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+
Load the **aw-daily** skill and execute all phases. The skill handles:
3334

34-
This command is designed for scheduled unattended execution.
35+
1. Pre-flight checks and idempotency
36+
2. Intelligence sweep (8 web searches + GitHub activity queries on tracked repos)
37+
3. Knowledge base update
38+
4. Discussion posting to `project-news` category
39+
5. Gap analysis against reference files
40+
6. Issue creation for identified gaps
41+
7. Implementation on feature branch from `develop`
42+
8. PR creation to `develop`
43+
9. Review and auto-merge

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

Lines changed: 94 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,99 @@
11
---
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
2+
description: Merge develop branch to main with PR, CI check, and squash merge
3+
argument-hint: "[--dry-run] [--no-reset]"
94
---
105

11-
Merge `develop` into `main` via PR.
6+
# /aw-merge
127

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
8+
Weekly merge of `develop` into `main`. Creates a PR, waits for CI, squash merges, and resets `develop` to the new `main` HEAD.
189

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.
10+
## Usage
11+
12+
```
13+
/aw-merge → Full merge cycle
14+
/aw-merge --dry-run → Show what would be merged, do not create PR
15+
/aw-merge --no-reset → Merge but do not reset develop to main after
16+
```
17+
18+
## Flags
19+
20+
- `--dry-run` — Show commits on `develop` ahead of `main`, do not create PR or merge
21+
- `--no-reset` — After merge, do not reset `develop` to `main` HEAD (preserves divergent history)
22+
23+
## Workflow
24+
25+
You are an autonomous operations agent performing the weekly develop-to-main merge.
26+
27+
**Do not prompt the user for input at any point.**
28+
29+
### Phase 1: Check divergence
30+
31+
```bash
32+
git fetch origin main develop
33+
AHEAD=$(git rev-list --count origin/main..origin/develop)
34+
```
35+
36+
If `AHEAD` is 0: report "develop is up to date with main. Nothing to merge." and **exit**.
37+
38+
If `--dry-run`: show `git log --oneline origin/main..origin/develop` and **exit**.
39+
40+
### Phase 2: Create PR
41+
42+
```bash
43+
gh pr create \
44+
--draft \
45+
--repo zircote/github-agentic-workflows \
46+
--base main \
47+
--head develop \
48+
--title "chore: weekly develop merge $(date +%Y-%m-%d)" \
49+
--body "## Summary
50+
51+
Weekly merge of \`develop\` into \`main\`.
52+
53+
**Commits:** $AHEAD commits since last merge.
54+
55+
\`\`\`
56+
$(git log --oneline origin/main..origin/develop)
57+
\`\`\`
58+
59+
---
60+
_Automated by /aw-merge_"
61+
```
62+
63+
Mark PR ready:
64+
```bash
65+
gh pr ready <PR_NUMBER>
66+
```
67+
68+
### Phase 3: CI and merge
69+
70+
1. Wait for CI checks: poll `gh pr checks` every 15 seconds, max 5 minutes
71+
2. If CI passes (or no checks configured): squash merge
72+
```bash
73+
gh pr merge --squash --auto --delete-branch=false
74+
```
75+
3. If CI fails: leave PR open, report URL
76+
77+
### Phase 4: Reset develop (unless `--no-reset`)
78+
79+
After successful merge, reset `develop` to match `main`:
80+
```bash
81+
git checkout develop
82+
git reset --hard origin/main
83+
git push --force-with-lease origin develop
84+
git checkout main
85+
git pull
86+
```
87+
88+
### Final Report
89+
90+
```
91+
┌──────────────────────────────────────────┐
92+
│ /aw-merge complete │
93+
├──────────────────────────────────────────┤
94+
│ Commits merged: N │
95+
│ PR: URL │
96+
│ Merged: yes/no │
97+
│ develop reset: yes/no/skipped │
98+
└──────────────────────────────────────────┘
99+
```

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

Lines changed: 42 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,53 @@
11
---
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
2+
description: Run a full gh-aw ecosystem intelligence sweep and produce a dated report
3+
argument-hint: "[--deep] [--no-post] [--domains domain1,domain2]"
154
---
165

17-
Run the `gh-aw-report` skill to produce today's GitHub Agentic Workflows intelligence report.
6+
# /aw-report
187

19-
## Flags
8+
Runs a full intelligence sweep across the GitHub Agentic Workflows ecosystem — 8+ web searches — 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.
9+
10+
## Usage
2011

21-
Parse the argument string for these optional flags:
12+
```
13+
/aw-report → Full sweep, all domains, post to Discussions
14+
/aw-report --deep → Extended sweep with deep-dive queries
15+
/aw-report --no-post → Generate report without posting to Discussions
16+
/aw-report --domains gh-aw,mcp → Only sweep specified domains
17+
```
18+
19+
## Flags
2220

2321
- `--deep` — Run additional deep-dive queries from the extended query library beyond the 8 primary searches
2422
- `--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`
23+
- `--domains` — Comma-separated list of domains to sweep. Valid domains: `gh-aw`, `actions`, `workspace`, `agent-mode`, `models`, `mcp-server`, `claude-code`, `community`
24+
25+
## Workflow
26+
27+
You are an intelligence analyst for the gh-aw ecosystem. Load the **gh-aw-report** skill to execute the full intelligence cycle:
28+
29+
1. Load context from the knowledge base and architecture reference
30+
2. Execute the primary sweep (8 targeted web searches)
31+
3. If `--deep` is passed, run additional deep-dive queries
32+
4. If `--domains` is passed, filter to only the specified domains
33+
5. Synthesize findings into a structured report
34+
6. Save the report to `outputs/gh-aw-reports/YYYY-MM-DD.md`
35+
7. Update the knowledge base with stable facts
36+
8. Unless `--no-post`, post the report to GitHub Discussions in the `project-news` category at `zircote/github-agentic-workflows`
37+
9. Print the final summary
38+
39+
## Examples
40+
41+
```
42+
/aw-report
43+
# → Full sweep, saves report, updates KB, posts to Discussions
2644
27-
## Steps
45+
/aw-report --deep
46+
# → Extended sweep with deep-dive queries on rich domains
2847
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.
48+
/aw-report --no-post --domains gh-aw,mcp-server
49+
# → Only sweep gh-aw core and MCP server, skip Discussions post
3650
37-
Do not produce placeholder content. Every section must reflect real search results from today's run.
51+
/aw-report --deep --domains claude-code
52+
# → Deep dive on Claude Code × GitHub integrations only
53+
```

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

Lines changed: 48 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,60 @@
11
---
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
2+
description: Quick briefing on current gh-aw ecosystem state from the knowledge base
3+
argument-hint: "[--domain domain] [--since YYYY-MM-DD]"
94
---
105

11-
Read the knowledge base at `skills/gh-aw-report/knowledge-base.md`
12-
and provide a concise status briefing covering:
6+
# /aw-status
137

14-
## Flags
8+
Reads the persistent knowledge base and delivers a quick 300–400 word briefing on the current state of the gh-aw ecosystem. No web searches needed — this is a fast, offline status check.
9+
10+
## Usage
11+
12+
```
13+
/aw-status → Full briefing across all domains
14+
/aw-status --domain gh-aw → Briefing focused on a specific domain
15+
/aw-status --since 2026-04-01 → Only entries since the given date
16+
```
1517

16-
Parse the argument string for these optional flags:
18+
## Flags
1719

1820
- `--domain` — Focus the briefing on a specific domain: `gh-aw`, `actions`, `workspace`, `agent-mode`, `models`, `mcp-server`, `claude-code`, `community`
1921
- `--since` — Only include knowledge base entries from this date forward
2022

21-
## Briefing Format
23+
## Workflow
24+
25+
You are a briefing analyst. Deliver a concise status report from the knowledge base.
26+
27+
1. Read the knowledge base at `skills/gh-aw-report/knowledge-base.md`
28+
2. Read `skills/gh-aw-report/references/gh-aw-architecture.md` for architecture context
29+
3. If `--domain` is passed, filter entries to the specified domain
30+
4. If `--since` is passed, filter entries to those dated on or after the given date
31+
5. Synthesize a 300–400 word briefing covering:
32+
33+
### Briefing Format
34+
35+
```
36+
## gh-aw Ecosystem Status — YYYY-MM-DD
37+
38+
### Current Versions
39+
- gh-aw CLI: vX.Y.Z
40+
- GitHub MCP Server: vX.Y.Z
41+
- [other tracked versions]
42+
43+
### Active Deprecations
44+
- [deprecation with timeline and migration path]
45+
46+
### Recent Changes (last 7 days)
47+
- [notable changes from knowledge base]
48+
49+
### Recommended Actions
50+
- [specific actions for workflow maintainers]
51+
```
2252

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
53+
6. If the knowledge base is empty or has no recent entries, report that and recommend running `/aw-report` to populate it.
2854

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.
55+
## Notes
3156

32-
Entries marked `[SUPERSEDED]` should be excluded from the briefing.
57+
- This command does NOT perform web searches — it reads only from the knowledge base
58+
- For fresh intelligence, run `/aw-report` first
59+
- The knowledge base is updated by each `/aw-report` run
60+
- Entries marked `[SUPERSEDED]` are excluded from the briefing

0 commit comments

Comments
 (0)