aboutsummaryrefslogtreecommitdiff
path: root/docs/design
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-20 08:49:52 -0500
committerCraig Jennings <c@cjennings.net>2026-07-20 08:49:52 -0500
commit70fbe011394523595974be311667db63425072ed (patch)
tree5deb5193cdf14b709531b32616622aee60d219ab /docs/design
parentb02eadec9392a9978cd526e2798460a53b5b79c4 (diff)
downloadrulesets-70fbe011394523595974be311667db63425072ed.tar.gz
rulesets-70fbe011394523595974be311667db63425072ed.zip
docs: fix four dangling file: links in specs and design notes
Three pointed at artifacts that were folded in or processed away (a spec-review file merged into wrapup-routing-spec, a removed pearl inbox note, a home-side subprojects log with no rulesets file) — delinked to plain text so the reference survives without a dead link. The fourth repoints the autonomous-batch spec at inbox.org, since inbox-zero.org was renamed in the consolidation. Surfaced by the sentry link-integrity pass.
Diffstat (limited to 'docs/design')
-rw-r--r--docs/design/2026-05-28-pattern-catalog-prompt-labels-and-defaults.org2
-rw-r--r--docs/design/2026-07-15-subprojects-convention-home-instance.org2
2 files changed, 2 insertions, 2 deletions
diff --git a/docs/design/2026-05-28-pattern-catalog-prompt-labels-and-defaults.org b/docs/design/2026-05-28-pattern-catalog-prompt-labels-and-defaults.org
index cc2cb77..9ee29d6 100644
--- a/docs/design/2026-05-28-pattern-catalog-prompt-labels-and-defaults.org
+++ b/docs/design/2026-05-28-pattern-catalog-prompt-labels-and-defaults.org
@@ -28,7 +28,7 @@ A generic =pearl--with-sentinel SENTINEL CANDIDATES= helper lets each call site
** Why for the catalog
-This is the "no hidden affordances" pattern from the earlier note ([[file:2026-05-28-0003-from-pearl-rulesets-followup-no-empty-input.org]]) sharpened with a second rule: *if the affordance is visible, its label has to match what picking it does*. Visibility without accuracy is its own problem. A label that says "none" when the behavior is "any" is no better than an invisible empty-input idiom — both leave the user holding the wrong model.
+This is the "no hidden affordances" pattern from the earlier note (a processed pearl-rulesets inbox item, since removed) sharpened with a second rule: *if the affordance is visible, its label has to match what picking it does*. Visibility without accuracy is its own problem. A label that says "none" when the behavior is "any" is no better than an invisible empty-input idiom — both leave the user holding the wrong model.
Catalog shape suggestion: this is the same principle as Pattern 3, in a follow-up form. Either a single entry that captures both halves (visible + accurate) or two cross-linked entries.
diff --git a/docs/design/2026-07-15-subprojects-convention-home-instance.org b/docs/design/2026-07-15-subprojects-convention-home-instance.org
index a1c4397..b031a41 100644
--- a/docs/design/2026-07-15-subprojects-convention-home-instance.org
+++ b/docs/design/2026-07-15-subprojects-convention-home-instance.org
@@ -195,7 +195,7 @@ Every real use emits a signal, and the signal is *captured*, not silently
acted on:
- Brief answers the question → *hit*.
- Brief is missing something, stale, or wrong → *miss*, logged in
- [[file:subprojects-log.org][subprojects-log.org]].
+ subprojects-log.org (a home-side artifact; no rulesets file).
- Each miss drives *two* updates: *local* (fix that brief) and, if the same
kind of miss recurs across subprojects, *structural* (fix this spine/spec,
not just the one file). The structural half is the actual self-improvement —