beads/docs/METADATA.md
Joseph Turian 54fdf249b1 docs: document issue.metadata field and reserved key prefixes
Closes #1415

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 02:14:10 -05:00

456 B

Issue Metadata

The metadata field on issues accepts arbitrary JSON. Any valid JSON value is stored as-is.

Reserved Key Prefixes

Prefix Reserved For
bd: Beads internal use
_ Internal/private keys

Avoid these prefixes in user-defined keys to prevent conflicts with future Beads features.

  • #1416 — Optional schema enforcement (future)