Skip to content

Commit d71a2a8

Browse files
os-zhuangclaude
andcommitted
docs(adr): make 0084 self-contained — drop refs to voided ADR-0083
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>
1 parent 65c30a8 commit d71a2a8

1 file changed

Lines changed: 1 addition & 10 deletions

File tree

docs/adr/0084-application-builder-information-architecture.md

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Status**: Accepted (2026-07-01)
44
**Deciders**: ObjectStack Protocol Architects
5-
**Builds on**: the metadata-type taxonomy (ADR-0083, in review — Airtable's Data/Automation/Interface plus the types Airtable lacks), [ADR-0077](./0077-authoring-surface-boundary-hook-flow-validation.md) (route authoring by intent + audience + verifiability — the hook/flow/validation boundary), [ADR-0033](./0033-ai-assisted-metadata-authoring.md) (draft-gated authoring), [ADR-0063](./0063-two-kernel-agents-skills-are-the-extension-primitive.md)/[ADR-0064](./0064-tool-scoping-to-agent.md) (two kernel agents — AI is a platform capability, not app metadata), [ADR-0080](./0080-ai-authored-ui-jsx-source.md)/[ADR-0081](./0081-trusted-react-page-tier.md) (the Interface pillar's page-authoring depth).
5+
**Builds on**: [ADR-0077](./0077-authoring-surface-boundary-hook-flow-validation.md) (route authoring by intent + audience + verifiability — the hook/flow/validation boundary), [ADR-0033](./0033-ai-assisted-metadata-authoring.md) (draft-gated authoring), [ADR-0063](./0063-two-kernel-agents-skills-are-the-extension-primitive.md)/[ADR-0064](./0064-tool-scoping-to-agent.md) (two kernel agents — AI is a platform capability, not app metadata), [ADR-0080](./0080-ai-authored-ui-jsx-source.md)/[ADR-0081](./0081-trusted-react-page-tier.md) (the Interface pillar's page-authoring depth).
66
**Consumers**: `studio.app.ts` (the builder navigation), the Studio UI, `packages/cli/src/utils/format.ts` (`os` stats grouping), and the build agent (which surface authors which type).
77

88
**Premise**: ObjectStack has far more metadata types than Airtable's clean three, but the **application builder** — the surface a person (or the build agent) uses to *build an app* — must not expose all of them at one altitude, or it stops being learnable. Studio's current grouping is inconsistent (mixes Data with Interface, splits "Logic" from "Automation", scatters the rest). This ADR fixes the builder's information architecture, once, after a long design pass that repeatedly corrected itself. The core question it answers: **which metadata types are the app builder's job, at what altitude, and which belong to entirely different surfaces?**
@@ -66,15 +66,6 @@ Charts/metrics are **blocks** inside a dashboard/page bound inline to objects
6666

6767
---
6868

69-
## Relationship to ADR-0083
70-
71-
ADR-0083 categorizes *all* metadata types (Airtable's three plus Access, plus the types Airtable lacks). This ADR is the **builder-surface** decision layered on top, and it **refines** two of 0083's presentation choices for the app-builder specifically:
72-
73-
- **AI (agent/tool/skill) is not a builder pillar** — it's a Platform capability (the build/ask agents), out of the builder.
74-
- **Integration is not a peer tier** — connections fold into Advanced (technical, developer audience).
75-
76-
0083's taxonomy stands; 0084 decides how the builder *surfaces* it.
77-
7869
## Consequences
7970

8071
- The builder is learnable in one glance: four content tabs shaped like their data, plus Settings. Airtable users transfer instantly (Data/Automation/Interface), and the one addition (Access) is obvious.

0 commit comments

Comments
 (0)