Skip to content

docs: add AGENTS.md guidance for AI coding agents - #2

Merged
mpicciolli merged 7 commits into
mainfrom
chore/add-agents-md
Aug 12, 2026
Merged

docs: add AGENTS.md guidance for AI coding agents#2
mpicciolli merged 7 commits into
mainfrom
chore/add-agents-md

Conversation

@mpicciolli

@mpicciolli mpicciolli commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds an AGENTS.md file documenting repository conventions for AI coding agents, and wires it into the existing agent instructions.

  • AGENTS.md: describes what this repository is (skills for AI agents working with Pro Cycling Manager), how to create a new skill via /skill-creator:skill-creator, the expected skills/{skill-name}/ directory structure, and naming conventions.
  • CLAUDE.md: imports AGENTS.md so Claude Code picks up the same guidance.
  • README.md: minor link/content consistency fixes.

Documentation only — no code or behavior changes.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Adds a new repository-level guidance document for AI coding agents and aligns existing docs to reference it and use the correct upstream links.

Changes:

  • Added AGENTS.md describing skill creation workflow and repository conventions for skills.
  • Added CLAUDE.md to include AGENTS.md for Claude Code.
  • Updated README.md to point pcm-mcp links at the PCMStack/pcm-mcp repository.

Reviewed changes

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

File Description
AGENTS.md Introduces conventions and guidance for AI coding agents contributing skills to this repo.
CLAUDE.md Includes AGENTS.md so Claude Code picks up the same repository guidance.
README.md Updates pcm-mcp links to the new GitHub org/repo location for consistency.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
mpicciolli and others added 5 commits August 12, 2026 08:07
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown

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 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (1)

README.md:25

  • The Resources bullet list uses inconsistent terminal punctuation (this line ends with a period, while the other bullets here and in the earlier list do not). For consistency, drop the trailing period (or add periods to every bullet).
- [cdb-converter](https://github.com/PCMStack/converter) — Convert Pro Cycling Manager CDB files to/from SQLite.

@mpicciolli
mpicciolli merged commit c638ba2 into main Aug 12, 2026
1 check passed
@mpicciolli
mpicciolli deleted the chore/add-agents-md branch August 13, 2026 03:49
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