Bake Agent Context

Bake tasks for discovering and installing context files shipped by Cargo dependencies. It is the Rust counterpart to the Ruby agent-context gem.

Setup

Add the task library to the unpublished bake/ crate in your project, then link it once from that crate's main.rs:

[dependencies]
bake = "0.17"
bake-agent-context = "0.1"

use bake_agent_context as _;

fn main() -> bake::Result<()> {
    bake::Registry::discover()?.run()
}

Install context from all resolved dependencies and update agents.md:

cargo bake agent:context:install

Other tasks:

cargo bake agent:context:list
cargo bake agent:context:list --package socketry-executor
cargo bake agent:context:show --package socketry-executor --file getting-started
cargo bake agent:context:install --package socketry-executor
cargo bake agent:context:agents-md

Generated context files are written to .agents/context/; ignore that directory in Git. Other files directly under .agents/ may contain project-owned instructions. The generated agents.md is intended to be committed.

Provide context from a crate

Add a top-level context/ directory to the crate and ensure Cargo packages it. When using an explicit include list in Cargo.toml, include context/**:

my-crate/
├── Cargo.toml
├── context/
│   └── getting-started.md
└── src/

Bake Agent Context uses the crate description from Cargo.toml and extracts each Markdown file's title and first sentence for the generated agents.md section. No separate index file or Markdown front matter is needed.

Context

This crate includes guides for its users and for other crate authors:

• Getting Started explains how to add and run the Bake tasks.
• Using and Providing Context describes dependency context and how to publish context from a crate.
• Agent Context Specification defines the language-agnostic context directory and installation conventions.
• Rust Context provides shared development guidance for Socketry's Rust crates.

Release process

This crate has its own version and release history. See the repository's release instructions.