Request for Claude Code to support AGENTS.md

Melvin Vivas · X post · 2026-06-16 · Open on X

Topics: AI Dev Tools & Productivity, AI Agents, Tool Use & MCP · Level: beginner

Summary

The creator argues that Claude Code should read AGENTS.md, a shared convention for giving coding agents project instructions. At the time Claude Code used its own CLAUDE.md file. This points to the value of agent instruction files that work across tools.

Key points

• AGENTS.md is a shared format for instructions given to AI coding agents.
• Claude Code uses its own file, CLAUDE.md, for project context.
• Using one shared instruction file avoids keeping a separate copy for each tool.

Resources mentioned

• Claude Code · tool · code.claude.com · paid · recommended by both Bashiri Smith & Melvin Vivas
  Build agents and pipelines from the terminal; the guide's main agentic coding tool.
  Also in: Create Claude Code Plugins with /plugin-authoring (Melvin Vivas on X · notes), Claude Code mods: customize behavior and UI with plugins (Melvin Vivas on X · notes), AI Engineer Roadmap Overview: From ML Foundations to RAG, Agents & Ops (Bashiri Smith on Facebook · notes), SkillsBento: Free Plugin Marketplace for Codex and Claude Code (Melvin Vivas on X · notes) and 101 more
• AGENTS.md · docs · agents.md · free
  Instruction file format that gives coding agents project context such as the tech stack, skills and MCP servers.
  Also in: Claude Code Now Reads AGENTS.md When CLAUDE.md Is Missing (Melvin Vivas on X · notes), Subagents with mixed models: a strong planner and a fast executor (Melvin Vivas on X · notes), Updating Skills and AGENTS.md for Astra with OpenAI's Guidance (Melvin Vivas on X · notes), How to Prompt GPT-6 Astra in Codex: Simpler Instructions, Leaner AGENTS.md (Melvin Vivas on X · notes) and 5 more