From cfb6e98c1f74e592ac4df66072f6ddb3e5b47722 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 8 Sep 2026 11:52:23 +0000 Subject: [PATCH 1/2] docs(data-modeling): drop the flowchart edge that routed secret values to `password` MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Text? branch of the field-type decision-tree flowchart had `TEXT -->|Secret value| T8[password]`, contradicting the same page's quick-reference table (password: "masked on read; stored plaintext at rest ... prefer secret for real credentials"), ADR-0100, and the published skill rule — all of which say a secret value belongs in `secret`. The flowchart already has a correct edge for this (`STRUCT -->|Sensitive secret value| S5[secret]`), so rather than add a second edge into the same `secret` node (which would leave two differently-labeled paths converging on one answer), the wrong edge is dropped outright and its now-unused `T8`/`password` style line removed. The `password` type and its table row are untouched — it's a real, supported type, just not one the flowchart should route credentials to. Full flowchart audited edge-by-edge against the quick-reference table; no other edge disagrees with its table row. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_012GKcPZbMoGq7WPzKLfRBTU --- content/docs/data-modeling/field-type-decision-tree.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/docs/data-modeling/field-type-decision-tree.mdx b/content/docs/data-modeling/field-type-decision-tree.mdx index 3bb3a692bb..b5581e341c 100644 --- a/content/docs/data-modeling/field-type-decision-tree.mdx +++ b/content/docs/data-modeling/field-type-decision-tree.mdx @@ -33,7 +33,6 @@ flowchart TD TEXT -->|Email address| T5[email] TEXT -->|Website URL| T6[url] TEXT -->|Phone number| T7[phone] - TEXT -->|Secret value| T8[password] %% Number branch NUM -->|Any number| N1[number] @@ -88,7 +87,6 @@ flowchart TD style T5 fill:#059669,color:#fff style T6 fill:#059669,color:#fff style T7 fill:#059669,color:#fff - style T8 fill:#059669,color:#fff style N1 fill:#d97706,color:#fff style N3 fill:#d97706,color:#fff style N4 fill:#d97706,color:#fff From 856264d8b8281f356e5a7e89be92ebe73f41ce31 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 8 Sep 2026 12:06:42 +0000 Subject: [PATCH 2/2] docs(data-modeling): restore the Text-branch secret edge, pointed at `secret` MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Round-1 rework: deleting the Text-branch credential edge outright (previous commit) left readers who answer "Text? yes" for an api_key/db_password — the table's own `secret` examples — with no secret-value edge at all on the branch they actually walk; the only surviving `secret` edge hangs off `Structured Data?`, which that reader answers "no" to. Point the Text branch at `secret` instead: `TEXT -->|Sensitive secret value| S5[secret]`. The Structured-branch edge stays too — an api_key is text and a credential blob is structured, and a decision tree with two questions legitimately reaching one answer is ordinary, not ambiguous. `S5` already has a style rule from the Structured branch, so no new style line is needed. Re-ran the full A2 edge-vs-table audit (36 edges now): the new TEXT->secret edge matches the `secret` table row; zero disagreeing edges. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_012GKcPZbMoGq7WPzKLfRBTU --- content/docs/data-modeling/field-type-decision-tree.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/content/docs/data-modeling/field-type-decision-tree.mdx b/content/docs/data-modeling/field-type-decision-tree.mdx index b5581e341c..c60590b14a 100644 --- a/content/docs/data-modeling/field-type-decision-tree.mdx +++ b/content/docs/data-modeling/field-type-decision-tree.mdx @@ -33,6 +33,7 @@ flowchart TD TEXT -->|Email address| T5[email] TEXT -->|Website URL| T6[url] TEXT -->|Phone number| T7[phone] + TEXT -->|Sensitive secret value| S5[secret] %% Number branch NUM -->|Any number| N1[number]