| Term | Meaning |
|---|---|
| Docset | Source Markdown and optional structured specs |
| Vocabulary | Canonical concept and field names, with aliases |
| Schemafier | Build tool that extracts and reconciles documentation |
| Schema | One concept's fields, caveats, evidence, and review state in YAML |
| Schemaset | A versioned collection of schemas |
| Index | Derived graph metadata and document embeddings for discovery |
| Query layer | Local CLI and Python interfaces over those artifacts |
A field is an addressable fact or attachment point. A caveat describes a constraint or exception, with evidence and applicability. A concept groups a bounded subject, such as an API operation or command.
What to ship
Exact lookup needs the schemaset. Semantic search also needs a compatible index and query embedding
provider. Format 0.2 schemas may reference a constraints/ directory that must travel with them.
Building from prose needs a generative model; reading the finished schemas does not. Keep source docs available because extraction can omit context.
Next: quick start or schema format.