{"repo":"bgreenwell/dotagents","free":true,"listed":false,"github":"https://github.com/bgreenwell/dotagents","clone":"git clone https://github.com/bgreenwell/dotagents.git","description":"A proposed convention for the .agents/ directory to prevent context bloat and improve agent reasoning in complex codebases.","language":"Shell","stars":85,"topics":["agent-memory","agents-md","ai-agents","claude-code","coding-assistant","context","context-window","gemini-cli","standard","dotagents"],"license":"MIT","category":"ai-agents","readme_excerpt":"dotagents A directory-as-context convention for AI coding agents. Status: Draft Proposal (see CHANGELOG.md for version history) Inspiration: Based on experience, emerging patterns in agentic coding, and Issue #71 in agentsmd/agents.md. The problem Single context files such as AGENTS.md , CLAUDE.md , and .cursorrules can become difficult to maintain as projects grow. Monolithic files make agents load irrelevant information, mix instructions with reference material, and encourage duplicate vendor-specific configuration. The proposal Use a concise root AGENTS.md as a router. It should direct agents to existing human-facing project documentation and agent-specific resources only when a task requires them. Shared project truth remains in visible, conventional locations such as README.md , CONTRIBUTING.md , and docs/ . The hidden .agents/ directory is reserved for resources whose format or purpose is specific to agents. Self-hosting example This repository uses dotagents to maintain the proposal itself: Every checked-in example supports this proposal. The repository does not include fictional application schemas, migrations, or other capabilities that it cannot genuinely exercise. Shared project context Information useful to both humans and agents should keep its normal project location: - README.md — Project purpose, setup, and primary documentation. - CHANGELOG.md — Version history, release notes, and proposal revisions. - CONTRIBUTING.md — Contribution workflow and shared coding","default_branch":null,"files":null,"tree":[],"storefront":"/r/bgreenwell","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/bgreenwell/dotagents/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}