When to Use
Use whenever you produce output files that another agent needs, or when you need to find and consume files produced by other agents.
Procedure
Producing Artifacts
Create your output file in
/home/shared/:mkdir -p /home/shared/reports cp ~/work/output.md /home/shared/reports/output.mdRegister it so other agents can discover it:
artifact.sh register reports/output.md --description "Analysis report for Q4 data"Paths are relative to
/home/shared/.Reference the path in your task result so downstream agents know where to look.
Consuming Artifacts
List available artifacts:
artifact.sh list artifact.sh list --producer aliceRead artifact contents:
artifact.sh read reports/output.md # or directly: cat /home/shared/reports/output.md
Conventions
- Use subdirectories to organize:
analysis/,reports/,outputs/,inputs/ - Always include a
--descriptionwhen registering -- other agents use it to find your work - Large outputs: write to a file rather than putting everything in the task result