# docify — knowledge index

Package: `@x12i/docify`
Version: `1.4.2`
Updated: `2026-07-30T16:00:45.570Z`
Platform: `@x12i/docify-export@1.4.3`

## How to choose

- **Concept** — what it is and why it exists
- **Guide** — bounded task procedure
- **Scenario** — state + evidence → which path
- **Use case** — end-to-end outcome
- **Tutorial** — learn by doing
- **Decision** — options and recommended default
- **Reference / API** — exact technical detail

## Manifest and search

- `agent-manifest.json`
- `SEARCH.json`

## Concepts

- `explicit-authoring` — **Explicit authoring** — Docify only builds knowledge that authors declare — it never discovers product truth from source. — [concepts/explicit-authoring.md](concepts/explicit-authoring.md)
- `open-markdown` — **Open Markdown baseline** — Every knowledge item ships as readable Markdown plus indexes — the SDK is optional. — [concepts/open-markdown.md](concepts/open-markdown.md)
- `guide-vs-scenario` — **Guides vs scenarios vs journeys** — Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome. — [concepts/guide-vs-scenario.md](concepts/guide-vs-scenario.md)
- `product-site-copy-policy` — **Product-site copy is derived, then approved** — Marketing copy is a projection of existing docs truth — never invented — and only approved copy is publishable. — [concepts/product-site-copy-policy.md](concepts/product-site-copy-policy.md)

## Guides

- `scaffold-concept` — **Scaffold a concept page** — Create a validated concept with problem, why, and mental model. — [guides/scaffold-concept.md](guides/scaffold-concept.md)

## Scenarios

- `choose-content-type` — **Choose the right Docify content type** — Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal. — [scenarios/choose-content-type.md](scenarios/choose-content-type.md)

## Diagrams

- `docify-dual-audience` — **One library, two consumption surfaces** — Explicitly authored content becomes a human website and an agent knowledge package. — [diagrams/docify-dual-audience.md](diagrams/docify-dual-audience.md)
- `auth-flow` — **Authentication flow (PlantUML)** — Sequence showing client login and JWT return. — [diagrams/auth-flow.md](diagrams/auth-flow.md)

## Tutorials

_None authored yet._