Skip to content

chore: enhance triage workflow with autonomous analysis and batch planning#245

Merged
joshsmithxrm merged 1 commit intomainfrom
chore/triage-process-improvements
Jan 7, 2026
Merged

chore: enhance triage workflow with autonomous analysis and batch planning#245
joshsmithxrm merged 1 commit intomainfrom
chore/triage-process-improvements

Conversation

@joshsmithxrm
Copy link
Owner

Summary

  • Enhanced /triage with autonomous analysis mode - Claude determines field values based on issue context
  • Complete rewrite of /create-issue with GraphQL project field integration
  • Enhanced /plan-work with --target, --batch, --epic options for project-aware planning
  • Added Priority/Size dropdowns to issue templates
  • Updated settings to reduce approval interruptions for routine operations

Changes

/triage command

  • Added Section 5 "Autonomous Analysis (Preferred)" with criteria tables for Type, Priority, Size, Status, Target
  • Added Section 11 "Suggest Work Batches" with predefined batch groups

/create-issue command

  • Complete rewrite with GraphQL project field integration
  • Supports --type, --priority, --size, --target, --parent options
  • Auto-adds to project and sets all 5 fields via GraphQL mutations

/plan-work command

  • Added --target, --batch, --epic, --limit options
  • Added predefined batches table (meta-process, tui-enhancements, phase-3-traces, etc.)
  • Added Section 3 "Validate Project Fields" before creating worktrees

Issue templates

  • feature_request.yml: Added optional Priority and Size dropdowns
  • bug_report.yml: Added optional Severity and Fix Complexity dropdowns

Other

  • CLAUDE.md: Added rule to link related issues in PR body
  • settings.json: Promoted routine operations from "ask" to "allow"

Test plan

  • Run /triage and verify autonomous analysis mode works
  • Run /create-issue and verify project fields are set
  • Run /plan-work --batch tui-enhancements and verify batch selection
  • Create test issue via template and verify dropdowns appear

Relates to #238

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings January 7, 2026 05:41
@gemini-code-assist
Copy link

Summary of Changes

Hello @joshsmithxrm, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the development workflow by introducing more automation and robust code quality checks. It refines issue management commands to allow for autonomous triage and more granular work planning, while also integrating custom Roslyn analyzers and detailed code scanning configurations to maintain high code standards. The overall aim is to streamline issue creation, triage, and planning processes, and to proactively enforce architectural guidelines and best practices.

Highlights

  • Enhanced Triage Workflow: The /triage command now includes an 'Autonomous Analysis' mode where Claude automatically determines field values (Type, Priority, Size, Status, Target) based on issue context and predefined criteria. It also suggests logical work batches for /plan-work.
  • Rewritten Issue Creation: The /create-issue command has been completely rewritten to integrate with GraphQL project fields, allowing automatic addition to projects and setting of all five fields (Type, Priority, Size, Status, Target) via GraphQL mutations. It also supports new options like --type, --priority, --size, --target, and --parent.
  • Advanced Work Planning: The /plan-work command gains new options (--target, --batch, --epic, --limit) for more flexible issue selection. It also introduces predefined batch groups and a validation step to ensure all selected issues have been properly triaged with Size and Target fields.
  • Code Quality Tooling Integration: New Roslyn analyzers (PPDS.Analyzers) have been added to enforce architectural patterns and detect common issues like sync-over-async and fire-and-forget async calls in constructors. A comprehensive CODE_SCANNING.md document outlines the configuration for CodeQL, Copilot, Gemini, and these new Roslyn analyzers, including disabled rules and bot review assessments.
  • Streamlined Operations: Routine git and gh commands (e.g., rm, git pull, git rebase, gh pr create, gh issue create, gh project) have been moved from 'ask' to 'allow' in settings.json, reducing interruptions for common operations.
  • Improved Issue Templates: Issue templates (bug_report.yml, feature_request.yml) now include optional dropdowns for Severity/Fix Complexity and Priority/Size Estimate, respectively, to gather initial triage information.
