From 6296b30008376c076f2fc8f0a4651dd7bdf2c025 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 21 Apr 2026 03:18:09 +0000 Subject: [PATCH 1/3] Initial plan From 7bfaa768cc6416a81301cb27c08356245bcae547 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 21 Apr 2026 03:33:02 +0000 Subject: [PATCH 2/3] Normalize report formatting guidance across reporting workflows Agent-Logs-Url: https://github.com/github/gh-aw/sessions/34791290-815d-44d9-a3a1-856319d4ad5a Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- .github/workflows/daily-safe-output-optimizer.md | 2 ++ .github/workflows/design-decision-gate.md | 4 ++++ .github/workflows/spec-librarian.md | 7 ++++--- .github/workflows/test-quality-sentinel.md | 3 +++ docs/src/content/docs/agent-factory-status.mdx | 1 + docs/src/content/docs/reference/frontmatter-full.md | 6 ++++++ 6 files changed, 20 insertions(+), 3 deletions(-) diff --git a/.github/workflows/daily-safe-output-optimizer.md b/.github/workflows/daily-safe-output-optimizer.md index 71801355bb5..e4d2e2fc616 100644 --- a/.github/workflows/daily-safe-output-optimizer.md +++ b/.github/workflows/daily-safe-output-optimizer.md @@ -367,6 +367,8 @@ After updating the tool description: - **Be evidence-based**: Show actual error examples, not assumptions - **Be actionable**: Recommend specific description improvements +- **Report Formatting**: Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in `
Section Name` tags to improve readability and reduce scrolling. + ### Issue Creation Rules - **Skip if no tool description issues found**: Don't create issue for workflow prompt issues only diff --git a/.github/workflows/design-decision-gate.md b/.github/workflows/design-decision-gate.md index e3b48b7bb5f..62470c3cb26 100644 --- a/.github/workflows/design-decision-gate.md +++ b/.github/workflows/design-decision-gate.md @@ -337,6 +337,10 @@ All ADRs are stored in `docs/adr/` as Markdown files numbered by PR number (e.g. > 🔒 *This PR cannot merge until an ADR is linked in the PR body.* ``` +### Report Formatting + +- **Report Formatting**: Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in `
Section Name` tags to improve readability and reduce scrolling. + ## Step 4b: If ADR Found — Verify Implementation Matches If an ADR **is** found (either in the PR body, on the PR branch, or in a linked issue), verify that the implementation aligns with the stated decision. diff --git a/.github/workflows/spec-librarian.md b/.github/workflows/spec-librarian.md index d7726a7b4d5..0c6c829e621 100644 --- a/.github/workflows/spec-librarian.md +++ b/.github/workflows/spec-librarian.md @@ -328,9 +328,10 @@ The following specifications are outdated: 1. **Be thorough**: Check ALL packages, not just a sample 2. **Be precise**: Reference exact file paths, function names, and dates 3. **Be actionable**: Every finding should have a clear recommendation -4. **Use progressive disclosure**: Wrap details in `
` tags -5. **One issue per run**: The `max: 1` limit ensures no issue spam -6. **Skip if open**: The `skip-if-match` rule prevents duplicate issues +4. **Report Formatting**: Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in `
Section Name` tags to improve readability and reduce scrolling. +5. **Use progressive disclosure**: Wrap details in `
` tags +6. **One issue per run**: The `max: 1` limit ensures no issue spam +7. **Skip if open**: The `skip-if-match` rule prevents duplicate issues ## Success Criteria diff --git a/.github/workflows/test-quality-sentinel.md b/.github/workflows/test-quality-sentinel.md index cb608ba09c9..0adfa2da340 100644 --- a/.github/workflows/test-quality-sentinel.md +++ b/.github/workflows/test-quality-sentinel.md @@ -451,6 +451,9 @@ After posting the comment, submit a pull request review based on the verdict: ## Guidelines +### Report Formatting +- **Report Formatting**: Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in `
Section Name` tags to improve readability and reduce scrolling. + ### Analysis Scope - **Focus only on new and changed tests** — do not analyze unchanged test files - **Support Go (`*_test.go`) and JavaScript (`*.test.cjs`, `*.test.js`)** as primary targets; note other languages but don't score them diff --git a/docs/src/content/docs/agent-factory-status.mdx b/docs/src/content/docs/agent-factory-status.mdx index 8dc07cd272d..8e75e6c983f 100644 --- a/docs/src/content/docs/agent-factory-status.mdx +++ b/docs/src/content/docs/agent-factory-status.mdx @@ -172,6 +172,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Smoke Crush](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-crush.md) | crush | [![Smoke Crush](https://github.com/github/gh-aw/actions/workflows/smoke-crush.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-crush.lock.yml) | - | - | | [Smoke Gemini](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-gemini.md) | gemini | [![Smoke Gemini](https://github.com/github/gh-aw/actions/workflows/smoke-gemini.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-gemini.lock.yml) | - | - | | [Smoke Multi PR](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-multi-pr.md) | copilot | [![Smoke Multi PR](https://github.com/github/gh-aw/actions/workflows/smoke-multi-pr.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-multi-pr.lock.yml) | - | - | +| [Smoke OpenCode](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-opencode.md) | opencode | [![Smoke OpenCode](https://github.com/github/gh-aw/actions/workflows/smoke-opencode.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-opencode.lock.yml) | - | - | | [Smoke Project](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-project.md) | copilot | [![Smoke Project](https://github.com/github/gh-aw/actions/workflows/smoke-project.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-project.lock.yml) | - | - | | [Smoke Service Ports](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-service-ports.md) | copilot | [![Smoke Service Ports](https://github.com/github/gh-aw/actions/workflows/smoke-service-ports.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-service-ports.lock.yml) | - | - | | [Smoke Temporary ID](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-temporary-id.md) | copilot | [![Smoke Temporary ID](https://github.com/github/gh-aw/actions/workflows/smoke-temporary-id.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-temporary-id.lock.yml) | - | - | diff --git a/docs/src/content/docs/reference/frontmatter-full.md b/docs/src/content/docs/reference/frontmatter-full.md index 9d07a7b4f86..69cb9f43901 100644 --- a/docs/src/content/docs/reference/frontmatter-full.md +++ b/docs/src/content/docs/reference/frontmatter-full.md @@ -1607,6 +1607,12 @@ engine: # (optional) command: "example-value" + # Custom Node.js driver script filename for an agentic engine. This replaces the + # engine's built-in driver wrapper (when the engine supports one) and must end + # with .js, .cjs, or .mjs. + # (optional) + driver: "example-value" + # Custom environment variables to pass to the AI engine, including secret # overrides (e.g., OPENAI_API_KEY: ${{ secrets.CUSTOM_KEY }}) # (optional) From e6bfce960aade84c1658cdff28e4b25e5640aceb Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 21 Apr 2026 03:33:20 +0000 Subject: [PATCH 3/3] Remove unintended generated documentation updates Agent-Logs-Url: https://github.com/github/gh-aw/sessions/34791290-815d-44d9-a3a1-856319d4ad5a Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- docs/src/content/docs/agent-factory-status.mdx | 1 - docs/src/content/docs/reference/frontmatter-full.md | 6 ------ 2 files changed, 7 deletions(-) diff --git a/docs/src/content/docs/agent-factory-status.mdx b/docs/src/content/docs/agent-factory-status.mdx index 8e75e6c983f..8dc07cd272d 100644 --- a/docs/src/content/docs/agent-factory-status.mdx +++ b/docs/src/content/docs/agent-factory-status.mdx @@ -172,7 +172,6 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Smoke Crush](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-crush.md) | crush | [![Smoke Crush](https://github.com/github/gh-aw/actions/workflows/smoke-crush.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-crush.lock.yml) | - | - | | [Smoke Gemini](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-gemini.md) | gemini | [![Smoke Gemini](https://github.com/github/gh-aw/actions/workflows/smoke-gemini.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-gemini.lock.yml) | - | - | | [Smoke Multi PR](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-multi-pr.md) | copilot | [![Smoke Multi PR](https://github.com/github/gh-aw/actions/workflows/smoke-multi-pr.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-multi-pr.lock.yml) | - | - | -| [Smoke OpenCode](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-opencode.md) | opencode | [![Smoke OpenCode](https://github.com/github/gh-aw/actions/workflows/smoke-opencode.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-opencode.lock.yml) | - | - | | [Smoke Project](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-project.md) | copilot | [![Smoke Project](https://github.com/github/gh-aw/actions/workflows/smoke-project.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-project.lock.yml) | - | - | | [Smoke Service Ports](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-service-ports.md) | copilot | [![Smoke Service Ports](https://github.com/github/gh-aw/actions/workflows/smoke-service-ports.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-service-ports.lock.yml) | - | - | | [Smoke Temporary ID](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-temporary-id.md) | copilot | [![Smoke Temporary ID](https://github.com/github/gh-aw/actions/workflows/smoke-temporary-id.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-temporary-id.lock.yml) | - | - | diff --git a/docs/src/content/docs/reference/frontmatter-full.md b/docs/src/content/docs/reference/frontmatter-full.md index 69cb9f43901..9d07a7b4f86 100644 --- a/docs/src/content/docs/reference/frontmatter-full.md +++ b/docs/src/content/docs/reference/frontmatter-full.md @@ -1607,12 +1607,6 @@ engine: # (optional) command: "example-value" - # Custom Node.js driver script filename for an agentic engine. This replaces the - # engine's built-in driver wrapper (when the engine supports one) and must end - # with .js, .cjs, or .mjs. - # (optional) - driver: "example-value" - # Custom environment variables to pass to the AI engine, including secret # overrides (e.g., OPENAI_API_KEY: ${{ secrets.CUSTOM_KEY }}) # (optional)