docs: changelog, lessons learned + re-add labels config

[microsasa]

Changes

1. Re-add labels: [aw] to implementer config

• Was removed weeks ago due to a vague "node ID resolution error" that was never investigated
• gh-aw docs confirm labels is officially supported (REST API, not node IDs)
• Labels now applied by infrastructure, not dependent on agent behavior
• Closes tracking: gh-aw create-pull-request labels config fails to apply labels #108

2. Documentation updates

• Changelog: entries for PR fix: pre-fetch review comments and allow astral.sh in responder #186 (pre-fetch), PR fix: prevent duplicate implementer dispatches #190 (dedup fix), quality gate label desync, labels config re-add
• Agentic-workflows: 5 new pitfalls ([aw][code health] Code quality bundle: toolRequests factory anti-pattern, model_token_map indirection, cost command date-filter duplication #23-27), updated agent inventory table, history entry for 2026-03-20/21
  • Pitfall [aw][code health] Code quality bundle: toolRequests factory anti-pattern, model_token_map indirection, cost command date-filter duplication #23: tools: block in shared imports restricts entire agent
  • Pitfall [aw][code health] Eliminate rendering duplication between render_summary and render_full_summary in report.py #24: gh run list --status only accepts single value
  • Pitfall [aw][code health] Duplicate table-rendering logic in report.py violates DRY #25: cancel-in-progress: true dangerous with side effects
  • Pitfall [aw][code health] Dead code, confusing default factory, inconsistent aggregation, and stale README structure #26: Quality gate label desyncs from approval state
  • Pitfall ci: add issue-implementer workflow with dispatch chaining #27: Shared imports use imports: + steps: pattern

[Copilot]

Pull request overview

This PR updates repo-level documentation (changelog + lessons learned) and restores infrastructure-managed aw labeling for implementer-created PRs via the gh-aw labels config.

Changes:

• Re-add labels: [aw] to the create-pull-request safe-output in the issue implementer workflow (and recompile the lock file).
• Add new “Common Pitfalls” entries and update agent inventory/history in docs/agentic-workflows.md.
• Add multiple new changelog entries describing recent workflow/infrastructure learnings and fixes.

Reviewed changes

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

File	Description
docs/changelog.md	Adds new changelog entries covering labels config, responder pre-fetch pattern, dispatch dedup, and quality gate label desync.
docs/agentic-workflows.md	Expands pitfalls list, updates agent inventory table, and appends history notes for recent incidents/fixes.
.github/workflows/issue-implementer.md	Restores labels: [aw] in safe-outputs.create-pull-request.
.github/workflows/issue-implementer.lock.yml	Regenerated lock file reflecting the labels config and updated compiled metadata.

Comments suppressed due to low confidence (1)

docs/agentic-workflows.md:509

• The "Common Pitfalls" section now flows directly into debugging commands (e.g., "Check if a workflow compiled correctly") without a "Debugging" header or a separate <details> block, which makes the section structure confusing (debugging content is effectively nested under pitfalls). Consider reintroducing a dedicated Debugging section (e.g., <details><summary>Debugging</summary> ... </details>) or at least add a clear heading break before the debugging commands.

### 27. Shared imports use `imports:` + `steps:` pattern
To pre-fetch data before the agent runs, create a shared `.md` file with a `steps:` block in the frontmatter. The importing workflow uses `imports: [shared/filename.md]`. The steps run as regular workflow steps (with full `gh` CLI access and `GITHUB_TOKEN`), writing data to `/tmp/gh-aw/` for the agent to read. This bypasses MCP tool limitations. Based on the pattern from `github/gh-aw`'s own `copilot-pr-data-fetch.md`.



### Check if a workflow compiled correctly
```bash
grep 'GH_AW_ALLOWED_BOTS\|GH_AW_REQUIRED_ROLES\|pre_activation' .github/workflows/your-workflow.lock.yml

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.