Ignored Files
  • Ignored by pattern: .gemini/** (2)
    • .gemini/config.yaml
    • .gemini/styleguide.md
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request significantly enhances the development workflow by introducing autonomous analysis in the /triage command, project-aware batch planning in /plan-work, and a complete rewrite of /create-issue with deep GitHub Projects integration. The addition of a dedicated Roslyn analyzer project (PPDS.Analyzers) to enforce architectural rules at compile time is an excellent step towards improving code quality and consistency. The accompanying documentation for code scanning and AI-assisted reviews is thorough and will be very valuable.

My review includes two high-severity comments. One addresses the brittleness of using hardcoded GitHub Project IDs in the /create-issue command design, and the other raises concerns about the security implications of allowing the AI agent to perform destructive file operations without confirmation. Overall, this is a very strong set of improvements.

Copy link

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 enhances the triage workflow by introducing autonomous issue analysis, adding Roslyn analyzers for architectural enforcement, and improving Claude command documentation with GraphQL-based project field management.

Key Changes:

  • Added three new Roslyn analyzers (PPDS006, PPDS012, PPDS013) for compile-time architectural enforcement
  • Completely rewrote /create-issue command with GraphQL project field integration
  • Enhanced /triage command with autonomous analysis mode that determines field values based on issue context
  • Enhanced /plan-work command with batch selection and project field validation

Reviewed changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
src/PPDS.Analyzers/Rules/UseEarlyBoundEntitiesAnalyzer.cs New analyzer to detect string literals in QueryExpression constructors
src/PPDS.Analyzers/Rules/NoSyncOverAsyncAnalyzer.cs New analyzer to detect sync-over-async patterns
src/PPDS.Analyzers/Rules/NoFireAndForgetInCtorAnalyzer.cs New analyzer to detect fire-and-forget async calls in constructors
src/PPDS.Analyzers/DiagnosticIds.cs Defines diagnostic IDs and categories for all analyzers
src/PPDS.Analyzers/PPDS.Analyzers.csproj New analyzer project targeting netstandard2.0
src/PPDS.Cli/Services/ServiceRegistration.cs Added pragma warnings to suppress PPDS012 analyzer for legitimate sync-over-async
src/PPDS.Cli/PPDS.Cli.csproj Integrated analyzer project reference
PPDS.Sdk.sln Added PPDS.Analyzers project to solution
CLAUDE.md Added rule to link related issues in PR body
.github/copilot-instructions.md New file with Copilot review guidance on architecture and patterns
.github/codeql/codeql-config.yml Added query filters to disable style rules conflicting with project conventions
.github/CODE_SCANNING.md New comprehensive documentation of code scanning tools configuration
.github/ISSUE_TEMPLATE/feature_request.yml Added optional Priority and Size dropdowns
.github/ISSUE_TEMPLATE/bug_report.yml Added optional Severity and Fix Complexity dropdowns
.editorconfig Added CS8981 suppression for generated code with lowercase type names
.claude/settings.json Promoted routine git/gh operations from "ask" to "allow"
.claude/commands/triage.md Added autonomous analysis mode with criteria tables and batch suggestions
.claude/commands/plan-work.md Added --target, --batch, --epic options with predefined batch table
.claude/commands/create-issue.md Complete rewrite with GraphQL mutations for project field management
.gemini/config.yaml New Gemini Code Assist configuration
.gemini/styleguide.md New comprehensive style guide for Gemini with architecture patterns

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

@joshsmithxrm joshsmithxrm force-pushed the chore/triage-process-improvements branch from eafaf0a to ad7f579 Compare January 7, 2026 05:46
…nning

- /triage: Add autonomous analysis mode (Claude determines field values)
  - Target assignment criteria (This Week, Next, CLI v1.0.0, Q1 2026)
  - Batch recommendations for /plan-work integration

- /create-issue: Complete rewrite with project integration
  - GraphQL mutations to set all 5 project fields
  - Support for --type, --priority, --size, --target, --parent options

- /plan-work: Add project-aware options
  - --target: Select issues by Target field
  - --batch: Predefined batch groups (tui-enhancements, phase-3-traces, etc.)
  - --epic: Select children of an epic
  - Validation of project fields before creating worktrees

- Issue templates: Add optional Priority/Size dropdowns
- CLAUDE.md: Add rule to link related issues in PR body
- Settings: Reduce approval interruptions for routine operations

Relates to #238

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@joshsmithxrm joshsmithxrm force-pushed the chore/triage-process-improvements branch from ad7f579 to 4578d94 Compare January 7, 2026 06:02
@joshsmithxrm joshsmithxrm merged commit d45c077 into main Jan 7, 2026
4 checks passed
@joshsmithxrm joshsmithxrm deleted the chore/triage-process-improvements branch January 7, 2026 06:03
@github-project-automation github-project-automation bot moved this from Todo to Done in PPDS Roadmap Jan 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants