docs: the README describes the tool it has become - #76
Merged
Conversation
It still opened "CLI tooling for a personal knowledge base that an LLM builds and maintains", which was true nine PRs ago. The tagline is now what the thing does: clone yourself from your corpus of work. Adds the section that matters most for anyone reading this repository cold — the six safeguards, stated as what they are: lint errors and refusals rather than instructions an agent can talk itself out of. Alongside, the persona contract with the review commands beside it, the seven-rung ladder with the reasoning for where `learn` and `extend` sit, `extrapolated` in the article format, and one publishing section covering both artifacts. Trimmed back where the old text had gone slack, so a considerably larger product costs 3 KB more rather than 5. docs/clone.md marks what shipped and, more usefully, records the two places the design was wrong. `learn` moved below `compile`: "a corpus read after the fact shaped nothing" was overstated, since compiling a document *is* the close reading that makes mining it cheap. And `review` was never renamed to `revise`. The rename was proposed to free the word for the human gate, and the gate turned out to need a *command* rather than a rung — `sentinel review` reads correctly beside a `review` rung meaning stalled drafts, because the two never appear in the same sentence. Renaming would have broken every `--action review` in the wild to solve a collision that did not exist, which is also why `SCHEMA_VERSION` stays at 1: everything this stack added to a payload is an optional field. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
khaneight
force-pushed
the
feat/clone-docs
branch
from
August 27, 2026 02:25
f5c45a5 to
fbb6eb9
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #75. Last PR in the stack.
The README still opened "CLI tooling for a personal knowledge base that an LLM
builds and maintains" — true nine PRs ago.
What changed
to hit first. The six safeguards, stated as what they are — lint errors and
refusals, not instructions an agent can talk itself out of.
that an agent writes
proposedand can never writeaffirmed.learnsits belowcompileandextendnear the bottom, and why approval is deliberately not a rung.
extrapolatedin the article format, and whyraw/can never hold it.showcase for watching.
Trimmed elsewhere, so a considerably larger product costs 3 KB more rather than
5.
The design doc records where it was wrong
More useful than the ticks. Two calls in #67 did not survive contact:
learnmoved belowcompile. "A corpus read after the fact shapednothing" was overstated — compiling a document is the close reading that
makes mining it cheap, and what a thin profile degrades is generated work, four
rungs further down.
reviewwas never renamed torevise. The rename was proposed to free theword for the human gate. The gate turned out to need a command, not a rung,
and
sentinel reviewreads fine beside areviewrung meaning stalled drafts —the two never appear in the same sentence. Renaming would have broken every
--action reviewin the wild to solve a collision that did not exist.That is also why
SCHEMA_VERSIONstays at 1: everything this stack added toa payload is an optional field.
531 tests, clippy and fmt clean.
🤖 Generated with Claude Code