From b6bd03dfa6bcb521e5d2d023b9fb8a94bcf1a5ec Mon Sep 17 00:00:00 2001 From: aadhikaarika-lab Date: Tue, 7 Jul 2026 10:46:38 +0000 Subject: [PATCH] Creating a short plan for updating agent customization files. I'll add 3 concise todo steps. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Created 3 todos Now I'll search the repository for existing agent customization files (AGENTS.md, copilot instructions, CLAUDE.md). Searched for regex `AGENTS.md|.github/copilot-instructions.md|CLAUDE.md|.cursorrules|.windsurfrules|.clinerules`, 2 results I'll open the existing AGENTS.md to update it with concise, actionable guidance for AI coding agents. Read [](file:///workspaces/modelcontextprotocol/AGENTS.md) Now I'll add a concise "For AI coding agents" section to AGENTS.md with quick-start commands and pointers. Generating patch (30 lines) in [](file:///workspaces/modelcontextprotocol/AGENTS.md) ``` ``` Updating the todo list to mark inventory done and AGENTS.md update in progress/completed. Starting: *Report changes and suggest next customization ideas* (3/3) Now exploring the repo and improving agent-facing instructions; focused on making AGENTS.md concise and actionable for AI coding agents. **Modified Files** - **AGENTS.md**: AGENTS.md — Added a concise "For AI coding agents" section with quick-start commands, key locations, conventions, and PR guidance to help agents be immediately productive. Progress: Inventory complete and AGENTS.md updated. Next: I can either create a minimal `.github/copilot-instructions.md` that forwards agents to AGENTS.md, or scaffold an agent `skill` (plugins/…/skills/) to automate checks (`npm run prep`) and common tasks. Which would you like me to do next? Made changes. --- AGENTS.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index d124dc758..05ee96dfb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -88,3 +88,26 @@ are redirected out of this repo entirely: ## Commit Guidelines - Do not include model names or details (e.g., "Claude", "Opus") in commit messages + +## For AI coding agents + +- **Purpose:** Quick, actionable guidance for assistants working in this repo. +- **Quick start:** + - Install dependencies: `npm install` + - Run full validation + generation: `npm run prep` + - Useful targets: `npm run generate:schema`, `npm run check`, `npm run format` +- **Key locations:** + - Schema source (source-of-truth): [schema/2025-11-25/schema.ts](schema/2025-11-25/schema.ts) + - Generated schema/docs: [schema/*/schema.json](schema/2025-11-25/schema.json) and [docs/specification](docs/specification) + - SEPs: [seps/](seps/) + - Doc site: [docs/](docs/) (Mintlify) + - Generation scripts: [scripts/](scripts/) +- **Conventions & pitfalls:** + - Schemas use date-based versioning. Edit the TypeScript source, then run `npm run generate`. + - Always run `npm run check:schema:md` after schema changes to keep generated MDX in sync. + - Do not duplicate documentation — link to existing pages (see `docs/` and `CONTRIBUTING.md`). +- **PR guidance:** + - SEPs are submitted as PRs that add files under `seps/`. + - Use the templates in `.github/ISSUE_TEMPLATE/` when filing issues. +- **Where to look first:** `README.md`, `CONTRIBUTING.md`, `package.json`, and `AGENTS.md` itself for workflow and commands. +