en-quire

Skill: en-quire — Markdown Document Management

Purpose: Instructions for agents using en-quire MCP tools to read, search, edit, and manage markdown and YAML documents.

---

Orientation: Multi-Root and doc_status

en-quire manages documents across multiple roots — separate directories for different document types (e.g. codex, agents, skills, testing). Each root can have its own git configuration and governance model.

Start every session with:

1. doc_status — see all configured roots, their git status, index health, and pending proposals
2. doc_list — see all files, or scope to a specific root with doc_list(scope: "skills")

File paths include the root prefix: codex/en-quire.mdx, agents/researcher.md, skills/en-quire/SKILL.md. Use the prefix in all tool calls — or, if you already hold a filesystem path from another tool, pass the absolute path as-is: it resolves to the root that contains it. The same goes for scope (e.g. an absolute directory in doc_list or doc_search). Absolute paths outside every configured root are rejected. Responses always use the root-prefixed form.

Search works across all roots by default. Scope to a single root with doc_search(query: "...", scope: "agents").

When to Use en-quire

For files inside a configured root, use en-quire tools (doc_*) instead of your client's filesystem tools (in Claude Code: Read, Edit, Write; on an MCP filesystem server: read_text_file, edit_file, write_file) for any operation on:

• Markdown files (.md, .mdx) — SOPs, skill files, codex articles, session memory, agent profiles
• YAML files (.yaml, .yml) — Docker Compose, config files, CI/CD pipelines, Kubernetes manifests

en-quire provides section-level addressing, structural search, and diff responses that eliminate the need to read or rewrite whole files. For YAML, "sections" are key paths (e.g. services.api.environment).

Use filesystem tools only when:

• The file is outside every configured root (check doc_status if unsure). en-quire rejects those paths, so don't retry them through doc_*.
• You are working with file types en-quire doesn't support (JSON, JS, etc.)
• You need to move or copy files between directories or roots