vb-nattamai/agent-ready
AgentReady — Transform any legacy repo into an AI-agent-ready codebase. Generates agent-context.json, AGENTS.md, CLAUDE.md, MCP config, and tool scaffolds via a single GitHub issue or Actions workflow.
Platform-specific configuration:
{
"mcpServers": {
"agent-ready": {
"command": "npx",
"args": [
"-y",
"agent-ready"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
agent-readyA toolkit you drop onto any existing repository to generate all scaffolding files that make it understandable and operable by AI agents — without hallucinations, without invented paths, without breaking existing code.
> Supports: Claude · OpenAI · Gemini · Any LLM
---
AI coding agents (Copilot, Claude Code, Cursor, Aider, etc.) work dramatically better when a repository contains structured context files that describe:
Without these files, agents hallucinate paths, invent APIs, and produce code that doesn't compile. This toolkit fixes that.
---
When you run the transformer on your repository, it produces:
| File | Purpose | Platform | |------|---------|----------| | AGENTS.md | Agent instruction file with safe/forbidden operations | GitHub Copilot / OpenAI | | CLAUDE.md | Agent instruction file with module layout & rules | Claude Code / Anthropic | | system_prompt.md | Universal system prompt (works with any LLM) | Any LLM | | agent-context.json | Machine-readable repo map (static + dynamic sections) | All platforms | | mcp.json | MCP server configuration | Claude / MCP-compatible | | AGENTIC_READINESS.md | Audit report with 100-point readiness score | Humans / CI gates | | tools/<capability>_tool.* | Tool scaffolds (Python, TS, Java, Go) | All platforms | | memory/schema.md | Memory/state contract for agent persistence | All platforms | | .github/agents/<repo>.agent.md | GitHub Copilot agent definition | VS Code Copilot |
---
# Required
python --version # Should be 3.9 or higher
# Optional — install for LLM-Loading reviews...