Skip to content

⚙️ [Maintenance]: New module repositories ship the Claude Code and Copilot agent routes - #50

Draft
Marius Storhaug (MariusStorhaug) wants to merge 1 commit into
mainfrom
add-agent-client-route-files
Draft

⚙️ [Maintenance]: New module repositories ship the Claude Code and Copilot agent routes#50
Marius Storhaug (MariusStorhaug) wants to merge 1 commit into
mainfrom
add-agent-client-route-files

Conversation

@MariusStorhaug

Copy link
Copy Markdown
Member

New module repositories created from this template carry the agent client routes that Claude Code and the Copilot surfaces need. Claude Code finds .claude/CLAUDE.md, and the Copilot surfaces that do not read AGENTS.md natively — Copilot Chat on GitHub.com, Visual Studio, JetBrains, Eclipse, and Copilot code review outside GitHub.com — find .github/copilot-instructions.md. Both files hold a route to the AGENTS.md router and nothing else, so every runtime resolves the same guidance with no second copy of it to drift.

New: Claude Code reaches the repository router

.claude/CLAUDE.md imports the router with the relative form @../AGENTS.md, which the file's position one directory below the root requires.

New: Copilot surfaces without AGENTS.md support reach the repository router

.github/copilot-instructions.md routes to AGENTS.md in a single sentence. Copilot Chat in VS Code and the Copilot cloud agent continue to read AGENTS.md directly and need no file of their own.


Technical details
  • Added .claude/CLAUDE.md: an MD041 disable comment and @../AGENTS.md.
  • Added .github/copilot-instructions.md: an MD041 disable comment and Follow the instructions in [AGENTS.md](../AGENTS.md).
  • Both files match the reference implementation carried by MSXOrg/docs itself. The MD041 disable comment follows this repository's own convention from the removed root CLAUDE.md, since the repository's .github/linters/.markdown-lint.yml does not disable MD041 globally.
  • Verified with markdownlint-cli2 --config .github/linters/.markdown-lint.yml: 0 issues.
  • PSModule/Template-PSModule#48 described both route files in its body, but its diff contains one file change — the deletion of the root CLAUDE.md. Confirmed with git show --stat dad7b12 and gh pr view 48 --json files. No root CLAUDE.md is restored; its removal was correct, because the root file is not a path any runtime requires.
  • Standards and framework alignment:
Changed surface Standards checked Framework docs checked Result
.claude/CLAUDE.md (client route) Agentic Development — client routes Agentic development design — client behavior Aligned
.github/copilot-instructions.md (client route) Agentic Development — client routes Agentic development design — client behavior Aligned
  • Issue convergence sweep: one open issue exists in this repository, PSModule/Template-PSModule#40, which concerns the pull request template's ending blocks. This diff does not touch it, so no additional issue is resolved.
  • Separate defect found and not fixed here: five of the six psmodule.github.io/docs/... links in AGENTS.md return HTTP 404, as does the site root. The msxorg.github.io Agentic Development link also 404s, because that standard moved to Capabilities/agentic-development/. The remaining msxorg.github.io links resolve. This needs tracking on its own.
Relevant issues (or links)

Related work

  • References PSModule/Template-PSModule#48 — completes the two route files that pull request's description claimed while its diff only removed the root CLAUDE.md.

New module repositories carry .claude/CLAUDE.md and
.github/copilot-instructions.md, so Claude Code and the Copilot surfaces
that do not read AGENTS.md natively still reach the router. Each file
holds only a route, per the agentic development standard.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@psmodule-s-shelly

Copy link
Copy Markdown

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern Description
^src/ Matches files where path matches this pattern
^README\.md$ Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant