---
title: Records and fields
description: Current record types, field multiplicity and stable identifiers.
url: https://docs.thegram.one/ko/reference/records-guide/
lang: en
requested_lang: ko
fallback_from: https://docs.thegram.one/reference/records-guide/
tier: current
status:
  component: .gram format / Gram Core
  deployment: n/a (format spec)
  applies_to_version: Latest
  status: GA
  last_verified: "2026-10-25"
  owner: thegram-one/thegram-format
  public_evidence:
    - https://thegram.one/gram-file/
  rationale: The public format page describes typed records, statuses and links as core .gram content.
source: https://docs.thegram.one/sources/records-guide.gram
date_published: "2026-10-12T13:11:21.823Z"
date_modified: "2026-10-12T13:39:13.076Z"
evidence:
  Canonical source SHA-256: b64833be26828f436aa9fb173ce6bc8f8e5f05e95bfa6a99e3980eb1cb980c66
  Selected revision: r2 · sha256:dbd5a0ee261d9f5b8e45c78d3e0fe39b8f6f5179cb0e73e54a248c1a2bf41e74
  Local renderer: configured local Thegram renderer · API thegram-web-render/1
  Core source: git+https://github.com/clab-one/thegram-format.git?rev=b16489e1d0d77d38f82d2f61776524737aa31557#b16489e1d0d77d38f82d2f61776524737aa31557
---

# Records and fields

<div class="gram-doc-anchor" id="e0-portal-reference-records-guide"></div>

### Current type vocabulary {#h0-2}

The current grammar names these record types: knowledge (`K`), decision (`D`), evidence (`E`), context (`C`), history (`H`), goal (`G`), task (`T`), blocker (`B`), requirement (`R`), risk (`X`), assumption (`A`), metric (`M`), event (`V`), artifact (`F`), person (`P`), agent (`AG`), project (`PR`), system (`SYS`), service (`SVC`), component (`CMP`), source (`SRC`), run (`RUN`), asset (`ASSET`), and relation (`REL`). These identifiers describe data; they do not impose workflow or access policy.

### Fields {#h0-4}

Use `t` for the one-line title; `d` for description; `x` for status; `p` for priority; `owner` for responsibility; repeatable `tag` and `source` values for classification/provenance; and `ref` for a URI or asset path. Metric records use literal `value`, `unit`, and optional `observed`. Task records may use `due`; event records may use `at`. Dates and quantities remain source strings.

Common statuses include open, active, blocked, completed, accepted and superseded. New status text is retained rather than silently mapped. A task checklist is still task records with status; there is no separate checkbox syntax.

### IDs and references {#h0-7}

Every record has a unique stable ID within its document, distinct from the document ID. Renaming a title does not change that identity. A local link target is a same-document ID; `document-id/entity-id` addresses a record in another document.

### Valid example {#h0-9}

```text
@gram 2
doc launch-notes
t Launch notes
T review
t Review the export
x active
d Compare the regenerated file with the source artifact.
M export-count
t Exported records
value 14
unit records
observed 2026-10-12T09:00:00Z
```

The number, date, and status in this example remain literal field values. Core parses and preserves them; the consuming view decides how to display recognized forms.

## Source

<div class="gram-record" id="e0-format-language" data-record-type="source">

**Source:** .gram language specification

Reference: [https://github.com/clab-one/thegram-format/blob/main/spec/language.md](https://github.com/clab-one/thegram-format/blob/main/spec/language.md)

</div>

<div class="gram-record" id="e0-format-rich" data-record-type="source">

**Source:** Current rich document specification

Reference: [https://github.com/clab-one/thegram-format/blob/main/spec/rich-document.md](https://github.com/clab-one/thegram-format/blob/main/spec/rich-document.md)

</div>

<div class="gram-record" id="e0-format-history6" data-record-type="source">

**Source:** Current History/6 specification

Reference: [https://github.com/clab-one/thegram-format/blob/main/spec/source-history-render.md](https://github.com/clab-one/thegram-format/blob/main/spec/source-history-render.md)

</div>