Repository navigation
give the front page one install path and put the problem before it - #59
Merged
Merged
Conversation
The motivation paragraphs sat inside `## Quick start` with no heading of their own, so the page told a reader how to install before telling them what the problem was, and then explained the problem as if it were a step of the installation. Two install blocks disagreed: `uv sync --extra dev` under Quick start and `uv venv && uv pip install -e ".[dev]"` under Development setup. One canonical block now carries the facts the second one existed to state. The component table spent seventeen rows repeating the word "done". Replaced with the loop in prose and a table of the flags that actually switch something — which required checking them against `harbor_native_agent`, where two of the names I had written down do not exist: retrieval is `driftlock_agentic_retrieval`, and compaction has no boolean at all (it is always on, bounded by `driftlock_max_history_characters`). MCP's absence from the harness is stated with its reason rather than left looking like an oversight. Dropped the stars badge. A star count is a live claim about traction, and putting it on the page makes the page argue about the wrong thing.
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.
The repository page reads as finished, so this is about the four places it still misleads a first-time reader rather than about what is missing.
The problem statement sat inside
## Quick start. Two paragraphs of motivation — the four-hour task cliff, context rot versus goal drift — were rendered as if they were a step of the installation, and a reader gotuv syncbefore they got a reason to care. They now have their own section, above the install.Two install blocks disagreed. Quick start said
uv sync --extra dev; a later "Development setup" saiduv venv && uv pip install -e ".[dev]". Neither was wrong, which is worse than one being wrong — a newcomer has to guess which one this project actually means. One block remains, carrying the facts the second existed to state.The component table repeated "done" seventeen times. A column whose every cell is identical is not a status, and it displaced the fact a reader needs: which of these switch anything. It is now the loop in prose, plus a table of the flags.
Checking those flag names against
harbor_native_agent.pyfound two of them do not exist. Retrieval isdriftlock_agentic_retrieval, notdriftlock_retrieval. Compaction has no boolean at all — it is always on, bounded bydriftlock_max_history_characters, so listing it as opt-in was wrong in both directions. MCP's absence from the harness is now stated with its reason, rather than reading as an omission.Dropped the stars badge. A star count is a live claim about traction; putting one on the page makes the page argue about the wrong thing, and this page's argument is the measurement.
Gates
Documentation only — no source or test file is touched, so the suite is unchanged at 1277 passed, 3 skipped and Gate 4 does not apply. Every local link in
*.mdanddocs/*.mdresolves, checked by walking the link targets.