Skip to content

Commit 34c82b5

Browse files
committed
fix: populate root knowledge base with bootstrap data
The root skills/gh-aw-report/knowledge-base.md was an empty template while the .claude/ version had populated bootstrap data. The gh-aw workflow runs on GitHub Actions and reads from the repo root, not .claude/, so the root copy must contain the actual knowledge base entries.
1 parent 0752dad commit 34c82b5

1 file changed

Lines changed: 81 additions & 14 deletions

File tree

Lines changed: 81 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,88 @@
1-
# gh-aw Ecosystem Knowledge Base
1+
# gh-aw Knowledge Base
22

3-
> Persistent, append-only log of stable facts about the GitHub Agentic Workflows ecosystem.
4-
> Updated by `/aw-report` runs. Each entry is timestamped and categorized.
5-
> Do NOT delete entries — mark superseded facts with `[SUPERSEDED by YYYY-MM-DD]`.
3+
> Persistent cross-session facts about the GitHub Agentic Workflows ecosystem.
4+
> Updated by each run of the gh-aw-report skill. Entries are dated and append-only.
5+
> Do not remove entries — mark superseded information with `[SUPERSEDED by YYYY-MM-DD]`.
66
7-
## Format
7+
---
88

9-
Each entry follows:
10-
```
11-
### YYYY-MM-DD — Category — Title
12-
Content
13-
```
9+
## [2026-04-14] Bootstrap Entry — Initial Research
1410

15-
Categories: `version`, `deprecation`, `breaking-change`, `architecture`, `ecosystem`, `security`, `feature`
11+
### gh-aw CLI
12+
- **Technical preview launched**: February 13, 2026
13+
- **Core repo**: `github/gh-aw` (github.com/github/gh-aw)
14+
- **Docs**: github.github.com/gh-aw/
15+
- **GitHub Next page**: githubnext.com/projects/agentic-workflows/
16+
- **Default agent**: GitHub Copilot CLI
17+
- **Alternative agents**: Claude (Anthropic), Codex (OpenAI)
18+
- **Key CLI commands**: `gh aw compile`, `gh aw run`, `gh aw fix --write`, `gh aw upgrade`
19+
- **Issue #10193**: Intermittent Daily News workflow failures (~40% success rate, flagged Feb 2026)
20+
- **MCP updates tracked in gh-aw**: Issue #20042 tracks GitHub MCP Server v0.31.0→v0.32.0 and MCP Gateway v0.1.8→v0.1.9
1621

17-
---
22+
### Breaking Changes / Deprecations ACTIVE as of 2026-04-14
23+
| Item | Status | Migration | Date |
24+
|------|--------|-----------|------|
25+
| `plugins:` frontmatter field | **DEPRECATED** | Use `dependencies:` field; run `gh aw fix --write` | Early 2026 |
26+
| npm `@modelcontextprotocol/server-github` | **DEPRECATED** | Use Docker or HTTP GitHub MCP Server | April 2025 |
27+
| actions/cache v1-v2 | **REMOVED** | Use v3 or v4 | March 2025 |
28+
| Workflow prompt files managed by CLI | **CHANGED** | Files now resolved from gh-aw repo directly | 2026 |
29+
30+
### GitHub Actions (as of 2026-04-14)
31+
- Immutable Actions in general use for hosted runners
32+
- Self-hosted runners must allow `pkg.actions.githubusercontent.com`
33+
- Pricing backlash/changes tracked at samexpert.com (check for current state)
34+
35+
### GitHub MCP Server (as of 2026-04-14)
36+
- **Official repo**: `github/github-mcp-server`
37+
- **Container**: `ghcr.io/github/github-mcp-server`
38+
- ~~npm `@modelcontextprotocol/server-github`~~ DEPRECATED April 2025
39+
- **Insiders mode**: opt-in via `/insiders` URL or config header for experimental features
40+
- **HTTP mode**: enterprise deployment with per-request OAuth token support
41+
- **Projects toolset**: consolidated — saves ~23,000 tokens (~50% reduction)
42+
- **New tools**: `get_copilot_job_status`, `assign_copilot_to_issue`, `create_pull_request_with_copilot`
43+
- **`base_ref` parameter**: added to Copilot PR tools for stacked PRs / feature branches
44+
- **Changelog entry**: 2026-01-28 — New Projects tools, OAuth scope filtering
45+
46+
### GitHub Copilot CLI (as of 2026-04-14)
47+
- **GA date**: February 25, 2026 (after ~5 months of public preview from September 2025)
48+
- **Available to**: All paid Copilot subscribers (Pro, Business, Enterprise)
49+
- **Modes**: Plan mode (shows plan first), Autopilot mode (fully autonomous)
50+
- **Background delegation**: prefix prompt with `&` to send to cloud coding agent
51+
- **Sub-agents**: Explore (codebase analysis), Task (build/test), Code Review, Plan
52+
- **Models**: Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.3-Codex, Gemini 3 Pro
53+
- **January 2026 changelog**: Enhanced agents, context management, new install methods
1854

