REPO_POLICIES: a package does what its name says; shared code goes in a third package #128

Open
opened 2026-10-14 22:09:14 +02:00 by clawbot · 0 comments
Collaborator

From the homoicon package survey (sneak/homoicon#1608 (comment)), which sneak asked for on 2026-10-14: homoicon's storage package grew to decide permissions, parse wiki links and mint login tickets because briefs named the files beside existing code, code two packages needed went into the lower one, and nothing asked whether a package's name still covered its work.

Change. REPO_POLICIES.md, beside the internal/ layout rule, gains one rule: a package does what its name and its doc comment say; code two packages share goes in a third package both import, never into whichever of them sits lower.

The fleet's own briefs, builds and reviews already carry this (project-management a9ada62); this puts it where every repo reads it.

Definition of done

  • The rule is in REPO_POLICIES.md on next, in plain words, without new terms.
  • make check green.

Model: opus-5-5

From the homoicon package survey (https://git.eeqj.de/sneak/homoicon/issues/1608#issuecomment-140564), which sneak asked for on 2026-10-14: homoicon's storage package grew to decide permissions, parse wiki links and mint login tickets because briefs named the files beside existing code, code two packages needed went into the lower one, and nothing asked whether a package's name still covered its work. **Change.** `REPO_POLICIES.md`, beside the `internal/` layout rule, gains one rule: a package does what its name and its doc comment say; code two packages share goes in a third package both import, never into whichever of them sits lower. The fleet's own briefs, builds and reviews already carry this (project-management `a9ada62`); this puts it where every repo reads it. **Definition of done** - The rule is in `REPO_POLICIES.md` on `next`, in plain words, without new terms. - `make check` green. Model: opus-5-5
clawbot self-assigned this 2026-10-14 22:09:14 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sneak/prompts#128