feat(references): contributing to repositories you do not own - #162
Conversation
Every rule in this reference exists because skipping it produced a public artifact that had to be walked back, all in one upstream engagement (FriendsOfTYPO3/fractor, 2026-08-25): - Three keyword searches came back empty against a repo whose open issue described the same defect in different words, with the fix already in an open PR — the repo had six open issues, and reading the list would have taken a minute. Duplicate issue and PR both had to be closed. Hence: read the open issue AND PR lists; an empty search is first a broken query. - Two five-line comment blocks were the longest in the entire codebase until a reviewer asked why. Hence: measure comment density, do not import house style. - The PR went out non-draft and a documented contributing step (composer docs) was skipped. Hence: draft-first, run ALL of the contract. - The project's own rectify fixers rewrote four unrelated files during the gate run. Hence: revert what the fixer touched that you did not. - What ended the thread well: running the maintainer's competing fix against the own reproduction and answering with measured numbers, then closing the superseded PR in its favour. Hence the last two sections. SKILL.md gains a When-to-Use trigger and the reference row. main sat at 499 words of the 500-word cap, so existing prose is compressed to make room: "See X (a, b)" becomes "X: a, b", two headings lose filler words, one redundant reference parenthetical goes (the table row carries it), and one code comment drops context the neighbouring bullet already states. No guidance is removed. Assisted-by: claude-code:claude-opus-5 Agent-Session: https://claude.ai/code/session_01GSptxPLHWsttu9FuqVkvYZ Agent-Host: 0493f0 Signed-off-by: Sebastian Mendel <github@sebastianmendel.de>
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
|
|
Copilot review is unavailable — account-wide monthly quota. Reviewed the diff myself; what I checked beyond reading it:
What this cannot do: a reference only helps if it is read before the first artifact goes out — that is why the When-to-Use trigger exists, and it is the part I would most want a human eye on: is the trigger phrasing findable enough? Assisted by claude-code:claude-opus-5 — Session |
|
Self-review: 839286d The review this pull request demands is unsatisfiable (Copilot quota wall or repeated bot failures on this head). Per the documented fallback, the diff on this head was reviewed by the PR author; this comment is the on-the-record attestation the merge gate reads back. It stops matching on the next push. |



New reference: first contribution into a repository you do not own. Every rule in it exists because skipping it produced a public artifact that had to be walked back, all in one upstream engagement (FriendsOfTYPO3/fractor, 2026-08-25):
composer docswas skippedSKILL.mdgains the When-to-Use trigger and the reference row.mainsat at 499 of the 500-word cap, so existing prose is compressed to make room — the commit message lists each compression; no guidance is removed. Validator green (was the blocker), markdownlint green.Follow-through once merged: the project-local memory
feedback_read_the_issue_list_before_filing.mdin the nr-llm session memory gets re-homed to point here (promote-then-tombstone).Assisted by claude-code:claude-opus-5 — Session