# Chainfill

> Enterprise document processing platform for freight and logistics operations. Chainfill extracts data from transport documents, validates it against customer rules, and exports structured results into customer systems.

## Agent Entry Points

- Full agent guide: /llms-full.txt
- Machine-readable manifest: /agents.json
- MCP server: `cf --profile <profile> mcp serve`
- CLI package: cli
- Agent docs: /docs/agents/README.md
- Usage guide: /docs/agents/how-to-use.md
- Action contract: /docs/agents/action-contract.md
- Playbooks: /docs/agents/playbooks/
- Company brain runbook: /docs/agents/company-brain/README.md
- Support memory corpus: /docs/agents/support-memory/
- Evaluation harness: /docs/agents/evals.md

## Preferred Agent Order

1. Use the Chainfill MCP server when `cf --profile <profile> mcp doctor --json` reports it healthy.
2. Use `cli.search`, `cli.describe`, and `cli.execute` for operations outside its typed fast path; they cover every visible `cf` command, including writes.
3. Use REST/OpenAPI for integration code.
4. Use browser automation only for visual verification or missing API coverage.

## Safety Rules

- Default writes to `local` or `preview`.
- Use `--document-purpose testing` for test uploads.
- Treat admin impersonation, resend/export, approval, and workflow resume as privileged actions.
- Poll status endpoints until terminal state.
- Stop on ambiguous company, user, document, endpoint, or production target.

## High-Value Workflows

- Reupload test documents: /docs/agents/playbooks/reupload-test-documents.md
- Debug document processing: /docs/agents/playbooks/debug-document-processing.md
- Retry export delivery: /docs/agents/playbooks/retry-export-delivery.md
- External order retrieval API: /docs/agents/playbooks/order-retrieval-api.md
- Custom table inbound API: /docs/agents/playbooks/custom-table-inbound-api.md
- Inspect company configuration: /docs/agents/playbooks/inspect-company-configuration.md
- Customer support mailbox patterns: /docs/agents/playbooks/customer-support-mailbox-patterns.md
- Support agent feedback: /docs/agents/playbooks/support-agent-feedback.md
- Company brain runbook: /docs/agents/company-brain/README.md
- Support memory corpus: /docs/agents/support-memory/README.md