Skip to content

docs: add custom agent prerequisites, preflight pattern, and tool-unavailable fallback#43913

Closed
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/agent-persona-exploration-2026-07-06
Closed

docs: add custom agent prerequisites, preflight pattern, and tool-unavailable fallback#43913
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/agent-persona-exploration-2026-07-06

Conversation

Copilot AI commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

The Agent Persona Explorer workflow measured tooling availability rather than recommendation quality when the Copilot CLI was missing — there was no documented path for this failure mode and no standard way to record tool-unavailable outcomes comparably across runs.

.github/aw/github-agentic-workflows.md

  • New Custom Agent Tool Prerequisites section: Copilot CLI requirement, failure-mode table (Copilot CLI not installed, timeout, empty response), and a four-step tool-unavailable fallback pattern (record structured outcome, derive inferred recommendation from reference files, publish a Tooling Availability section)

.github/aw/create-agentic-workflow.md

  • New Preflight Check for Custom Agent Runtimes subsection in Ad Hoc Evaluation Mode: probe → success → proceed; probe → failure → record, switch to inferred reasoning, always publish; cross-references the prerequisites doc

.github/workflows/agent-persona-explorer.md

  • Phase 3 now opens with a mandatory availability probe ("Are you available?") before running any scenario
  • On probe failure: records { "status": "tool-unavailable", "reason": "..." }, derives inferred recommendations from .github/aw/*.md, skips agent invocations, sets quality score to N/A
  • Phase 5 report template gains a ### Tooling Availability field so tool-unavailable runs are structurally comparable to normal runs

Copilot AI linked an issue Jul 7, 2026 that may be closed by this pull request
Copilot AI and others added 2 commits July 7, 2026 02:53
…vailable fallback

- github-agentic-workflows.md: add Custom Agent Tool Prerequisites section
  documenting prerequisites (Copilot CLI), failure modes table, and the
  tool-unavailable fallback pattern with explicit outcome recording
- create-agentic-workflow.md: add Preflight Check for Custom Agent Runtimes
  subsection inside Ad Hoc Evaluation Mode with probe/success/failure steps
  and a cross-reference to the prerequisites doc
- agent-persona-explorer.md: add preflight probe step before Phase 3 scenarios
  and a Tooling Availability field to the Phase 5 report template; recompile
  lock file

Closes #43828

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Investigate agent persona exploration findings docs: add custom agent prerequisites, preflight pattern, and tool-unavailable fallback Jul 7, 2026
Copilot AI requested a review from pelikhan July 7, 2026 02:54
@pelikhan pelikhan closed this Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent Persona Exploration - 2026-07-06

2 participants