Login
Check-in [cc71cf7c36]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Add the writing guide for every project

Intent: give every project one guide to writing documents a newcomer can follow, in service of the first virtue, Clarity, as the maintainer approved as an approach (ocx-console post 7607cc4e76) and run-194d2a3d asked on ollama post c68bcb0b5d.

Expression: docs/writing.md is the guide as posted, unchanged; its one link already works. README.md links it beside the virtues; knowledge-map.json lists it under "The words and the map", and docs/knowledge-map.md is regenerated from it.

Demonstrates: crystal run ci.cr is green in this trunk checkout (599 examples, 0 failures, coverage 100.0%), including spec/guards/documents_spec.cr, which renders every document and its links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TUH8KKBs1b4wzoSCq6zh7U

Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: cc71cf7c36f0cd32b19dcef3f8885e2421f2a74644948c44e56e5c991a3f65cd
User & Date: x86-1-session 2026-11-09 23:09:55.832
Context
2026-11-09
23:31
Propose axiom 6, Every mind is bounded

Intent: lock in the maintainer's new axiom as a clear proposal, to be tested against experience, with precepts OCX can hold itself to (ocx-console posts 0d2541697a and 4000082c63, relayed by run-194d2a3d on ollama post c9e8a3a7d5).

Expression: README.md adds axiom 6, marked proposed, with its two consequences (every extra syntax is a barrier; many eyes outlast one) and one line on how it relates to axiom 4, Entropy and drift. PLAN.md adds two proposed precepts, One Syntax and Shared Foundations, outside the precept table, since a precept enters the table only with a guard spec; each names the guard it could have. PLAN.md also starts "Testing the axiom" with two cases: Glint's "Words used here" glossary and Glint's choice of Linux and Zephyr. knowledge-map.json lists the new PLAN.md topics, and docs/knowledge-map.md is regenerated.

Demonstrates: crystal run ci.cr in this trunk checkout passed every guard, spec/guards/documents_spec.cr and spec/guards/ledger_spec.cr included. Its one error was spec/ocx/run_pages_spec.cr:219, the known random lock failure (ticket 00817df826), which passes when rerun alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TUH8KKBs1b4wzoSCq6zh7U check-in: 2b9add595b user: x86-1-session tags: trunk

23:09
Add the writing guide for every project

Intent: give every project one guide to writing documents a newcomer can follow, in service of the first virtue, Clarity, as the maintainer approved as an approach (ocx-console post 7607cc4e76) and run-194d2a3d asked on ollama post c68bcb0b5d.

Expression: docs/writing.md is the guide as posted, unchanged; its one link already works. README.md links it beside the virtues; knowledge-map.json lists it under "The words and the map", and docs/knowledge-map.md is regenerated from it.

Demonstrates: crystal run ci.cr is green in this trunk checkout (599 examples, 0 failures, coverage 100.0%), including spec/guards/documents_spec.cr, which renders every document and its links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TUH8KKBs1b4wzoSCq6zh7U check-in: cc71cf7c36 user: x86-1-session tags: trunk

06:16
Name OCX's checks for the agent's test tool

Intent: let an agent's save run OCX's checks before it commits, as the maintainer approved (ocx-console post fe5ad9e6e8). The first Gemma run's ocx_test answered "the project names no tests", so its save committed with none run (ticket 29062db5de).

Expression: ocx-tests.json at the root names one test, ci, as crystal run ci.cr, which ocx_test runs and save requires to pass.

Demonstrates: crystal run ci.cr in a trunk checkout with the file is green: 599 examples, 0 failures, coverage 100.0%. The next Gemma run's ocx_test on ticket 29062db5de shows it run by the agent.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TUH8KKBs1b4wzoSCq6zh7U check-in: a043a3fba0 user: x86-1-session tags: trunk

Changes
Unified Diff Side-by-Side Diff Patch
Changes to README.md.
Changes to docs/knowledge-map.md.
Added docs/writing.md.
Changes to knowledge-map.json.