Skip to content

docs(adr): ADR-0083 — metadata-type taxonomy (Airtable 3 + 3)#2499

Closed
os-zhuang wants to merge 1 commit into
mainfrom
docs/adr-0083-metadata-taxonomy
Closed

docs(adr): ADR-0083 — metadata-type taxonomy (Airtable 3 + 3)#2499
os-zhuang wants to merge 1 commit into
mainfrom
docs/adr-0083-metadata-taxonomy

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Answers "Airtable categorizes as Data / Automation / Interface — I have more metadata types, how do I express and present them?" by defining the model once, as a single source of truth.

The problem

ObjectStack has a superset of Airtable's surface (~27 top-level metadata types) but no single model — and the two places that group types disagree and are each muddled:

  • os stats (format.ts): Data / UI / Logic / Security — files action under UI (it's behavior), buries agent in Logic (it's AI).
  • Studio nav (studio.app.ts): a Build group mixing Data with Interface, then splits "Logic" (actions/hooks) from "Automation" (flows) — two names for one concern.

The model — keep the 3, add the 3

Layer Pillar Anchor Types
Core (Airtable parity) Data object object · field · validation · state_machine · dataset
Automation flow flow · hook · action · trigger · job
Interface page app · page · view · form · dashboard · report · theme · book · doc
Superset (beyond Airtable) Access role permission · role · profile · sharing
Intelligence agent agent · tool · skill
Edge (cross-cutting) Integration datasource datasource · connector · webhook
  • Integration is a connective edge, not a 7th peer — its types cross-cut Data/Automation, so each gets a primary home + a documented secondary (no duplicate listings).
  • Anchor per pillar + progressive disclosure — show six pillars and one anchor type each; the full 27 are one expand away. Never flat.

Single source of truth

A spec METADATA_CATEGORY map that Studio nav, os stats, the docs reference, and the showcase Start Here all derive from — so they stop disagreeing, and the build agent gains a canonical category to reason with.

Docs-only; all cross-ADR links verified.

Follow-ups (separate PRs, per your call): encode METADATA_CATEGORY in spec; regroup Studio nav; align os stats; extend Start Here to the six-pillar map.

🤖 Generated with Claude Code

…rce of truth)

ObjectStack has a superset of Airtable's surface (~27 metadata types) but no
single model for it, and the two places that group types disagree and are each
muddled: `os` stats (format.ts) files `action` under UI and buries `agent` in
Logic; Studio nav (studio.app.ts) mixes Data with Interface and splits "Logic"
from "Automation".

Define the model once: keep Airtable's three (Data · Automation · Interface) and
add the three Airtable lacks (Access · Intelligence · Integration), with
Integration as a cross-cutting EDGE (datasource/connector/webhook get a primary
home + a documented secondary, never a duplicate listing). Each pillar has an
anchor type; the rest disclose progressively.

Mandate a single source of truth — a spec `METADATA_CATEGORY` map — that Studio
nav, the `os` stats sections, the docs reference, and the showcase Start Here all
derive from, so they stop disagreeing. Records the placement of every type,
cross-cutting rules, and the alternatives rejected (force into 3 / flat 27 /
per-surface grouping / Integration as a 7th peer).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 30, 2026 10:43pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s labels Jun 30, 2026
@os-zhuang

Copy link
Copy Markdown
Contributor Author

Voided — superseded by ADR-0084 (application-builder information architecture, #2503). The design pass corrected two of this ADR's claims (AI is a platform capability, not a peer pillar; Integration folds into Advanced, not a peer tier), and 0084 captures the builder-relevant taxonomy directly. Closing without merge.

@os-zhuang os-zhuang closed this Jul 1, 2026
@os-zhuang os-zhuang deleted the docs/adr-0083-metadata-taxonomy branch July 1, 2026 01:25
xuyushun441-sys pushed a commit that referenced this pull request Jul 1, 2026
ADR-0083 (metadata-type taxonomy) was voided (#2499 closed); 0084 subsumes the
builder-relevant taxonomy. Remove the Builds-on citation and the Relationship
section — their content (AI is a platform capability not a pillar; Integration
folds into Advanced) already lives in the TL;DR and Alternatives.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant