▢→AgentMarkv0.2.0

Quickstart

AgentMark is a text-first notation for AI architecture. Sketch the system in seconds, then layer in the claims, constraints and decisions that keep it honest as the market moves. This page gets you to a working diagram fast.

Use the editor (no install)

Open the Editor, pick Load example…, and start typing. The diagram on the right updates live; the script is encoded in the URL (?p=…) so any diagram is a shareable link.

Run locally

make up        # install → build the library → dev server on http://localhost:3010
make test      # library conformance tests + the Playwright UAT suite

The repo is an npm-workspaces monorepo: @agentmark/core (the canonical library), @agentmark/cli (am), and the Next.js web app.

Your first diagram (Sketch)

No setup, four arrows — this is the whole "viral core":

[User] -> [Agent] -> [Model]
[Agent] -> [MCP] -> [Tool]
[Agent] -> [RAG] -> [Data]
[Agent] -> [Eval] -> [Agent]

Add structure (Spec)

Give important nodes stable IDs (type#id: Label), push fast-changing detail into { properties }, and add frontmatter:

---
agentmark: 0.2.0
title: Coding Agent
---

[human#you: You] -> [harness#codex: Codex Harness]

[harness#codex]
  -> [agent#coder: Coding Agent {roles: [planner, coder, tester]}]
  -> [middleware#mcp_selector: MCP Tool Selector {strategy: shortlist, top_k: 12}]
  -> [mcp#github: GitHub MCP]

Add knowledge (Decision)

Record why, with expiry dates and dependencies. The linter then flags the doc as stale when an assumption lapses:

claim C-001:
  text: GLM is the cheapest credible coding substitute.
  kind: cost
  metric: cost_per_accepted_patch
  evidence: [bench#CODE-HARNESS-2026-06]
  confidence: medium
  review_by: 2026-06-16

decision D-001:
  title: Use Codex as the coding harness
  status: accepted
  chosen: [model#codex: Codex]
  supported_by: [C-001]
  invalid_if:
    - C-001 expires

Where to next

  • The Editor — views, exports, themes, vim, layout direction.
  • The CLI — am render | lint | stale.
  • The Library API — embed AgentMark in your own tools.
  • The full Specification — the language, in depth.