Skip to content

Commit cc1f3a4

Browse files
authored
Remove prescriptive examples from repository-quality-improver workflow to encourage creative focus area selection (#4087)
1 parent d6784de commit cc1f3a4

2 files changed

Lines changed: 23 additions & 39 deletions

File tree

.github/workflows/repository-quality-improver.lock.yml

Lines changed: 15 additions & 23 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.github/workflows/repository-quality-improver.md

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -89,15 +89,7 @@ Choose a focus area based on the following strategy to maximize diversity and re
8989
- Think creatively about this specific project's challenges
9090
- Consider areas beyond traditional software quality categories
9191
- Focus on workflow-specific, tool-specific, or user experience concerns (e.g., "Developer Onboarding", "Debugging Experience", "Contribution Friction")
92-
- **Examples of creative custom areas:**
93-
- "Workflow Compilation Performance"
94-
- "Error Message Clarity and Actionability"
95-
- "MCP Server Documentation Completeness"
96-
- "GitHub Actions Best Practices Adoption"
97-
- "Command-line Help Text Quality"
98-
- "Integration Test Reliability"
99-
- "Safe Output Mechanism Robustness"
100-
- "Workflow Template Reusability"
92+
- **Be creative!** Don't limit yourself to predefined examples - analyze the repository to identify truly unique improvement opportunities
10193

10294
2. **Use a Standard Category (30% of the time)** - Select from established areas:
10395
- Code Quality, Documentation, Testing, Security, Performance
@@ -518,15 +510,15 @@ A successful quality improvement run:
518510
- **Repository-Specific**: Custom areas should reflect actual needs of this specific project
519511
- **Reuse Strategically**: When reusing (10% of time), pick the most impactful area from recent history
520512

521-
### Custom Focus Area Examples for This Repository
513+
### Custom Focus Area Guidelines
522514

523-
Consider these types of custom areas specific to gh-aw:
515+
When creating custom focus areas specific to gh-aw:
524516

525-
- **Workflow-Specific**: "Workflow Template Quality", "Frontmatter Schema Completeness", "Workflow Compilation Feedback"
526-
- **Tool Integration**: "MCP Server Stability", "GitHub API Tool Coverage", "Safe Output Mechanisms"
527-
- **User Experience**: "CLI Command Discoverability", "Error Recovery Guidance", "Workflow Debugging Experience"
528-
- **Developer Productivity**: "Local Development Setup", "Testing Workflow Changes", "Compilation Speed"
529-
- **Documentation Quality**: "MCP Server Setup Guides", "Tool Configuration Examples", "Troubleshooting Resources"
517+
- **Be creative and analytical**: Study the repository structure, codebase, issues, and pull requests to identify real improvement opportunities
518+
- **Think holistically**: Consider workflow-specific aspects, tool integration quality, user experience, developer productivity, and documentation
519+
- **Focus on impact**: Choose areas where improvements would provide significant value to users or contributors
520+
- **Avoid repetition**: Invent fresh perspectives rather than rehashing previous focus areas
521+
- **Context matters**: Let the repository's actual needs guide your creativity, not a predefined list
530522

531523
### Analysis Depth
532524
- **Be Thorough**: Collect relevant metrics and perform meaningful analysis

0 commit comments

Comments
 (0)