Agent procedure
Use this page when your harness is Claude Code (or a CLAUDE.md-based adapter). FILESYSTEM.md stays harness-agnostic; this page only maps abstractions.
1. Keep one behavior source
- Put shared rules in
AGENTS.md. - Keep
CLAUDE.mdas a thin adapter (@AGENTS.mdimport or symlink). - Do not fork the same rules into multiple files.
2. Map abstract ops to Claude Code–style tools
| FILESYSTEM.md abstract op | Typical Claude Code–style tool | Notes |
|---|---|---|
list / tree orient | Bash (ls, find) or search/list helpers | Prefer workspace-scoped paths |
read_file | FileRead | Read before large edits |
write_file / patch | FileWrite / FileEdit | Prefer edit over full rewrite when possible |
grep | ripgrep via Bash or dedicated search tool | Exact match before broad semantic search |
append_file (logs/memory) | FileEdit / FileWrite append pattern | Never silently overwrite LOGS/ |
| skill load | Skill / plugin load, then read_file SKILLS/.../SKILL.md | Index first; full body on demand |
| external tools | MCP-wrapped tools | Still respect workspace + secrets policy |
3. Session mapping
| FILESYSTEM.md step | Claude Code–oriented action |
|---|---|
Bootstrap FILESYSTEM.md | Ensure it is readable in workspace; follow Bootstrap |
Inject AGENTS.md | Load via CLAUDE.md adapter if needed |
| Daily memory | Read/append MEMORY/daily/YYYY-MM-DD.md |
| Skills index | List SKILLS/; load one SKILL.md when required |
| Log | Append LOGS/YYYY-MM-DD.log |
4. Further reading (public study guide)
For architecture depth (tools, permissions, memory, skills, context), read the public study site:
- Hub: 深入 Claude Code：AI Agent 架构设计与工程实践
- Especially relevant chapters: 工具系统, 权限与安全模型, 上下文窗口管理, 记忆/持久化, Hooks / Skills / 插件
Treat that site as educational analysis, not Anthropic official documentation. Prefer verifying behavior against your installed harness and this workspace contract.
Human notes
Why this page exists
Humans often ask “how does a production coding agent touch the filesystem?” The study guide explains one industrial harness’s tool/permission/memory shape. FILESYSTEM.md standardizes the workspace contract those tools should honor.
Complementary, not competing
| Resource | Role |
|---|---|
| FILESYSTEM.md + For Agents | Portable workspace procedures |
| Claude Code study | Harness internals & engineering patterns |
| Official Anthropic docs | Authoritative product behavior |
Out of scope here
- Reproducing or redistributing proprietary source trees
- Sandbox escapes or permission bypass recipes
- Claiming bit-exact parity with any private codebase