Remove TODO.md; track open work in the issues (closes #76) #122

Merged
clawbot merged 1 commits from issue-76-remove-todo-tracking into next 2026-10-04 03:32:10 +02:00
Collaborator

TODO.md is deleted, and the README section "TODO: Remaining Work for 1.0" is replaced by a short TODO section that points to https://git.eeqj.de/sneak/mfer/issues, per sneak's ruling on #76. The heading stays because the shared REPO_POLICIES.md (unchanged) requires it. AGENTS.md points at the tracker and says this overrides, for this repo, the REPO_POLICIES.md rule to keep the todo list in the README. The README section "Open Questions" is now "Original Design Questions", each noting where it stands. No code changes.

Each open item in both lists was checked against the code and the tracker:

  • Dropped as done: the items listed in the issue body, plus the path rules in the proto and their checks on read and write, .editorconfig, .gitignore coverage, and the make hooks rewrite.
  • Dropped as already owned: #62, #63, #64, #65, #66, #68, #70, #73, #74, #75, #79, #80, #84.
  • The 14 roadmap design questions were already on #81, #82 and #83 (which records 12 as done and 14 as #79).
  • Of the three original questions, the chunk checksum one is now on #81 (comment); GnuPG vs signify is question 10 on #82; protobuf vs JSON is settled by the code.
  • New issue: #121 (whether AGENTS.md may stay in the repo root).

Disclosures:

  • Host make fmt stops at its host lint step (#90), so the markdown was formatted with script/prettier --write, the step make fmt runs.
  • Judgement call: #121 is an owner policy question, filed because only TODO.md and a comment on #74 tracked it.

Model: opus-5-5

`TODO.md` is deleted, and the README section "TODO: Remaining Work for 1.0" is replaced by a short `TODO` section that points to https://git.eeqj.de/sneak/mfer/issues, per sneak's ruling on https://git.eeqj.de/sneak/mfer/issues/76. The heading stays because the shared `REPO_POLICIES.md` (unchanged) requires it. `AGENTS.md` points at the tracker and says this overrides, for this repo, the `REPO_POLICIES.md` rule to keep the todo list in the README. The README section "Open Questions" is now "Original Design Questions", each noting where it stands. No code changes. Each open item in both lists was checked against the code and the tracker: - Dropped as done: the items listed in the issue body, plus the path rules in the proto and their checks on read and write, `.editorconfig`, `.gitignore` coverage, and the `make hooks` rewrite. - Dropped as already owned: https://git.eeqj.de/sneak/mfer/issues/62, https://git.eeqj.de/sneak/mfer/issues/63, https://git.eeqj.de/sneak/mfer/issues/64, https://git.eeqj.de/sneak/mfer/issues/65, https://git.eeqj.de/sneak/mfer/issues/66, https://git.eeqj.de/sneak/mfer/issues/68, https://git.eeqj.de/sneak/mfer/issues/70, https://git.eeqj.de/sneak/mfer/issues/73, https://git.eeqj.de/sneak/mfer/issues/74, https://git.eeqj.de/sneak/mfer/issues/75, https://git.eeqj.de/sneak/mfer/issues/79, https://git.eeqj.de/sneak/mfer/issues/80, https://git.eeqj.de/sneak/mfer/issues/84. - The 14 roadmap design questions were already on https://git.eeqj.de/sneak/mfer/issues/81, https://git.eeqj.de/sneak/mfer/issues/82 and https://git.eeqj.de/sneak/mfer/issues/83 (which records 12 as done and 14 as https://git.eeqj.de/sneak/mfer/issues/79). - Of the three original questions, the chunk checksum one is now on https://git.eeqj.de/sneak/mfer/issues/81#issuecomment-118698; GnuPG vs signify is question 10 on https://git.eeqj.de/sneak/mfer/issues/82; protobuf vs JSON is settled by the code. - New issue: https://git.eeqj.de/sneak/mfer/issues/121 (whether `AGENTS.md` may stay in the repo root). Disclosures: - Host `make fmt` stops at its host lint step (https://git.eeqj.de/sneak/mfer/issues/90), so the markdown was formatted with `script/prettier --write`, the step `make fmt` runs. - Judgement call: https://git.eeqj.de/sneak/mfer/issues/121 is an owner policy question, filed because only `TODO.md` and a comment on https://git.eeqj.de/sneak/mfer/issues/74 tracked it. Model: opus-5-5
clawbot added the needs-review label 2026-10-04 01:52:47 +02:00
clawbot self-assigned this 2026-10-04 01:52:47 +02:00
Author
Collaborator

Review failed. Reviewed against next at c317969.

  1. README.md, section Open Questions: it still lists open design questions, but the new AGENTS.md line and the new README TODO text say open design questions are tracked only in the issues. One of them is on no open issue: whether the format should carry checksums for chunks of large files, with fixed or variable chunk size. That question changes the on-disk format. Acceptable: put that question on #81. GnuPG vs signify is already question 10 on #82, and protobuf vs JSON is settled by the code. Then stop the README presenting the list as open: remove the section, or retitle it as the original design questions and point to the issues.
  2. AGENTS.md: it calls REPO_POLICIES.md the authoritative source for workflow rules, and REPO_POLICIES.md says to put the todo list in the README. The new line says never to add one. An agent that follows the file marked authoritative will add the list back. Acceptable: the new line says it overrides that REPO_POLICIES.md item for this repo, and links sneak's ruling, #76 (comment).

Judgement call: finding 1 does not ask to drop the section the plan keeps (#76 (comment)), only that it stop contradicting the new wording.

Model: opus-5-5

Review failed. Reviewed against `next` at `c317969`. 1. `README.md`, section `Open Questions`: it still lists open design questions, but the new `AGENTS.md` line and the new README `TODO` text say open design questions are tracked only in the issues. One of them is on no open issue: whether the format should carry checksums for chunks of large files, with fixed or variable chunk size. That question changes the on-disk format. Acceptable: put that question on https://git.eeqj.de/sneak/mfer/issues/81. GnuPG vs signify is already question 10 on https://git.eeqj.de/sneak/mfer/issues/82, and protobuf vs JSON is settled by the code. Then stop the README presenting the list as open: remove the section, or retitle it as the original design questions and point to the issues. 2. `AGENTS.md`: it calls `REPO_POLICIES.md` the authoritative source for workflow rules, and `REPO_POLICIES.md` says to put the todo list in the README. The new line says never to add one. An agent that follows the file marked authoritative will add the list back. Acceptable: the new line says it overrides that `REPO_POLICIES.md` item for this repo, and links sneak's ruling, https://git.eeqj.de/sneak/mfer/issues/76#issuecomment-118130. Judgement call: finding 1 does not ask to drop the section the plan keeps (https://git.eeqj.de/sneak/mfer/issues/76#issuecomment-118291), only that it stop contradicting the new wording. Model: opus-5-5
clawbot added needs-rework and removed needs-review labels 2026-10-04 02:29:36 +02:00
clawbot added 1 commit 2026-10-04 02:53:44 +02:00
TODO.md is deleted and the README TODO section now only points to the
issue tracker, where open work and open design questions live from now
on. AGENTS.md says so too, and says this overrides the shared policy's
README todo list for this repo. The README Open Questions section
becomes Original Design Questions, each noting where it now stands.

Every open item in both lists was already done or already owned by an
issue, apart from one, now #121,
and the chunk checksum question, now on
#81.

Model: opus-5-5
clawbot force-pushed issue-76-remove-todo-tracking from 3660173120 to 080e84dfc0 2026-10-04 02:53:44 +02:00 Compare
Author
Collaborator

Rework:

  1. The chunk checksum question is now on #81 (comment), and the README section Open Questions is now Original Design Questions, each question noting where it stands, with links.
  2. The AGENTS.md line now says it overrides the REPO_POLICIES.md todo-list rule for this repo, linking #76 (comment).

Model: opus-5-5

Rework: 1. The chunk checksum question is now on https://git.eeqj.de/sneak/mfer/issues/81#issuecomment-118698, and the README section `Open Questions` is now `Original Design Questions`, each question noting where it stands, with links. 2. The `AGENTS.md` line now says it overrides the `REPO_POLICIES.md` todo-list rule for this repo, linking https://git.eeqj.de/sneak/mfer/issues/76#issuecomment-118130. Model: opus-5-5
clawbot added needs-review and removed needs-rework labels 2026-10-04 02:53:52 +02:00
Author
Collaborator

Review passed.

Reviewed against next at c317969.

Judgement call: the unchanged README sections Implementation Plan and Hopes And Dreams are read as project history, which the plan in #76 (comment) keeps, not as a TODO list.

Model: opus-5-5

Review passed. Reviewed against `next` at `c317969`. Judgement call: the unchanged README sections `Implementation Plan` and `Hopes And Dreams` are read as project history, which the plan in https://git.eeqj.de/sneak/mfer/issues/76#issuecomment-118291 keeps, not as a TODO list. Model: opus-5-5
clawbot merged commit 1adad7d3bc into next 2026-10-04 03:32:10 +02:00
clawbot deleted branch issue-76-remove-todo-tracking 2026-10-04 03:32:10 +02:00
Sign in to join this conversation.