Agentic Context
Scope
- •Operate AFS context safely: discover context roots, read/write scratchpad, and mount knowledge.
Workflow
- •Locate the active context root.
- •Use
~/src/lab/afs/scripts/afs context discover --path ~/src --json. - •Prefer project
.contextwhen working inside a repo.
- •Use
- •Ensure context scaffolding exists.
- •Use
~/src/lab/afs/scripts/afs context ensure-all --path ~/src.
- •Use
- •Read and write via AFS, not ad-hoc paths.
- •Read:
afs fs read scratchpad state.md --path ~/src. - •Write:
afs fs write scratchpad notes.md --path ~/src --content "...". - •List:
afs fs list knowledge --path ~/src --glob "*.md".
- •Read:
- •Keep memory and knowledge read-only.
- •Write only to
scratchpadunless explicitly asked.
- •Write only to
- •Use workspace navigation tools.
- •Use
ws list,ws find, andws statusfor project discovery.
- •Use
- •Use the AFS CLI wrapper for non-interactive agents.
- •Use
AFS_CLI=~/src/lab/afs/scripts/afsandAFS_VENV=~/src/lab/afs/.venvwhen needed.
- •Use
References
- •Read
references/sources.mdfor AFS context docs and contracts.