Specifications & ADRs
Set the standard with structure and automatic numbering.
Agents cite the exact clause, and propose the amendment as a diff.
The knowledge base for people and agents
Everything your company knows, in one reliable source.
Specifications, reports, runbooks, research. Every document your team writes lands in one knowledge base — typeset for the people who read it, structured for the agents that work from it.
Documents built for context, not converted for it.
Built on the open CND standard
One document. Three readings.
Write in Typst. Cosmyc compiles it, deterministically, into a typeset PDF for people, native Markdown for LLMs, and a CND graph for context engineering.
The one file you write.
= Q3 report
Revenue grew 23% over Q2, see @budget-q3.
#figure(
table(columns: 4, ..budget),
caption: [Line-by-line budget, Q2 vs Q3.],
) <budget-q3>
Deterministic The same source compiles to the same bytes, every time.
What one compile gives you.
Q3 report
Revenue grew 23% over Q2, see Table 1.
| Line | Q2 | Q3 |
|---|---|---|
| Ads | 12.4k | 18.9k |
| Events | 8.0k | 7.2k |
| Content | 4.1k | 6.6k |
Table 1 — Line-by-line budget, Q2 vs Q3.
# Q3 report
Revenue grew 23% over Q2, see [Table 1](#budget-q3).
**Table 1** — Line-by-line budget, Q2 vs Q3.
| Line | Q2 | Q3 |
| --- | --- | --- |
| Ads | 12.4k | 18.9k |
| Events | 8.0k | 7.2k |
| Content | 4.1k | 6.6k |
CND
H HEADING
H1 Q3 report
label=q3-reportnumber=1children=3
P PARAGRAPH
Revenue grew 23% over Q2, see @budget-q3.
depth=1lang=en
refs@budget-q3
Fg FIGURE
Line-by-line budget, Q2 vs Q3.
kind=tablenumber=1counter_label=Table
T TABLE
| Line | Q2 | Q3 |
label=budget-q3cells=12content_kind=content
4 nodes · 1 reference resolved · depth 3
q3-report.pdf The document your reader opens: numbering, cross-references and figures in place.
Every document your team writes
From the first draft to the agent that reads it.
Research papers
Equations, figures, bibliographies done right.
Ask a question in plain words; get the figure that answers it.
Theses
Chapters, cross-references, one coherent document.
Your advisor's agent reads the same graph you wrote.
Reports
Data-driven tables and charts, regenerated on demand.
The Q3 table is a node: reference it, query it, patch it.
Runbooks
Step-by-step procedures with consistent formatting.
Restricted steps stay restricted, even for agents.
Technical manuals
Long documents that stay navigable.
The manual becomes machine context, not a 200-page PDF.
Lecture notes
Clean maths and code, week after week.
Students ask the notes, and get the section, not a guess.
Proposals
Professional layout without a designer.
Connect your agent, draft from last year's proposal.
How it works
Write once. Compile once. Everything else follows.
-
01
Write
A Typst editor in the browser, multi-file documents, instant preview. Cosmyc AI proposes edits as diffs; you approve or discard.
main.typ · sections/ · figures/
-
02
Compile
One compile produces the typeset PDF, a native Markdown, and the CND: sections, tables, figures, equations and references as typed nodes with stable labels.
-
03
Search and act
Ask in your own words. Search matches meaning, not only words, and returns the node that answers: a table, a figure, a section. Agents read the graph and propose changes. Your own agents connect through MCP.
table · budget-q3 — referenced by 3 sections
Why Cosmyc
Built for documents that agents will read.
01
Search that understands the question
Ask in your own words, without knowing the term the author used: search matches meaning, not only words. And because the CND keeps the structure, what comes back is the exact table or section, with its heading path.
"what did we spend on ads?" → table budget-q3 › row Marketing
02
Agents propose, you sign
Cosmyc AI writes patches, shown as diffs in the editor. Nothing lands without approval, and autonomy is your setting.
proposal · +4 −1 · awaiting approval
03
Governance down to the index
Workspaces, roles, groups, document and folder restrictions are enforced when content is retrieved, not painted over in the interface.
restricted: finance/ · filtered at retrieval
04
An open standard, not a silo
CND is Apache-2.0, with a public spec, schema, fixtures and CLI. Your documents leave as PDF, Markdown, or CND whenever you decide.
cnd validate · cnd diff · cnd build
Agents in your workspace
Cosmyc AI inside the editor. Any agent you bring, outside.
Both work on the same graph, and neither of them gets a permission you do not have.
The pilot
Cosmyc AI
Cosmyc AI reads the graph of your workspace and drafts with you, in the document. Every change comes back as a diff: it proposes, you decide. Nothing reaches the document without your approval, and how far it goes on its own is your setting.
Cosmyc AI · q3-report.typ
Q3 report › Budget
== Budget
Revenue grew 23% over Q2.
Revenue grew 23% over Q2, see @budget-q3.
#figure(table(..)) <budget-q3>
+2 −1 · waiting for your approval
Your own agent
Connected over MCP
Connect Claude, or any MCP client, to the same workspace. It searches, reads and edits after a standard OAuth sign-in — signed in as you, scoped to your roles, and never able to reach a document you cannot.
Claude · connected to workspace acme-specs
OAuth 2.1 · signed in as you · scoped to your roles
- Search Ask in your own words; what comes back is a node, with its heading path
- Edit Exact changes to a source file, saved as a revision you can read back
- Governance What you cannot open, it cannot read — your roles come with it
table · budget-q3 referenced by 3 sections
Coming from
Wherever your documents live today.
- Structure instead of formatting: headings, tables and figures are nodes, not styles.
- A versioned source file your team can review.
- Agents that work in the document, not in a chat window beside it.
Open standard
The format is public. Take it with you.
CND is an open standard for documents designed for retrieval and LLM-context pipelines. Cosmyc is one implementation; the format does not depend on it.
cnd-sdk Apache-2.0
The specification, JSON Schema, golden fixtures and the cnd CLI: validate, hash, diff, build, inspect.
typst-cnd Open source
The compiler that reads Typst sources and emits the CND: typed nodes, stable labels and typed links, from the same compile as the PDF.
Early access
Write the document. Get all three readings.
Cosmyc is in early access with its first testers. Create a workspace, bring a Typst document, and see what your agents can do with it.