Skip to content

The design has a current layer - #738

Merged
WaylandYang merged 1 commit into
devfrom
docs/a-design-has-a-current-layer
Sep 17, 2026
Merged

WaylandYang merged 1 commit into
devfrom
docs/a-design-has-a-current-layer

Conversation

@WaylandYang

Copy link
Copy Markdown
Contributor

Closes #726 in its first form. Stacked on #724 (0045), which is stacked on #710 (0044), so the two proposed records are in the tree.

What this adds

docs/design/: the current design, one file per domain, each under 150 lines, written from a full read of all 45 records. What the system does today, why (citing the record in brackets), what is proposed and not built, and the open questions. Domains: ontology, extraction, identity, time, ledger, governance, rules, sources, lakehouse-and-actions, access-and-audit, interface, chat-and-mcp. docs/design/README.md explains the layer, lists the domains, records what changed on 2026-09-16 (cut 1 of 0044 landed, extraction writes only the open graph, the typed path is deleted, the optional bound pass is withdrawn) and gives every record with date, domain and one status word.

docs/decisions/README.md: a pointer to the design layer, a Domain column, and status cells shortened to one word plus "(by NNNN)". No record is renamed, moved or edited; the records stay history.

.gitignore: docs/design/ is no longer ignored (only decisions/ and pipeline.md were).

Not done here

The subdirectory-per-domain move of #726 (renaming 45 files breaks about 40 code-comment references and every inbound link); the index table already answers "which domain" and "does it still hold", which was the reason for the move. docs/pipeline.md still describes the typed path and is noted as awaiting a rewrite.

Read while compressing

Status lines that a later record or landed code has overtaken, now reflected in the table rather than in the records: 0044 says nothing is built while cut 1 has landed; 0014 says MCP cannot write while remember works over MCP with a write token; 0016 lists sealing as pending while 0034 records it as existing; 0009/0011 metric and dimension classes are overturned by 0036.

🤖 Generated with Claude Code

@WaylandYang
WaylandYang force-pushed the docs/a-time-mention-is-resolved-against-its-document branch from 97b685b to d33bc8b Compare September 17, 2026 09:27
@WaylandYang
WaylandYang force-pushed the docs/a-design-has-a-current-layer branch from f01a3d9 to 307a2a8 Compare September 17, 2026 09:27
@WaylandYang
WaylandYang force-pushed the docs/a-time-mention-is-resolved-against-its-document branch from d33bc8b to 254f04c Compare September 17, 2026 14:34
Base automatically changed from docs/a-time-mention-is-resolved-against-its-document to dev September 17, 2026 14:42
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Signed-off-by: WaylandYang <wayland0916@gmail.com>
@WaylandYang
WaylandYang force-pushed the docs/a-design-has-a-current-layer branch from 307a2a8 to 383222d Compare September 17, 2026 14:45
@WaylandYang
WaylandYang merged commit 0655ddb into dev Sep 17, 2026
4 checks passed
@WaylandYang
WaylandYang deleted the docs/a-design-has-a-current-layer branch September 17, 2026 14:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Decision records get a current-design layer and a domain index

1 participant