Consolidate agent guidance for Copilot and Claude Code#935
Merged
Conversation
This comment has been minimized.
This comment has been minimized.
johnml1135
force-pushed
the
github_to_agents
branch
from
00dada0 to
8c0ba48
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
This PR consolidates repo-local agent guidance so both GitHub Copilot and Claude Code can rely on the same standing docs (AGENTS.md) while moving Claude-oriented skill workflows into a single .claude/skills/ tree (leaving .github/ for GitHub-required surfaces).
Changes:
- Introduces
CLAUDE.md(importingAGENTS.md) and updates governance/docs to clarify the “shared vs GitHub-required vs Claude-only” split. - Updates prompts and workflow docs to reference
.claude/skills/*paths instead of.github/skills/*, and adjusts.gitignoreaccordingly. - Adds a large set of Claude skills (including Atlassian helper scripts) under
.claude/skills/.
Reviewed changes
Copilot reviewed 17 out of 89 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| ReadMe.md | Updates documentation to reflect new agent instruction/skill locations. |
| openspec/config.yaml | Updates legacy Jira helper path to .claude/skills. |
| openspec/AGENTS.md | Updates OpenSpec guidance references to .claude/skills. |
| Docs/workflows/ai-pr-workflow.md | Updates Claude skill path references and example commands. |
| Docs/agent-docs-refresh.md | Updates the “core always-on files” and Claude skill placement guidance. |
| CLAUDE.md | Adds Claude entrypoint importing AGENTS.md and describing the new layout. |
| AGENTS.md | Updates shared standing guidance and Jira helper script path. |
| .gitignore | Changes ignored env-file pattern from .github/skills/**/.env to .claude/skills/**/.env. |
| .github/skills/atlassian-skills/.env.example | Removes old .github/skills env example (migration to .claude). |
| .github/skills/atlassian-readonly-skills/.env.example | Removes old .github/skills env example (migration to .claude). |
| .github/prompts/respond-to-review-comments.prompt.md | Updates prompt to reference .claude/skills/respond-to-review-comments. |
| .github/prompts/pr-preflight.prompt.md | Updates prompt to reference .claude/skills/pr-preflight. |
| .github/copilot-instructions.md | Clarifies shared vs GitHub-required vs Claude-only guidance locations. |
| .github/AI_GOVERNANCE.md | Updates governance taxonomy and “source of truth” rules for the new layout. |
| .github/AGENTS.md | Repositions .github/ as GitHub compatibility surfaces; links to .claude skills. |
| .claude/skills/verify-test/SKILL.md | Adds Claude verification workflow skill. |
| .claude/skills/smart-screenshot-capture/SKILL.md | Adds screenshot-capture workflow skill. |
| .claude/skills/rubric-verify/SKILL.md | Adds rubric-based verification workflow skill. |
| .claude/skills/review/SKILL.md | Adds general review workflow skill. |
| .claude/skills/respond-to-review-comments/SKILL.md | Adds guided review-comment response workflow skill. |
| .claude/skills/powershell/SKILL.md | Adds PowerShell best-practices skill. |
| .claude/skills/plan-design/SKILL.md | Adds planning/design workflow skill. |
| .claude/skills/openspec-verify-change/SKILL.md | Adds OpenSpec verify workflow skill. |
| .claude/skills/openspec-sync-specs/SKILL.md | Adds OpenSpec spec-sync workflow skill. |
| .claude/skills/openspec-propose-change/SKILL.md | Adds OpenSpec propose workflow skill. |
| .claude/skills/openspec-new-change/SKILL.md | Adds OpenSpec new-change workflow skill. |
| .claude/skills/openspec-ff-change/SKILL.md | Adds OpenSpec fast-forward workflow skill. |
| .claude/skills/openspec-explore/SKILL.md | Adds OpenSpec explore-mode skill. |
| .claude/skills/openspec-continue-change/SKILL.md | Adds OpenSpec continue workflow skill. |
| .claude/skills/openspec-bulk-archive-change/SKILL.md | Adds OpenSpec bulk-archive workflow skill. |
| .claude/skills/openspec-archive-change/SKILL.md | Adds OpenSpec archive workflow skill. |
| .claude/skills/openspec-apply-change/SKILL.md | Adds OpenSpec apply/implementation workflow skill. |
| .claude/skills/jira-bugfix/SKILL.md | Updates Jira-bugfix skill to use .claude/skills Atlassian scripts. |
| .claude/skills/grill-with-docs/SKILL.md | Adds shared-language/terminology refinement skill. |
| .claude/skills/fieldworks-winapp/SKILL.md | Adds FieldWorks WinForms/WinApp automation skill index. |
| .claude/skills/fieldworks-winapp/references/research.md | Adds rationale/research notes for the WinApp skill structure. |
| .claude/skills/fieldworks-winapp/references/mcp-selection.md | Adds MCP driver selection guidance. |
| .claude/skills/fieldworks-winapp/references/how-to-update.md | Adds maintenance/update checklist for navigation paths. |
| .claude/skills/fieldworks-winapp/navigation/writing-system-font-options.md | Adds a navigation path for Writing System font options. |
| .claude/skills/fieldworks-winapp/navigation/styles-font-tab.md | Adds a navigation path for Styles dialog font tab. |
| .claude/skills/fieldworks-winapp/navigation/screenshot-evidence.md | Adds a navigation path for collecting screenshot evidence. |
| .claude/skills/fieldworks-winapp/navigation/project-loading.md | Adds a navigation path for restoring/loading sample projects. |
| .claude/skills/fieldworks-winapp/navigation/launch-or-attach.md | Adds a navigation path for launching/attaching to FieldWorks. |
| .claude/skills/execute-implement/SKILL.md | Adds minimal-scope implementation workflow skill. |
| .claude/skills/atlassian-skills/SKILL.md | Updates Atlassian skill docs/examples to .claude/skills paths. |
| .claude/skills/atlassian-skills/scripts/jira_worklog.py | Adds Jira worklog helper module. |
| .claude/skills/atlassian-skills/scripts/jira_workflow.py | Adds Jira workflow helper module. |
| .claude/skills/atlassian-skills/scripts/jira_users.py | Adds Jira user helper module. |
| .claude/skills/atlassian-skills/scripts/jira_search.py | Adds Jira search helper module. |
| .claude/skills/atlassian-skills/scripts/jira_projects.py | Adds Jira projects/versions helper module. |
| .claude/skills/atlassian-skills/scripts/jira_links.py | Adds Jira link helper module. |
| .claude/skills/atlassian-skills/scripts/jira_issues.py | Adds Jira issue helper module. |
| .claude/skills/atlassian-skills/scripts/confluence_search.py | Adds Confluence search helper module. |
| .claude/skills/atlassian-skills/scripts/confluence_pages.py | Adds Confluence page helper module. |
| .claude/skills/atlassian-skills/scripts/confluence_labels.py | Adds Confluence label helper module. |
| .claude/skills/atlassian-skills/scripts/confluence_comments.py | Adds Confluence comment helper module. |
| .claude/skills/atlassian-skills/scripts/bitbucket_projects.py | Adds Bitbucket project/repo helper module. |
| .claude/skills/atlassian-skills/scripts/bitbucket_files.py | Adds Bitbucket file/search helper module. |
| .claude/skills/atlassian-skills/scripts/bitbucket_commits.py | Adds Bitbucket commit helper module. |
| .claude/skills/atlassian-skills/scripts/init.py | Adds scripts package marker/version. |
| .claude/skills/atlassian-skills/requirements.txt | Adds Python deps for Atlassian scripts. |
| .claude/skills/atlassian-readonly-skills/SKILL.md | Updates read-only Atlassian skill docs/examples to .claude/skills paths. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_worklog.py | Adds read-only Jira worklog helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_workflow.py | Adds read-only Jira workflow helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_users.py | Adds read-only Jira user helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_search.py | Adds read-only Jira search helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_projects.py | Adds read-only Jira projects/versions helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_links.py | Adds read-only Jira links helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_issues.py | Adds read-only Jira issue helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/jira_agile.py | Adds read-only Jira agile helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/confluence_search.py | Adds read-only Confluence search helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/confluence_pages.py | Adds read-only Confluence page helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/confluence_labels.py | Adds read-only Confluence label helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/confluence_comments.py | Adds read-only Confluence comment helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/bitbucket_pull_requests.py | Adds read-only Bitbucket PR helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/bitbucket_projects.py | Adds read-only Bitbucket project/repo helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/bitbucket_files.py | Adds read-only Bitbucket file/search helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/bitbucket_commits.py | Adds read-only Bitbucket commit helper module. |
| .claude/skills/atlassian-readonly-skills/scripts/init.py | Adds scripts package marker. |
| .claude/skills/atlassian-readonly-skills/requirements.txt | Adds Python deps for read-only Atlassian scripts. |
jasonleenaylor
approved these changes
Jun 9, 2026
jasonleenaylor
left a comment
jasonleenaylor
left a comment
Contributor
There was a problem hiding this comment.
@jasonleenaylor partially reviewed 90 files and all commit messages, and made 1 comment.
Reviewable status:complete! all files reviewed, all discussions resolved (waiting on johnml1135).
.claude/skills/atlassian-readonly-skills/scripts/__init__.py at r1 (raw file):
Hmm, look at this later for cleanup?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.github/skillsto.claude/skillsso Claude Code has one project skill locationAGENTS.mdand addCLAUDE.mdto import it for Claude Code.githubfor GitHub-required Copilot surfaces and update prompts, docs, and governance text to point at the new layoutValidation
CI: Whitespace checkvia VS Code taskBuild/Agent/check-whitespace.ps1tried to readcheck-results.logwhen that file was not createdgit diff --checkThis change is