open/repo-mailbox
1
0
Fork 0
Code Issues Releases 2 Activity

docs(readme): fence the Install block so the start command is machine-findable

Browse source 
Order 20260820T221658Z (.claude D-census): repo-mailbox was reported as the
only plugin of 12 on the org side with no start command in any code block.

Premise verified before acting, and it was imprecise: both start lines were
already present at README.md:74-75, in an INDENTED code block. What the
census actually measured is real, though - its query keys on a fenced block,
and measuring the sibling READMEs here confirms 10 of 11 use one while
repo-mailbox was the sole outlier. So D2b failed for the reason given, just
not for the reason stated.

Only the Install block is converted to ```bash. The README's other 39
indented blocks are its house style, were not ordered changed, and would
have buried a two-line fix in a whole-file diff. CLAUDE.md records the
asymmetry so it does not get harmonized back.

Re-measured after the change with the same query and its known-positive
control: 11 of 11 sibling plugin READMEs now match, denominator reported.

No version bump, no tag, no catalog update - the catalog already points at
the newest tag.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-08-26 12:17:08 +02:00
commit c5b4c9d6b6
2 changed files with 16 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

12
CLAUDE.md
View file

@ -1036,6 +1036,18 @@ obligations in another repo.
`bash scripts/state-line-guard-selftest.sh` must exit 0 (54/54).
- English for all code, docs, and commit messages (public repo). Norwegian
trigger aliases in the skill description are deliberate.
- **README's Install block is FENCED (```bash) while the rest of the README
uses indented code blocks, and that asymmetry is deliberate - do not
"harmonize" it.** The org-side D-census (`.claude`, ordre
20260820T221658Z) reported repo-mailbox as the only plugin of 12 with no
start command, with a known-positive control proving its query could find
one in the other 10. The commands were in fact present, in an INDENTED
block - so the census's wording overstated the null, but its finding held:
the machine-readable entry point (D2b) keys on a fenced block, and 10 of
11 sibling plugin READMEs use one. Measured here before changing anything,
and re-measured after: 11 of 11 now match. Only the Install block was
converted; converting the other 39 indented blocks was not ordered and
would bury a two-line fix in a whole-file diff.
- Conventional Commits: `type(scope): description`.
## Commands

6
README.md
View file

@ -71,8 +71,10 @@ Message format (filename `<UTC-timestamp>-<uniq>-from-<sender>.md`):
## Install
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
claude plugin install repo-mailbox@ktg-plugin-marketplace
```bash
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
claude plugin install repo-mailbox@ktg-plugin-marketplace
```
The plugin ships empty: your mailbox is created lazily on first send, on your machine, and stays there.