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

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>

This branch was successfully deployed

1 active deployment
Preview — 66c2ca6d Deployed Jun 30, 2026 by vercel[bot]
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