Skip to content

The page contract, and what this repo's page test does not assert - #16

Merged
P0w3r223 merged 1 commit into
mainfrom
fix/the-readme-is-a-surface-too
Sep 6, 2026
Merged

P0w3r223 merged 1 commit into
mainfrom
fix/the-readme-is-a-surface-too

Conversation

@P0w3r223

@P0w3r223 P0w3r223 commented Sep 6, 2026

Copy link
Copy Markdown
Owner

Three reviews over the twelve CLAUDE.md, the thirteen READMEs and the index record.

  • The tooling section told a reader to prefer an MCP server over Grep and to fall back only
    when the graph does not cover the question. That server is declared in this repository's
    .mcp.json, so it is absent whenever the session starts one directory up, and neither
    index has a hook. Rewritten to say both.
  • sitegen/ listed three modules of seven. The four missing include numbers.py, which
    exists because one figure once shipped as 14,745 and 14 745 from two call sites, and
    theme.py, which is the file the page-spec work touches.
  • The page contract governs eleven surfaces and was stated in none of the twelve files.
    Stated here - including that tests/test_site_committed.py is not its local carrier:
    it asserts byte-equality with the generator and the import budget, and no clause.

Three reviews over the twelve `CLAUDE.md`, the thirteen READMEs and the index record.

* The tooling section told a reader to prefer an MCP server over Grep and to fall back only
  when the graph does not cover the question. That server is declared in this repository's
  `.mcp.json`, so it is absent whenever the session starts one directory up, and neither
  index has a hook. Rewritten to say both.
* `sitegen/` listed three modules of seven. The four missing include `numbers.py`, which
  exists because one figure once shipped as `14,745` and `14 745` from two call sites, and
  `theme.py`, which is the file the page-spec work touches.
* The page contract governs eleven surfaces and was stated in none of the twelve files.
  Stated here - including that `tests/test_site_committed.py` is **not** its local carrier:
  it asserts byte-equality with the generator and the import budget, and no clause.
@P0w3r223
P0w3r223 merged commit 433083d into main Sep 6, 2026
2 checks passed
@P0w3r223
P0w3r223 deleted the fix/the-readme-is-a-surface-too branch September 6, 2026 20:36
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