# AGENTS.md for {{ vault_name }}

This vault is managed by `ztlctl`. Treat the MCP surface as canonical when it is available, and use the CLI as the fallback contract.

## Core Rules

- Prefer `ztlctl` workflows over ad hoc markdown editing when content lifecycle matters.
- Use one active session at a time and check `session_status` before starting a new one.
- Search before creating.
- Reuse existing tags via `list_tags` when possible.
- Prefer `ingest_source` for external text, files, and provider-backed URLs when provenance matters.
- Read `ztlctl://capture/spec` before ingesting agent-fetched web pages or multimodal evidence.
- Prefer nested `source_bundle` payloads over loose capture metadata when using `ingest_source`.
- Prefer one-step note creation with authored `body`, `key_points`, `aliases`, and `links` when creating synthesis or knowledge notes.
- Run `reweave` after important note creation.
- Use `vault_review` for health checks and periodic reviews.
- Use `draft_from_topic` when a topic packet is strong enough to become a note, task, or decision draft.
- Read `ztlctl://review/dashboard`, `ztlctl://garden/backlog`, and `ztlctl://decision-queue` for enrichment-oriented context.

## Methodology

{{ modules.methodology }}

## Session Workflow

{{ modules.session_lifecycle }}

## Capture Workflow

{{ modules.capture_workflow }}

## Review Workflow

{{ modules.review_workflow }}

## Graph Analysis

{{ modules.graph_analysis }}

## Tooling

- Available MCP tools: {{ tool_count }}
- Available MCP resources: {{ resource_count }}
- Available MCP prompts: {{ prompt_count }}
- Keep Claude-specific slash-command syntax out of Codex interactions.
- Prefer `topic_packet` when you need a topic-scoped learning or review bundle outside an active session.
- Prefer `topic_learn`, `topic_review`, `topic_decision`, `capture_web_source`, and `capture_multimodal_source` prompts when the MCP client exposes prompts.
