Skip to content

Refine FieldWorks AI review workflows#905

Open
johnml1135 wants to merge 6 commits into
mainfrom
new_skills
Open

Refine FieldWorks AI review workflows#905
johnml1135 wants to merge 6 commits into
mainfrom
new_skills

Conversation

@johnml1135
Copy link
Copy Markdown
Contributor

@johnml1135 johnml1135 commented May 20, 2026

Summary

Refines the FieldWorks AI review customization flow into a clearer layered architecture:

  • Rename challenge-pr-author to pr-preflight for the pre-PR branch readiness workflow.
  • Keep review-analyzer.instructions.md as the shared FieldWorks review policy, not a user-facing workflow.
  • Wire pr-preflight to the existing specialist reviewer agents for C#, WinForms, C++/interop, Avalonia, and architecture-risk passes where appropriate.
  • Integrate grill-with-docs into planning/OpenSpec flows so ambiguous repo language is clarified before proposal/spec/design/task artifacts are written.
  • Align managed-code review guidance with the repo default C# 8.0 policy and nullable-reference-types disabled by default.
  • Keep respond-to-review-comments as the post-PR review feedback workflow.
  • Add a canonical Docs/workflows/ai-pr-workflow.md guide for the Jira -> worktree -> preflight -> review-response path with GitHub Copilot and Claude Code entrypoints.
  • Link that workflow from ReadMe.md, Docs/core-developer-setup.md, Docs/CONTRIBUTING.md, Docs/workflows/pull-request-workflow.md, and .github/pull_request_template.md so developers can discover it from onboarding and PR authoring surfaces.

Relationship to #865

The AI review workflow work now belongs in this PR. PR #865 should stay focused on non-render build/test/helper/installer cleanup and drop duplicated generic review-skill material.

CI-ready checklist

  • Commit messages follow .github/commit-guidelines.md; ran CI: Full local check.
  • No whitespace warnings locally; CI: Full local check reran after whitespace normalization and reported no problems.
  • Builds/tests pass locally (not run; changes are documentation/customization only).
  • For any Src/** folders touched, corresponding AGENTS.md files are updated or explicitly confirmed still accurate. Only Src/AGENTS.md guidance was updated to align with the repo C# 8.0 policy.

Notes for reviewers

This PR changes Copilot customization, skills, prompts, context/instruction files, and contributor-facing workflow docs only; no product source, build scripts, installer files, or runtime behavior changed.


This change is Reviewable

Copilot AI review requested due to automatic review settings May 20, 2026 23:47
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

Note

Copilot was unable to run its full agentic suite in this review.

Adds FieldWorks-specific Copilot customization artifacts to standardize PR analysis, pre-PR author “challenge” workflows, and structured response handling for review comments.

Changes:

  • Added a repo-root CONTEXT.md glossary/invariants document to align terminology across humans and agents.
  • Introduced new skills/prompts for pre-PR author challenge (challenge-pr-author) and for addressing review feedback (respond-to-review-comments), plus a terminology-grilling skill (grill-with-docs).
  • Added a FieldWorks-specific review analyzer instruction set and updated repo context entry points.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
CONTEXT.md New repo-wide shared language/glossary and invariants for FieldWorks.
.github/skills/respond-to-review-comments/SKILL.md New workflow skill for triaging/fixing/replying to PR review comments.
.github/skills/grill-with-docs/SKILL.md New skill for tightening terminology against repo context documents.
.github/skills/challenge-pr-author/SKILL.md New pre-PR interactive author “challenge” workflow that writes .review/summary.md.
.github/prompts/respond-to-review-comments.prompt.md Prompt wiring to invoke the respond-to-review-comments skill.
.github/prompts/challenge-pr-author.prompt.md Prompt wiring to invoke the challenge-pr-author skill.
.github/instructions/review-analyzer.instructions.md New FieldWorks PR/branch analysis policy with required passes and rubric.
.github/context/codebase.context.md Adds pointers to CONTEXT.md and the new review-response skill.

Comment thread .github/context/codebase.context.md Outdated
Comment thread .github/skills/respond-to-review-comments/SKILL.md Outdated
Comment thread .github/skills/challenge-pr-author/SKILL.md Outdated
Comment thread .github/skills/challenge-pr-author/SKILL.md Outdated
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 20, 2026

NUnit Tests

    1 files  ±0      1 suites  ±0   9m 5s ⏱️ - 2m 3s
4 204 tests  - 1  4 133 ✅  - 1  71 💤 ±0  0 ❌ ±0 
4 213 runs   - 1  4 142 ✅  - 1  71 💤 ±0  0 ❌ ±0 

Results for commit bd22510. ± Comparison against base commit b0bf8a8.

This pull request removes 2 and adds 1 tests. Note that renamed tests count towards both.
SIL.FieldWorks.Language.ManagedVwWindowTests ‑ NotSettingWindowTest
SIL.FieldWorks.Language.ManagedVwWindowTests ‑ SimpleWindowTest
SIL.FieldWorks.Common.RootSites.RootSiteTests.RealDataTestsBaseCleanupTests ‑ RunSetupFailureCleanup_ReleasesMutexEvenWhenDisposeFails

♻️ This comment has been updated with latest results.

johnml1135 and others added 2 commits May 21, 2026 13:47
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@johnml1135 johnml1135 changed the title Add AI review customization workflows Refine FieldWorks AI review workflows May 21, 2026
@johnml1135 johnml1135 requested a review from Copilot May 21, 2026 18:53
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

Copilot reviewed 18 out of 18 changed files in this pull request and generated 2 comments.

Comment thread .github/context/codebase.context.md Outdated
Comment thread .github/skills/pr-preflight/SKILL.md Outdated
johnml1135 and others added 3 commits May 21, 2026 16:47
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
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.

2 participants