# DrillFlow

> A local-first, web-based diagram editor built around drill-down: a node can
> own a whole sub-diagram, and you navigate into it as its own canvas, through
> arbitrarily many levels. No account needed; diagrams stay in the browser
> unless you share one.

DrillFlow documents can be generated by an agent. The easiest path is a Mermaid
flowchart — each `subgraph` is imported as a real drill-down subflow. Native
JSON is lossless and can be published to a shareable read-only link.

## Format

- [Document format reference](https://drillflow.de/en/format/): the canonical spec — document
  shape, drill-down semantics, defaults, validation rules, and both generation paths.
- [SPEC.md](https://drillflow.de/SPEC.md): the same reference as raw Markdown.
- [JSON Schema](https://drillflow.de/schema/drillflow-document.schema.json): draft 2020-12,
  for validating a generated document before import.

## Agent skill

- [SKILL.md](https://drillflow.de/skills/drillflow-diagrams/SKILL.md): a Claude Skill for
  generating DrillFlow diagrams.
- Worked examples — smallest complete document, a Mermaid flowchart three levels
  deep, and the same diagram as native JSON:
  [minimal.json](https://drillflow.de/skills/drillflow-diagrams/examples/minimal.json),
  [order-handling.mmd](https://drillflow.de/skills/drillflow-diagrams/examples/order-handling.mmd),
  [order-handling.json](https://drillflow.de/skills/drillflow-diagrams/examples/order-handling.json).

## Publishing

`POST https://api.drillflow.de/api/doc` with `{"data": <document>}` returns
`{"slug", "url"}` — a read-only `https://app.drillflow.de/view/<slug>` link, no account
required. Limits: 10 requests/minute per IP, 2 MB per document; anonymous links
expire after 90 days. Details in the format reference.

## Product

- [Home](https://drillflow.de/en/): what DrillFlow is and who it is for.
- [Docs](https://drillflow.de/en/docs/): the editor's features, for humans.
- [Changelog](https://drillflow.de/en/changelog/): user-facing changes per release.
- [App](https://app.drillflow.de): the editor itself.