Skip to content

Remove prescriptive examples from repository-quality-improver workflow to encourage creative focus area selection#4087

Merged
pelikhan merged 3 commits intomainfrom
copilot/remove-custom-areas-example
Nov 15, 2025
Merged

Remove prescriptive examples from repository-quality-improver workflow to encourage creative focus area selection#4087
pelikhan merged 3 commits intomainfrom
copilot/remove-custom-areas-example

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Nov 15, 2025

The repository-quality-improver workflow contained lists of specific custom focus area examples that constrained the agent's creativity when selecting improvement targets.

Changes

Strategy Options Section

  • Removed 8 hardcoded custom area examples ("Workflow Compilation Performance", "Error Message Clarity", etc.)
  • Replaced with directive: "Be creative! Don't limit yourself to predefined examples - analyze the repository to identify truly unique improvement opportunities"

Custom Focus Area Guidelines Section

  • Renamed from "Custom Focus Area Examples for This Repository" to "Custom Focus Area Guidelines"
  • Replaced 5 categorized example lists with guiding principles:
    • Be creative and analytical
    • Think holistically
    • Focus on impact
    • Avoid repetition
    • Context matters

Example

Before:

- **Examples of creative custom areas:**
  - "Workflow Compilation Performance"
  - "Error Message Clarity and Actionability"
  - "MCP Server Documentation Completeness"

After:

- **Be creative!** Don't limit yourself to predefined examples - analyze the repository to identify truly unique improvement opportunities

The agent now evaluates repository context independently rather than selecting from predefined categories.

Original prompt

Remove example of custom areas in repository-quality-improver.md to encourage creativity of the agent. Tell the agent to be creative.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits November 15, 2025 20:59
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] Remove example of custom areas from repository-quality-improver.md Remove prescriptive examples from repository-quality-improver workflow to encourage creative focus area selection Nov 15, 2025
Copilot AI requested a review from pelikhan November 15, 2025 21:04
@pelikhan pelikhan marked this pull request as ready for review November 15, 2025 21:04
Copilot AI review requested due to automatic review settings November 15, 2025 21:04
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR refactors the repository-quality-improver workflow to encourage more creative and analytical focus area selection by removing prescriptive examples. The goal is to allow the AI agent to independently analyze the repository and identify truly unique improvement opportunities rather than selecting from a predefined list.

Key changes:

  • Removed 8 hardcoded custom area examples from the Strategy Options section
  • Replaced example lists with guiding principles emphasizing creativity and repository-specific analysis
  • Renamed "Custom Focus Area Examples" section to "Custom Focus Area Guidelines" with 5 principle-based guidelines

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
.github/workflows/repository-quality-improver.md Updated custom focus area guidance to remove prescriptive examples and encourage creative, analytical thinking
.github/workflows/repository-quality-improver.lock.yml Compiled YAML workflow reflecting the markdown changes with correct prompt structure

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 1661 to +1671
1. **Copilot Agent Section**: Always include a clearly marked section for Copilot agent tasks
2. **Planner Note**: Include a note for the planner agent to split tasks
PROMPT_EOF
- name: Append prompt (part 2)
env:
GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt
run: |
# shellcheck disable=SC2006,SC2287
cat >> "$GH_AW_PROMPT" << 'PROMPT_EOF'
3. **Code Regions**: Mark specific files or patterns where changes are needed
4. **Task Format**: Each task should be self-contained with clear acceptance criteria
5. **Variety**: Generate 3-5 actionable tasks per run
6. **Prioritization**: Mark tasks by priority and effort

## Phase 3: Update Cache Memory

PROMPT_EOF
- name: Append prompt (part 2)
Copy link

Copilot AI Nov 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The prompt is split at an unusual location (lines 1669-1670) between 'Important Report Guidelines' and 'Phase 3: Update Cache Memory'. This split appears to be a side effect of the content changes. While the workflow will still function correctly, consider whether the split point could be more logical (e.g., after Phase 3 section) for better maintainability and readability of the compiled workflow.

Copilot uses AI. Check for mistakes.
@pelikhan pelikhan merged commit cc1f3a4 into main Nov 15, 2025
90 checks passed
@pelikhan pelikhan deleted the copilot/remove-custom-areas-example branch November 15, 2025 22:19
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.

3 participants