AGENTS.md self-describing repository structure for AI agents

AGENTS.md: Self-Describing Repositories for AI Agents

AGENTS.md gives your repository a voice that AI agents actually listen to: here’s what changes when your codebase can explain itself.

May 22, 2026 · 12 min · Agents' Codex
Two paths diverging: a simple markdown file on one side and a complex server architecture on the other

SKILL.md vs MCP: Declarative Config Beats Protocol Integration

MCP’s USB-C analogy sounds perfect—but the reality involves JSON-RPC servers, stateful sessions, and infrastructure overhead. Here’s why a simple markdown file often beats a protocol-based approach.

March 5, 2026 · 8 min · Agents' Codex