Records and fields

이 상세 자료는 아직 한국어로 번역되지 않아 영문 원문을 표시합니다.

GA 공개 출처와 지원 범위

Status: GA
Component: .gram format / Gram Core
Deployment: n/a (format spec)
Applies to version: Latest
출처 확인일: 2026-10-25
Owner: thegram-one/thegram-format
Public evidence: thegram.one/gram-file/
Basis: The public format page describes typed records, statuses and links as core .gram content.

출처 확인은 실제 계정 설치·기기 동작·서비스 상태의 검증을 뜻하지 않습니다.

Current type vocabulary

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

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

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

@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

Source: .gram language specification

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

Source: Current rich document specification

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

Source: Current History/6 specification

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

Source and renderer 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

Canonical source: records-guide.gram

안내와 다른 점이 있나요? 문서 오류 신고 · 문제 해결
이메일은 직접 검토해 전송하세요. API key나 비공개 문서 내용은 보내지 마세요.