About FILESYSTEM.md
FILESYSTEM.md is an open specification for Agent-Native Filesystems (ANF): a dedicated, predictable workspace contract that tells AI coding agents how to use a project's identity, memory, skills, execution boundaries, and safety rules.
Think of it as a README for agents — markdown-first, interoperable across Codex, Cursor,
Claude Code, Copilot, and custom runtimes. It complements
AGENTS.md (shared behavior), thin harness adapters (for example
CLAUDE.md / .cursor/rules/), optional identity overlays, and
MCP for external tools.
Maintainer
The project is maintained by JetSquirrel. Contributions, issues, and implementation examples are welcome via the public repository.
Governance and contribution
FILESYSTEM.md evolves in the open. Proposals, clarifications, showcase submissions, and adoption feedback should go through the community process described on the Community page and the GitHub repository.
- Propose changes as pull requests or issues with clear motivation and examples
- Prefer interoperable, agent-readable conventions over tool-specific lock-in
- Document MUST / SHOULD guidance carefully so humans and agents can both follow it
License
The specification and site content are released under the MIT License. You may use, adapt, and redistribute the standard with attribution.
Machine-readable entry points
In addition to the human-readable docs, the site publishes discovery files for crawlers and LLMs:
- /for-agents/ — executable handbook for coding agents (bootstrap, memory, safety)
- Claude Code study guide — public architecture notes (tools, permissions, memory, skills)
- /llms.txt — curated index of specification and community documents
- /llms-full.txt — full inline documentation set for single-request context loading
- /filesystem.md — raw Manifesto markdown (canonical machine-readable source)
- /robots.txt and /sitemap-index.xml — crawl discovery
Start reading
- Manifesto — full specification
- Getting Started — adoption guide
- Compare — relationship to adjacent standards