Designer Drift Report — 2026-10-05
Summary
Found 6 grouped drift items across 6 audit categories. The designer playbook already delegates to current mapping/reference files, but several mappings and optional-field choices are missing; the standalone agent lacks equivalent routing.
Drift Items
View Drift Items by Category
Missing Trigger Mappings
- Source:
.github/aw/triggers.md (standard events, command event identifiers, semi-active example).
- Missing from: Both — playbook's
.github/aw/designer-mappings.md and agent file.
- Details: The mapping table has no direct
push or issue_comment mapping. Its generic slash-command row does not explain issue_comment, pull_request_comment, and pull_request_review_comment event scoping. The agent's frontmatter list only names issues, pull requests, schedules, and manual dispatch, with no link to the full trigger guidance.
- Suggested fix: Add push/comment mappings and command event-scoping guidance; route the agent to the shared trigger table. Keep
pull_request_comment explicitly identified as a command-scoping identifier, not a standalone Actions event.
Missing Safe Output Mappings
- Source:
.github/aw/safe-outputs.md, its content/automation references, and /tmp/gh-aw/data/all-safe-output-types.txt; corroborated with pkg/workflow/safe_output_handlers.go and pkg/workflow/js/safe_outputs_tools.json.
- Missing from: Both.
- Details: Missing mappings for
call-workflow, approve-workflow-run, ado-upload-workitem-attachment, and upload-code-coverage. Registered tools ledger_append and ledger_request_compaction also lack a designer route explaining their tools.ledger configuration. The standalone agent only gives three output examples and does not reference the complete mapping.
- Suggested fix: Add intent-to-output rows for reusable workflow fan-out, pending-run approval, work-item attachments, and coverage publishing; add a ledger guidance route. Preserve the distinction between configuration keys and runtime tool names. Existing
repo-memory guidance covers push_repo_memory; this is not a missing output.
Network Identifier Coverage
- Source:
.github/aw/network.md (ecosystem identifiers and engine domain sets).
- Missing from: Both, at the mapping/guidance level.
- Details: Common ecosystems and all listed less-common package ecosystems are covered directly or by an explicit reference. However,
copilot-vendor, copilot, claude, codex, gemini, pi, pi-base, and threat-detection have no explicit mapping or engine-domain explanation. The standalone agent supplies no ecosystem mapping or reference route.
- Suggested fix: Add a compact route to the engine-domain section explaining automatic engine transport and the compatibility alias; do not indiscriminately add these identifiers to generated allowlists. Have the agent use the same network guidance.
Optional Frontmatter Coverage
- Source:
.github/aw/syntax.md → syntax-core.md and syntax-agentic.md.
- Missing from: Both.
- Details: The generation template and interview omit explicit selection guidance for
model, max-turns, max-ai-credits, max-daily-ai-credits, max-turn-cache-misses, models, and user-rate-limit. Runner choices such as runs-on-slim/runner and the pre-agent-steps hook also have no template guidance. The agent's abbreviated frontmatter list does not cover these fields. Their introduction dates cannot be established from the supplied history.
- Suggested fix: Add optional decision guidance for budgets, model policies, rate limits, runner requirements, and setup timing, linked to the canonical syntax pages. Keep default-valued and irrelevant fields omitted; this is a discoverability gap, not proof that the minimal skeleton is invalid.
Pattern and Optimization Routing
- Source:
.github/aw/patterns.md, .github/aw/subagents.md, .github/aw/token-optimization.md, and .github/aw/create-agentic-workflow.md.
- Missing from: Agent file only.
- Details: The playbook's shared table covers all 20 named patterns. The standalone
.github/agents/interactive-agent-designer.agent.md neither names those patterns nor routes to the pattern/playbook references. Its optimization guidance stops at concision and cache memory, without the playbook's DataOps, gh-proxy, and smaller-model sub-agent guidance.
- Suggested fix: Route workflow design/configuration requests from the agent to
designer.md, designer-mappings.md, and the creation guide, including their pattern and optimization references, instead of maintaining a separate abbreviated knowledge surface.
Stale Field Placement Guidance
- Source:
.github/aw/syntax.md → syntax-agentic.md (memory fields), corroborated by .github/aw/memory.md.
- Missing from: Agent file (correct nesting guidance).
- Details: The agent's “For Workflow Configuration (Frontmatter)” section lists
cache-memory: alongside top-level fields without stating that it belongs under tools:; its optimization section repeats the bare field. Current syntax explicitly places it under tools. No removed documentation path was established.
- Suggested fix: Write
tools.cache-memory explicitly and reference the memory guide, avoiding a generated top-level cache-memory field.
No Drift
- ✅ Supported GitHub tool modes in the shared mapping:
gh-proxy, local, and tools.cli-proxy are represented. The discouraged remote mode is not recommended.
- ✅ Playbook pattern coverage: all 20 named patterns have shared-table recommendations.
- ✅ Common and less-common package ecosystem guidance is present in the shared mapping.
- ✅ The playbook template includes
skills, plugins, lsp, evals, and intent.
- ✅ Recent changes without sync: not established by the supplied histories; both list the same commit,
a5e1584. This is a history-level pass, not proof of semantic synchronization.
Methodology
Compared outlines of 8 reference docs against both designer files.
Reference doc commits (last 7 days): 1
Designer file commits (last 7 days): 1
Followed the playbook's explicit delegation to .github/aw/designer-mappings.md and inspected targeted local reference sections to verify apparent omissions. The supplied “SKILL.md” outline matches .github/aw/designer.md; findings use that actual path. Filtered parameter names and schema fragments out of the supplied safe-output inventory and checked runtime/configuration aliases. Commit counts reflect the supplied files only.
Next Actions
Update the shared mappings and optional-field guidance, then route the standalone agent through those references. Re-run the audit after synchronization; no repository files were changed during this audit.
Generated by 🔍 Designer Drift Audit · codex · gpt60 · 94.5 AIC · ⌖ 28 AIC · ⊞ 15.7K · ◷
Designer Drift Report — 2026-10-05
Summary
Found 6 grouped drift items across 6 audit categories. The designer playbook already delegates to current mapping/reference files, but several mappings and optional-field choices are missing; the standalone agent lacks equivalent routing.
Drift Items
View Drift Items by Category
Missing Trigger Mappings
.github/aw/triggers.md(standard events, command event identifiers, semi-active example)..github/aw/designer-mappings.mdand agent file.pushorissue_commentmapping. Its generic slash-command row does not explainissue_comment,pull_request_comment, andpull_request_review_commentevent scoping. The agent's frontmatter list only names issues, pull requests, schedules, and manual dispatch, with no link to the full trigger guidance.pull_request_commentexplicitly identified as a command-scoping identifier, not a standalone Actions event.Missing Safe Output Mappings
.github/aw/safe-outputs.md, its content/automation references, and/tmp/gh-aw/data/all-safe-output-types.txt; corroborated withpkg/workflow/safe_output_handlers.goandpkg/workflow/js/safe_outputs_tools.json.call-workflow,approve-workflow-run,ado-upload-workitem-attachment, andupload-code-coverage. Registered toolsledger_appendandledger_request_compactionalso lack a designer route explaining theirtools.ledgerconfiguration. The standalone agent only gives three output examples and does not reference the complete mapping.repo-memoryguidance coverspush_repo_memory; this is not a missing output.Network Identifier Coverage
.github/aw/network.md(ecosystem identifiers and engine domain sets).copilot-vendor,copilot,claude,codex,gemini,pi,pi-base, andthreat-detectionhave no explicit mapping or engine-domain explanation. The standalone agent supplies no ecosystem mapping or reference route.Optional Frontmatter Coverage
.github/aw/syntax.md→syntax-core.mdandsyntax-agentic.md.model,max-turns,max-ai-credits,max-daily-ai-credits,max-turn-cache-misses,models, anduser-rate-limit. Runner choices such asruns-on-slim/runnerand thepre-agent-stepshook also have no template guidance. The agent's abbreviated frontmatter list does not cover these fields. Their introduction dates cannot be established from the supplied history.Pattern and Optimization Routing
.github/aw/patterns.md,.github/aw/subagents.md,.github/aw/token-optimization.md, and.github/aw/create-agentic-workflow.md..github/agents/interactive-agent-designer.agent.mdneither names those patterns nor routes to the pattern/playbook references. Its optimization guidance stops at concision and cache memory, without the playbook's DataOps, gh-proxy, and smaller-model sub-agent guidance.designer.md,designer-mappings.md, and the creation guide, including their pattern and optimization references, instead of maintaining a separate abbreviated knowledge surface.Stale Field Placement Guidance
.github/aw/syntax.md→syntax-agentic.md(memory fields), corroborated by.github/aw/memory.md.cache-memory:alongside top-level fields without stating that it belongs undertools:; its optimization section repeats the bare field. Current syntax explicitly places it undertools. No removed documentation path was established.tools.cache-memoryexplicitly and reference the memory guide, avoiding a generated top-levelcache-memoryfield.No Drift
gh-proxy,local, andtools.cli-proxyare represented. The discouragedremotemode is not recommended.skills,plugins,lsp,evals, andintent.a5e1584. This is a history-level pass, not proof of semantic synchronization.Methodology
Compared outlines of 8 reference docs against both designer files.
Reference doc commits (last 7 days): 1
Designer file commits (last 7 days): 1
Followed the playbook's explicit delegation to
.github/aw/designer-mappings.mdand inspected targeted local reference sections to verify apparent omissions. The supplied “SKILL.md” outline matches.github/aw/designer.md; findings use that actual path. Filtered parameter names and schema fragments out of the supplied safe-output inventory and checked runtime/configuration aliases. Commit counts reflect the supplied files only.Next Actions
Update the shared mappings and optional-field guidance, then route the standalone agent through those references. Re-run the audit after synchronization; no repository files were changed during this audit.