Module layout 

The canonical layout: the single source of truth on disk.

The layout is deliberately not an agentlink invention. Every path here is one that a significant share of the ecosystem already reads natively:

Canonical	Read natively by
AGENTS.md	Codex, Cursor, Copilot, OpenCode, Antigravity, …
.agents/skills	Antigravity (IDE/CLI/AGY), Codex

Choosing the layout most tools already understand is what keeps the number of Strategy::Native verdicts high, and every native verdict is work that never has to happen. See docs/adr/0002-canonical-layout.md.

Structs

Layout

The canonical layout of a workspace.

Constants

AGENTS_MD_TEMPLATE

The starter AGENTS.md written by agentlink init when none exists.

CONFIG_FILE

User-editable configuration.

LOCAL_PROVIDERS_DIR

Directory scanned for workspace-local provider manifests.

LOCK_FILE

Record of everything agentlink has materialised.

STATE_DIR

Directory holding agentlink’s own state, relative to the workspace root.