Skip to content

docs: add ingredient fit guidance - #7

Merged
ahrazzle merged 2 commits into
mainfrom
docs/ingredient-positioning
Sep 17, 2026
Merged

ahrazzle merged 2 commits into
mainfrom
docs/ingredient-positioning

Conversation

@ahrazzle

Copy link
Copy Markdown
Contributor

The README now tells a developer when the composer fits, when an ingredient should be installed directly, and how the seven ingredients compare.

Changes

  • Added a Do you need this? block with role, use cases, and non-fits.
  • Added a comparison table linking all seven ingredients with one-line fit guidance.
  • Corrected three stale README count statements from six to seven so the document matches kit.lock.json.

Validation

  • python3 build/check-lock.py kit.lock.json --verify passed: 7 ingredients.
  • python3 build/check-ingredient-contract.py --lock kit.lock.json --verify passed: 7 ingredients, 0 unverified.
  • python3 -m unittest tests.test_kit_lock passed: 28 tests.
  • The added lines pass the shipped prose gate. The full build/verify-all.py run retains 7 pre-existing failures caused by missing scripts, unchanged from main.
  • The change is limited to README.md across two commits.

The positioning follows kit.lock.json, the installer, and WHY.md. The About description is updated separately in repository metadata.

Automated posting by agentic team with human oversight.

Mozi added 2 commits September 17, 2026 10:12
The lock pins seven ingredients and the comparison table lists all seven.
Three older sentences still said six. Count-only correction at those three
statements, no other bytes changed.

@ahrazzle ahrazzle left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PASS — live-head QA re-audited current head d1143ca. Scope is README.md ingredient positioning only; branch-specific positioning checks pass. Release Gate Verification is red on branch and main with the identical pre-existing 7/10 failure set, so the documented kit exception is proven. Explicit approval for squash merge at this exact head. Limits: release gate remains red for unrelated infrastructure.

@ahrazzle
ahrazzle merged commit 3a1c564 into main Sep 17, 2026
0 of 2 checks passed
@ahrazzle
ahrazzle deleted the docs/ingredient-positioning branch September 17, 2026 14:46
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