This directory holds the design and implementation-facing documents for agentkit.
Start here:
v1-boundary.md: the proposed product boundary, crate split, feature flags, and core abstractions for v1.v1-plan.md: the recommended implementation order and the docs backlog to grow alongside the codebase.architecture.md: the current crate layout and runtime control flow.getting-started.md: entry points, example progression, and minimal assembly shape.feature-flags.md: umbrella crate feature flags and typical combinations.core.md: the proposed scope and API contract for theagentkit-corecrate.compaction.md: compaction triggers, strategy pipelines, backend hooks, and loop integration.capabilities.md: the lower-level capability abstraction shared by tools and MCP.context.md: built-inAGENTS.mdand skills loading behavior.loop.md: the proposed operational model and public API for theagentkit-loopcrate.reporting.md: the proposed design for theagentkit-reportingcrate and event-consumer adapters.tools.md: the proposed design foragentkit-tools-coreand the built-in tool boundaries.mcp.md: the proposed design for theagentkit-mcpintegration crate.plugins.md: Agent Plugins package parsing and composition with skills and MCP.acp.md: the proposed design for theagentkit-acpruntime integration and ACP approval resolver.permissions.md: the proposed shared policy and approval model across tools and MCP.
The intent is to keep agentkit narrow: a reusable Rust toolkit for building agent applications, not a full hosted platform or a single opinionated agent product.