Skip to content

admin: Add AI coding assistant configuration#5206

Open
lgritz wants to merge 1 commit into
AcademySoftwareFoundation:mainfrom
lgritz:lg-agents
Open

admin: Add AI coding assistant configuration#5206
lgritz wants to merge 1 commit into
AcademySoftwareFoundation:mainfrom
lgritz:lg-agents

Conversation

@lgritz
Copy link
Copy Markdown
Collaborator

@lgritz lgritz commented May 19, 2026

Adds agent configuration supporting Claude Code, Cursor, GitHub Copilot, OpenAI Codex, and Opencode. A single AGENTS.md and contents of .agents subdirectory serve as the canonical source for instructions, skills, and other things that can be used across multiple tools. To avoid duplication, tool-specific files are, whenever possible, either symbolic links or thin wrappers referring to canonical areas. Includes per-directory .gitignore files to prevent accidental commits of per-user settings and session data.

This initial commit includes two skills that I wrote and have used for the last couple monthly releases: release-notes-update and prepare-patch-release. I assume that we will add more over time as we discover tasks that we want to make standard skill automation for.

Note that our use of symlinks is a little troublesome on Windows, and assumes that Windows-based developers will (a) enable Windows Developer Mode, and (b) git config --global core.symlinks true, both prior to cloning the repo. I think that if you don't do that, Windows developers will get separate copies of those files rather than links, in their local tree. But even that doesn't really matter for people not changng these very files.

Notes:

  • I don't use Windows, so if any of my assumptions here are wrong or put an undue burden on Windows users, please speak up and offer alternative suggestions or ask me to find a different approach.)
  • I only use Claude Code and a bit of Opencode myself, so if I've done anything very wrong for Copilot, Cursor, or Codex, please make corrections. In an ideal world, over time, more of these will coalesce on some common standards so that there will be even less repetition (like, many of them already use AGENTS.md as the one name for general instructions, and they often have compatible skill files, though they all seem to want them stored in different places currently, hence the links).

Assisted-by: Claude Code / claude-sonnet-4-6

The AGENTS.md, Claude skills, and general scheme are entirely from me. I used Claude to help me establish the setup for the other tools I don't happen to use.

Adds agent configuration supporting Claude Code, Cursor, GitHub
Copilot, OpenAI Codex, and Opencode. A single AGENTS.md and contents
of .agents subdirectory serve as the canonical source for
instructions, skills, and other things that can be used across
multiple tools. To avoid duplication, tool-specific files are,
whenever possible, either symbolic links or thin wrappers referring to
canonical areas. Includes per-directory .gitignore files to prevent
accidental commits of per-user settings and session data.

This initial commit includes two skills that I wrote and have used for
the last couple monthly releases: release-notes-update and
prepare-patch-release. I assume that we will add more over time as we
discover tasks that we want to make standard skill automation for.

Note that our use symlinks is a little troublesome on Windows, and
assumes that Windows-based developers will (a) enable Windows
Developer Mode, and (b) `git config --global core.symlinks true`, both
prior to cloning the repo.  I think that if you don't do that, Windows
developers will get separate copies of those files rather than links,
in their local tree.  But I think even that doesn't really matter for
people not changng these very files.

Assisted-by: Claude Code / claude-sonnet-4-6

The AGENTS.md, Claude skills, and general scheme are entirely from me.
I used Claude to help me establish the setup for the other tools I
don't happen to use.

Signed-off-by: Larry Gritz <lg@larrygritz.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.

1 participant