Skip to content

docs: restructure README value proposition around single operating model - #64

Merged
normenmueller merged 2 commits into
trunkfrom
docs/60-readme-value-proposition
May 7, 2026
Merged

docs: restructure README value proposition around single operating model#64
normenmueller merged 2 commits into
trunkfrom
docs/60-readme-value-proposition

Conversation

@normenmueller

Copy link
Copy Markdown
Owner

Story

closes #60 (S1: README Value Proposition Restructuring)
Parent Epic: #59

Changes

Restructures the README Value Proposition section to frame ai4X's USP as one operating model with three differentiating properties:

# Property Framing
1 Need-first Structured interview → declarative requirements set
2 Host-agnostic Declarations independent of runtime; materialize for any agent host
3 Self-validating (design goal) — ai4X applies its own model to itself (#eyodf)

Specific changes

  • IMPORTANT box: three named properties instead of two unnamed bullets
  • Details box: reframed as working toward the self-validating design goal
  • [^eyodf] footnote mechanism removed; #eyodf retained inline
  • No 'portable team' phrasing

Review remediation

  • Reframed Details <summary> from 'in practice' to 'works toward the self-validating design goal' (HIGH-1)

AC Coverage

AC Status
AC-1: Single operating model, three properties
AC-2: No footnote, #eyodf inline
AC-3: Self-validating as design goal
AC-4: Details box as self-validating manifestation
AC-5: No 'portable team'
AC-14: make verify passes

Frame ai4X's USP as one operating model with three differentiating
properties: need-first, host-agnostic, self-validating (design goal).

- Remove [^eyodf] footnote mechanism; promote #eyodf inline (AC-2)
- Mark self-validating explicitly as design goal (AC-3)
- Reframe Details box as self-validating property manifestation (AC-4)
- No 'portable team' phrasing (AC-5)
- make verify passes (AC-14)

closes #60
Replace 'in practice' with 'works toward the self-validating design
goal' to avoid factual claim about aspirational property (HIGH-1).
@normenmueller
normenmueller merged commit 49eb108 into trunk May 7, 2026
1 check passed
@normenmueller
normenmueller deleted the docs/60-readme-value-proposition branch May 7, 2026 22:39
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.

S1: README Value Proposition Restructuring

1 participant