Skip to content

Docs: add persona pattern matrix, incident dedup-key templates, and design-token governance trigger guidance#43585

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

Docs: add persona pattern matrix, incident dedup-key templates, and design-token governance trigger guidance#43585
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/agent-persona-exploration-2026-07-05

Conversation

Copilot AI commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

This updates the agentic-workflow authoring guidance to incorporate findings from persona exploration: stronger persona-to-trigger mapping, clearer incident deduplication patterns, and more explicit design-token governance behavior. The goal is to make high-signal workflow design choices easier to apply consistently.

  • Persona guidance consolidation (.github/aw/github-agentic-workflows.md)

    • Added a compact Persona-to-Pattern Quick Matrix near the top of the doc.
    • Encodes preferred trigger/scope, read tools, write path, and explicit noop criteria for:
      • Backend Engineer
      • Frontend Developer
      • DevOps Engineer
  • Incident workflow dedup standardization (.github/aw/create-agentic-workflow.md)

    • Added a reusable section for incident dedup-key templates covering both:
      • workflow_run
      • deployment_status
    • Includes concrete key examples and normalization rules (error-signature, window-id, duplicate suppression, and noop handling).
  • Design-token governance pattern (.github/aw/triggers.md)

    • Added a dedicated PR-triggered design-token governance example.
    • Defines scoped paths, required reference validation (token registry/spec/source), output behavior (add-comment), and explicit noop conditions.
incident:workflow_run:<workflow-name>:<job-name-or-unknown>:<error-signature>:<window-id>
incident:deployment_status:<environment-or-ref>:<provider-or-target>:<error-signature>:<window-id>

Copilot AI linked an issue Jul 5, 2026 that may be closed by this pull request
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Explore agent persona insights and findings Docs: add persona pattern matrix, incident dedup-key templates, and design-token governance trigger guidance Jul 5, 2026
Copilot AI requested a review from pelikhan July 5, 2026 16:15
@pelikhan

pelikhan commented Jul 5, 2026

Copy link
Copy Markdown
Collaborator

@copilot refactor the section 2 into a compact decision table and a separate file with details to keep the instructions file smaller.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI commented Jul 5, 2026

Copy link
Copy Markdown
Contributor Author

@copilot refactor the section 2 into a compact decision table and a separate file with details to keep the instructions file smaller.

Addressed in afa5148c29.

Section 2 in .github/aw/create-agentic-workflow.md is now a compact decision table, and the moved detailed guidance is in .github/aw/create-agentic-workflow-trigger-details.md with links from the table.

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-05

2 participants