19-
## Entries
55+
### GitHub Copilot Workspace / Agent Mode (as of 2026-04-14)
56+
- **JetBrains GA**: March 11, 2026 (VS Code was earlier)
57+
- **Waitlist removed**: Pro, Business, Enterprise — early 2026
58+
- **Agentic code review GA**: March 2026 — full context → suggestions → auto-spawn fix PR
59+
- **Issue assignment**: Assign GitHub issue to Copilot → autonomous PR creation
60+
- **Instruction files read**: `CLAUDE.md`, `AGENTS.md`, `COPILOT.md`, custom instruction files, workspace and global scope
61+
- **Custom agents GA** (+ plan agent, sub-agents): GA; **agent hooks**: preview; **auto-approve MCP**: supported
62+
- **April 2026 changelog**: Copilot in Visual Studio — March update (released 2026-04-02)
2063

21-
<!-- New entries are appended above this line by the gh-aw-report skill -->
64+
### Claude Code / Anthropic GitHub Integration (as of 2026-04-14)
65+
- GitHub MCP Server installation guide for Claude: `github/github-mcp-server/docs/installation-guides/install-claude.md`
66+
- Claude Code connects to GitHub MCP Server via `claude mcp add-json github` (HTTP) or Docker
67+
- `steipete/claude-code-mcp`: Claude Code as a one-shot MCP server ("agent in your agent")
68+
- Copilot natively reads `CLAUDE.md` instruction files in agentic workflows
69+
- Claude can serve as the AI agent in gh-aw workflows (alternative to Copilot CLI)
70+
71+
### Community / Ecosystem (as of 2026-04-14)
72+
- `githubnext/awesome-continuous-ai`: Curated list of Continuous AI actions and frameworks
73+
- `githubnext/agentics`: Sample pack of gh-aw workflows (community starter kit)
74+
- `0GiS0/github-agentic-workflows`: Community implementation with Daily Status Report bot
75+
- HN thread on gh-aw preview: news.ycombinator.com/item?id=46934107
76+
- GitHub blog post: "Continuous AI in practice: What developers can automate today"
77+
- InfoQ coverage: "GitHub Agentic Workflows Unleash AI-Driven Repository Automation" (Feb 2026)
78+
- April 2026: GitHub integrates AI for accessibility issue management and feedback triage
79+
80+
### Architecture Notes (stable)
81+
- gh-aw is NOT a replacement for deterministic CI/CD — it augments it ("Continuous AI")
82+
- Workflows run in isolated containers with read-only repo access by default
83+
- AWF (Agent Workflow Firewall) restricts network egress
84+
- Safe Outputs subsystem handles write operations in separate permission-controlled jobs
85+
- Threat detection job runs per-workflow: prompt injection, credential leaks, malicious code
86+
87+
---
88+
<!-- Append new entries above this line, newest first -->

0 commit comments

Comments
 (0)