Skip to content

docs: add sota-per-intent principle - #21

Merged
REPPL merged 1 commit into
mainfrom
docs/sota-per-intent-principle
Jul 11, 2026
Merged

docs: add sota-per-intent principle#21
REPPL merged 1 commit into
mainfrom
docs/sota-per-intent-principle

Conversation

@REPPL

@REPPL REPPL commented Jul 11, 2026

Copy link
Copy Markdown
Owner

Adds the SOTA per intent principle to the durable record.

Every intent declares the current SOTA — existing alternatives and their rough maturity — then recommends one of three paths, each with its own gate:

  1. Build on the SOTA alternative (adopt as dependency) → hard stop: user approval (the standing new-dependency gate, reached through the SOTA declaration).
  2. Build a basic native version behind a real seam to adopt SOTA later → proceeds without a stop; the licence to skip approval is keeping adoption open. Default path (the native-floor-plus-opt-in pattern, adr-22/26/25).
  3. Bespoke, no viable seam → hard stop: user reviews to set the internal solution's complexity level. A merely deferred seam is still path 2.

Composes with prefer-sota (the adversary→verdict protocol that produces the SOTA read this principle declares). Its next promotion rung is an intent_sota record-lint gate + a ## SOTA intent-template section — noted in the file's Promotion section.

Docs-only; no code change.

Assisted-by: Claude:claude-opus-4-8

Every intent declares the current SOTA — existing alternatives and their
rough maturity — then picks one of three paths, each with its own gate:
build on the SOTA alternative (hard stop: new-dependency approval); build
a basic native version behind a real seam to adopt SOTA later (proceeds,
no stop); or commit to a bespoke solution with no viable seam (hard stop:
user sets the complexity level). A merely deferred seam is still path 2.
Extends prefer-sota; composes with the native-floor-plus-opt-in pattern.

Assisted-by: Claude:claude-opus-4-8
@REPPL
REPPL merged commit 3551a96 into main Jul 11, 2026
12 checks passed
@REPPL
REPPL deleted the docs/sota-per-intent-principle branch July 11, 2026 16:21
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.

1 participant