Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
50 commits
Select commit Hold shift + click to select a range
0e4b3da
fix(docs): update accessibility rules
Hristo313 Aug 28, 2026
e6c8c2b
Merge pull request #531 from IgniteUI/hhristov/update-skill-topic-acc…
Hristo313 Aug 28, 2026
9fa27fe
feat(grid-theming): add topics for theming each grid type
simeonoff Aug 31, 2026
9d6ce87
Merge branch 'vnext' into simeonoff/grid-styling-samples
simeonoff Aug 31, 2026
34497da
Merge pull request #536 from IgniteUI/simeonoff/grid-styling-samples
simeonoff Sep 1, 2026
95cddf2
jp-sync: sync grid theming topics with EN updates
github-actions[bot] Sep 1, 2026
9a9eada
review: apply native check fixes [R001/R005/R009/R011/R014/R018/R020-…
IG-Mori Sep 2, 2026
dff0fac
review: apply native check fixes [R016/R017/R030/R035/R040/R048/R055]
IG-Mori Sep 2, 2026
c619205
Merge pull request #538 from IgniteUI/jp-sync/grid-theming-topics-2f6…
IG-Mori Sep 3, 2026
39e8045
Merge pull request #522 from IgniteUI/mpopov/accesability-topics
desig9stein Sep 4, 2026
e2ad7b4
fix(chat): elaborate the bidirectionality of the messages array (#438)
ChronosSF Sep 8, 2026
b05d3b3
fix(links): update check relative links (#535)
dobromirts Sep 8, 2026
09ecc13
feat(button): update button topics (#491)
Hristo313 Sep 9, 2026
a0c4306
fix(aw): recompiling against latest (#555)
ChronosSF Sep 9, 2026
c3614d3
feat(): add qr-code docs
adrianptrv Sep 10, 2026
c39dd9d
Merge branch 'master' into vnext
ChronosSF Sep 15, 2026
5f68139
feat(switch): update switch topics (#546)
Hristo313 Sep 15, 2026
1780f11
[jp-sync] Replay failed Angular + xplat JP syncs for EN PRs #522, #43…
ChronosSF Sep 15, 2026
96f9553
feat(): qr-code article additions
adrianptrv Sep 15, 2026
f743914
Merge branch 'vnext' into apetrov/qr-code-docs
adrianptrv Sep 15, 2026
d771e7e
feat(qr-code): additional changes
adrianptrv Sep 17, 2026
ae98d21
feat(qr-code): add React and Blazor exclude
adrianptrv Sep 18, 2026
d676e08
fix(qr-code): angular build errors
adrianptrv Sep 18, 2026
d4366e8
[jp-sync] Sync switch topics translation (from #546) (#835)
github-actions[bot] Sep 18, 2026
4739a97
fix(qr-code): addressing comments
adrianptrv Sep 23, 2026
033de7f
fix(qr-code): minor improvements
adrianptrv Sep 23, 2026
610613b
fix(qr-code): align topic with component API, samples, and Angular TOC
simeonoff Sep 23, 2026
86a57f1
Merge branch 'vnext' into apetrov/qr-code-docs
simeonoff Sep 23, 2026
49fb726
lint(qr-code): use multi-line MDX comments to satisfy markdownlint
simeonoff Sep 23, 2026
043842d
fix(): sample sizes + toc order change
adrianptrv Sep 23, 2026
f02dd59
Add Virtual Scroll component topic (#840)
viktorkombov Sep 23, 2026
858de5b
Sync JP docs: Virtual Scroll component topic (Angular)
github-actions[bot] Sep 23, 2026
5c3afe7
[jp-sync] Add Japanese translation for Virtual Scroll component topic
github-actions[bot] Sep 23, 2026
cdcf994
docs(jp): align Virtual Scroll translation with existing terminology
jsakamotoIGJP Sep 24, 2026
dcfc210
Merge pull request #844 from IgniteUI/jp-sync/virtual-scroll-840-6c77…
jsakamotoIGJP Sep 24, 2026
c9c90c6
fix(): final adjustments
adrianptrv Sep 24, 2026
ced5bb8
Merge remote-tracking branch 'remotes/origin/vnext' into jp-sync/virt…
jsakamotoIGJP Sep 24, 2026
9c45088
docs(jp): fix mistranslations and untranslated text in combo topics
jsakamotoIGJP Sep 24, 2026
cdc55ac
Merge pull request #843 from IgniteUI/jp-sync/virtual-scroll-topic-c1…
jsakamotoIGJP Sep 24, 2026
89bc4ed
feat(*): updating astro components for new theme picker (#839)
ChronosSF Sep 24, 2026
cd82bb5
Merge branch 'vnext' into apetrov/qr-code-docs
simeonoff Sep 25, 2026
9b9806b
fix(ci): catch broken toc.json entries on every PR and after merges
dobromirts Sep 25, 2026
d76d6f0
chore(): fix tailwind code snippet
adrianptrv Sep 25, 2026
e0c49ec
Merge pull request #837 from IgniteUI/apetrov/qr-code-docs
simeonoff Sep 25, 2026
bf0c737
docs(angular): consolidate duplicate theming topics into themes/index…
simeonoff Sep 25, 2026
bc78c6f
Merge branch 'vnext' into dtsvetkov/toc-check-gaps
ChronosSF Sep 25, 2026
21bb22b
feat(*): updating astro and astro/mdx versions (#845)
ChronosSF Sep 25, 2026
92b3cfc
Merge branch 'vnext' into dtsvetkov/toc-check-gaps
ChronosSF Sep 25, 2026
4fafaf4
Merge pull request #856 from IgniteUI/dtsvetkov/toc-check-gaps
ChronosSF Sep 25, 2026
9a2385f
feat(docs): update accordion xplat topic (#446)
IMinchev64 Sep 25, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .ai/skills/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ including content-unchanged files, per the blog-creator convention).
| Change | File(s) |
|---|---|
| igniteui-topic-frontmatter split: SKILL.md becomes a router (scope, audit-first mode, task table, hard boundaries); the field checks + severity ladder move to `references/audit-rules.md`; report shape + apply procedure move to `references/report-format.md`. `description` unchanged (adapter byte-match preserved). | igniteui-topic-frontmatter/* |
| igniteui-doc-topics slimmed: SKILL.md keeps identity, two modes, compass, composite principle, task table, grounding boundaries. Create steps 1–7 (6a–6e) + the category/index structure move to `references/create-workflow.md`; the 5 audit-workflow steps move into `audit-rubric.md`. `description` unchanged. | igniteui-doc-topics/SKILL.md, references/create-workflow.md, references/audit-rubric.md |
| igniteui-doc-topics slimmed: SKILL.md keeps identity, two modes, compass, composite principle, task table, grounding boundaries. Create steps 1–7 (6a–6f) + the category/index structure move to `references/create-workflow.md`; the 5 audit-workflow steps move into `audit-rubric.md`. `description` unchanged. | igniteui-doc-topics/SKILL.md, references/create-workflow.md, references/audit-rubric.md |
| Accessibility generation is source-first: derive DOM, roles, ARIA, focus/state behavior, and keyboard actions from component templates and typed source; use event handlers only for interaction evidence and require official sources for conformance claims. | igniteui-doc-topics/references/house-style.md, references/create-workflow.md |
| Dedup (D2-03 stage 2): the section→mode map is no longer restated in SKILL.md — it is the "Diátaxis mode" column of house-style's canonical section table; SKILL.md keeps only the one-section-one-mode rule and the concrete mode-bleed examples. The category blueprint now lives in house-style + create-workflow only. Stale pointers fixed (house-style intro pointed at a SKILL.md map that moved; body-support bullet pointed at "Create workflow step 4" which now lives in create-workflow.md). | igniteui-doc-topics/SKILL.md, references/house-style.md |
| Set-level README.md added: human-readable intent, file map, authority chain, and the five-step update procedure (edit references not routers; uniform version bump; adapter byte-match; changelog entry; resolve ‹VERIFY› by pre-committed outcome). | README.md |
| Set-wide version line: every file now carries `Version: v3 · 2026-08-14 · igniteui doc-skill set`, including content-unchanged house-style and diataxis-cheatsheet (the cheatsheet gains its first version line). | all files |
Expand Down
6 changes: 6 additions & 0 deletions .ai/skills/igniteui-doc-topics/references/create-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,12 @@ mechanics, and the frontmatter contract live in `house-style.md`; run the rubric
matching Indigo.Design component documentation under
`https://www.infragistics.com/products/indigo-design/help/components/` and use its component
structure as input for Usage subsection suggestions.
For the Accessibility section, inspect the component template/render method and typed source
first: extract rendered native elements, `role`, `aria-*` attributes, focus and disabled
conditions, and validation/selection state mapping. Read keyboard and pointer event handlers to
derive interaction and state-change facts. Use the API registry to verify public property and
event names. Generate platform-specific differences with `<PlatformBlock>`, and mark unresolved
facts with `‹VERIFY: source fact needed›` rather than inferring them from generic HTML behavior.
4. **Scaffold frontmatter** — the metadata contract lives in `house-style.md` → "File format &
frontmatter"; this step orders the work, it does not restate the rules. Apply the contract to
every topic type, including category/index topics.
Expand Down
21 changes: 21 additions & 0 deletions .ai/skills/igniteui-doc-topics/references/house-style.md
Original file line number Diff line number Diff line change
Expand Up @@ -300,6 +300,27 @@ when its styling isn't shown as copyable code.
`## Accessibility` always carries three `###` sub-sections, in this order. All three are **reference**
mode: statements of fact in tables and short lists — no steps, no marketing.

#### Source-first generation contract

Generate the Accessibility section from the component implementation before writing prose. Inspect
the component template/render method and typed source for the rendered native elements, `role`,
`aria-*` attributes, focus/tab-order conditions, disabled handling, and indeterminate or validation
state mapping. Inspect keyboard and pointer event handlers to derive the key-to-action table and
state transitions. Inspect the public API registry to verify property and event names, then map each
fact to the platform that actually implements it.

- Treat rendered template/source as the authority for DOM, roles, ARIA attributes, and default state
behavior; treat the topic's existing prose as evidence to re-check, never as the source.
- Treat event handlers as evidence for interaction and state changes only. An event name does not
prove an accessible name, role, state, or WCAG conformance claim.
- For xplat topics, emit shared facts once and use `<PlatformBlock>` when Angular differs from the
Web Components implementation or its React/Blazor wrappers.
- Include only verified attributes, events, and state behavior. If source is unavailable or a fact
cannot be resolved, write `‹VERIFY: source fact needed›` or omit it; never infer ARIA behavior from
a component name or a generic HTML pattern.
- Derive the compliance table only from behavior verified in the section and an official product
accessibility statement. Do not generate blanket WCAG/Section 508 compliance claims.

1. **`### Keyboard Interaction`** — one key → action table, verified against the component's key
handlers. Note how the component is reached (Tab) and any condition that removes it from the tab
order.
Expand Down
2 changes: 1 addition & 1 deletion .gitattributes
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*.md text eol=lf
*.mdx text eol=lf

.github/workflows/*.lock.yml linguist-generated=true merge=ours
.github/workflows/*.lock.yml linguist-generated=true
233 changes: 233 additions & 0 deletions .github/agents/agentic-workflows.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,233 @@
---
name: Agentic Workflows
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
disable-model-invocation: true
---

# GitHub Agentic Workflows Agent

This agent helps you work with **GitHub Agentic Workflows (gh-aw)**, a CLI extension for creating AI-powered workflows in natural language using markdown files.

## Repository Instructions Overlay

If `.github/aw/instructions.md` exists, load it with:
@.github/aw/instructions.md

Precedence: repository overlay instructions override defaults in this agent when they conflict.

## What This Agent Does

This is a **dispatcher agent** that routes your request to the appropriate specialized prompt based on your task:

- **Creating new workflows**: Routes to `create` prompt
- **Updating existing workflows**: Routes to `update` prompt
- **Debugging workflows**: Routes to `debug` prompt
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
- **Creating report-generating workflows**: Routes to `report` prompt — consult this whenever the workflow posts status updates, audits, analyses, or any structured output as issues, discussions, or comments
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
- **Fixing Dependabot PRs**: Routes to `dependabot` prompt — use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes
- **Analyzing test coverage**: Routes to `test-coverage` prompt — consult this whenever the workflow reads, analyzes, or reports on test coverage data from PRs or CI runs
- **Rendering ASCII charts in markdown**: Routes to `asciicharts` guide — consult this whenever the workflow needs compact charts that render reliably in GitHub issues, comments, or discussions
- **CLI commands and triggering workflows**: Routes to `cli-commands` guide — consult this whenever the user asks how to run, compile, debug, or manage workflows from the command line, or when they need the MCP tool equivalent of a `gh aw` command
- **Reducing token consumption / cost optimization**: Routes to `token-optimization` guide — consult this whenever the user asks how to reduce token usage, lower costs, speed up workflows, or measure the impact of prompt changes with experiments
- **Choosing workflow architectures and design patterns**: Routes to `patterns` guide — consult this whenever the user asks for strategy, architecture, operating models, or pattern selection for agentic workflows

Workflows may optionally include:

- **Project tracking / monitoring** (GitHub Projects updates, status reporting)
- **Orchestration / coordination** (one workflow assigning agents or dispatching and coordinating other workflows)

## Files This Applies To

- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
- Workflow lock files: `.github/workflows/*.lock.yml`
- Shared components: `.github/workflows/shared/*.md`
- Configuration: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md`

## Problems This Solves

- **Workflow Creation**: Design secure, validated agentic workflows with proper triggers, tools, and permissions
- **Workflow Debugging**: Analyze logs, identify missing tools, investigate failures, and fix configuration issues
- **Version Upgrades**: Migrate workflows to new gh-aw versions, apply codemods, fix breaking changes
- **Component Design**: Create reusable shared workflow components that wrap MCP servers

## How to Use

When you interact with this agent, it will:

1. **Understand your intent** - Determine what kind of task you're trying to accomplish
2. **Route to the right prompt** - Load the specialized prompt file for your task
3. **Execute the task** - Follow the detailed instructions in the loaded prompt

## Available Prompts

> **Note**: The prompt and reference files listed below are located in the [`github/gh-aw`](https://github.com/github/gh-aw) repository and are **not available locally** in this repository. Load them from their public URLs.

### Create New Workflow
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-agentic-workflow.md`

**Use cases**:
- "Create a workflow that triages issues"
- "I need a workflow to label pull requests"
- "Design a weekly research automation"

### Update Existing Workflow
**Load when**: User wants to modify, improve, or refactor an existing workflow

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/update-agentic-workflow.md`

**Use cases**:
- "Add web-fetch tool to the issue-classifier workflow"
- "Update the PR reviewer to use discussions instead of issues"
- "Improve the prompt for the weekly-research workflow"

### Debug Workflow
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/debug-agentic-workflow.md`

**Use cases**:
- "Why is this workflow failing?"
- "Analyze the logs for workflow X"
- "Investigate missing tool calls in run #12345"

### Upgrade Agentic Workflows
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/upgrade-agentic-workflows.md`

**Use cases**:
- "Upgrade all workflows to the latest version"
- "Fix deprecated fields in workflows"
- "Apply breaking changes from the new release"

### Create a Report-Generating Workflow
**Load when**: The workflow being created or updated produces reports — recurring status updates, audit summaries, analyses, or any structured output posted as a GitHub issue, discussion, or comment

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/report.md`

**Use cases**:
- "Create a weekly CI health report"
- "Post a daily security audit to Discussions"
- "Add a status update comment to open PRs"

### Create Shared Agentic Workflow
**Load when**: User wants to create a reusable workflow component or wrap an MCP server

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-shared-agentic-workflow.md`

**Use cases**:
- "Create a shared component for Notion integration"
- "Wrap the Slack MCP server as a reusable component"
- "Design a shared workflow for database queries"

### Fix Dependabot PRs
**Load when**: User needs to close or fix open Dependabot PRs that update dependencies in generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`)

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/dependabot.md`

**Use cases**:
- "Fix the open Dependabot PRs for npm dependencies"
- "Bundle and close the Dependabot PRs for workflow dependencies"
- "Update @playwright/test to fix the Dependabot PR"

### Analyze Test Coverage
**Load when**: The workflow reads, analyzes, or reports test coverage — whether triggered by a PR, a schedule, or a slash command. Always consult this prompt before designing the coverage data strategy.

**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/test-coverage.md`

**Use cases**:
- "Create a workflow that comments coverage on PRs"
- "Analyze coverage trends over time"
- "Add a coverage gate that blocks PRs below a threshold"

### CLI Commands Reference
**Load when**: The user asks how to run, compile, debug, or manage workflows from the command line; needs the MCP tool equivalent of a `gh aw` command; or is in a restricted environment (e.g., Copilot Cloud) without direct CLI access.

**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/cli-commands.md`

**Use cases**:
- "How do I trigger workflow X on the main branch?"
- "What's the MCP equivalent of `gh aw logs`?"
- "I'm in Copilot Cloud — how do I compile a workflow?"
- "Show me all available gh aw commands"

### Token Consumption Optimization
**Load when**: The user asks how to reduce token usage, lower workflow costs, make a workflow faster or cheaper, or measure the impact of prompt or configuration changes.

**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/token-optimization.md`

**Use cases**:
- "How do I reduce the token cost of this workflow?"
- "My workflow is too expensive — how do I optimize it?"
- "How do I compare token usage between two runs?"
- "Should I use gh-proxy or the MCP server?"
- "How do I use sub-agents to reduce costs?"
- "How do I measure the impact of a prompt change?"

### Workflow Pattern Selection
**Load when**: The user asks for architecture, strategy, operating model selection, or pattern recommendations for building agentic workflows.

**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/patterns.md`

**Use cases**:
- "Which pattern should I use for multi-repo rollout?"
- "How should I structure this workflow architecture?"
- "What pattern fits slash-command triage?"
- "Should this be DispatchOps or DailyOps?"

## Instructions

When a user interacts with you:

1. **Identify the task type** from the user's request
2. **Load the appropriate prompt** from the URLs listed above
3. **Follow the loaded prompt's instructions** exactly
4. **If uncertain**, ask clarifying questions to determine the right prompt

## Quick Reference

```bash
# Initialize repository for agentic workflows
gh aw init

# Generate the lock file for a workflow
gh aw compile [workflow-name]

# Trigger a workflow on demand (preferred over gh workflow run)
gh aw run <workflow-name> # interactive input collection
gh aw run <workflow-name> --ref main # run on a specific branch

# Debug workflow runs
gh aw logs [workflow-name]
gh aw audit <run-id>

# Upgrade workflows
gh aw fix --write
gh aw compile --validate
```

## Key Features of gh-aw

- **Natural Language Workflows**: Write workflows in markdown with YAML frontmatter
- **AI Engine Support**: Copilot, Claude, Codex, or custom engines
- **MCP Server Integration**: Connect to Model Context Protocol servers for tools
- **Safe Outputs**: Structured communication between AI and GitHub API
- **Strict Mode**: Security-first validation and sandboxing
- **Shared Components**: Reusable workflow building blocks
- **Repo Memory**: Persistent git-backed storage for agents
- **Sandboxed Execution**: All workflows run in the Agent Workflow Firewall (AWF) sandbox, enabling full `bash` and `edit` tools by default

## Important Notes

- Always reference the instructions file at `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md` for complete documentation
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
- Follow security best practices: minimal permissions, explicit network access, no template injection
- **Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/network.md` for the full list of valid ecosystem identifiers and domain patterns.
- **Single-file output**: When creating a workflow, produce exactly **one** workflow `.md` file. Do not create separate documentation files (architecture docs, runbooks, usage guides, etc.). If documentation is needed, add a brief `## Usage` section inside the workflow file itself.
- **Triggering runs**: Always use `gh aw run <workflow-name>` to trigger a workflow on demand — not `gh workflow run <file>.lock.yml`. `gh aw run` handles workflow resolution by short name, input parsing and validation, and correct run-tracking for agentic workflows. Use `--ref <branch>` to run on a specific branch.
- **CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/cli-commands.md`
11 changes: 3 additions & 8 deletions .github/aw/actions-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,10 @@
"version": "v9.0.0",
"sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3"
},
"github/gh-aw-actions/setup-cli@v0.80.9": {
"repo": "github/gh-aw-actions/setup-cli",
"version": "v0.80.9",
"sha": "8c7d04ebf1ece56cd381446125da3e0f6896294a"
},
"github/gh-aw-actions/setup@v0.80.9": {
"github/gh-aw-actions/setup@v0.88.7": {
"repo": "github/gh-aw-actions/setup",
"version": "v0.80.9",
"sha": "8c7d04ebf1ece56cd381446125da3e0f6896294a"
"version": "v0.88.7",
"sha": "5e508589e03a7757a7e05b26e834292f5445bfb6"
}
}
}
Loading
Loading