Skip to content

Commit 811f48b

Browse files
authored
docs: add CLAUDE.md pointer and contributor-attribution rule
Verification: reviewed PR diff; docs-only change to AGENTS.md plus CLAUDE.md. GitHub merge state was CLEAN and Vercel status check was successful.
1 parent 073f7b4 commit 811f48b

2 files changed

Lines changed: 23 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,19 @@ git pull --rebase && git push
165165
- If a conflict touches a file you didn't modify, abort the rebase and ask the user.
166166
- NEVER force-push.
167167

168-
### User Override
168+
### Contributor Attribution
169+
170+
When you re-land or build on another person's work (a fork PR, an issue author's proposal, a co-author), credit the human contributor with a working GitHub-linked trailer so they appear in the contributors graph:
171+
172+
```
173+
Co-authored-by: Name <ID+username@users.noreply.github.com>
174+
```
175+
176+
- Use the numeric-id no-reply form. Get the id with `gh api users/<login> --jq .id`.
177+
- Never use a machine or `.local` email in a co-author trailer; it links to no account and gives zero credit.
178+
- When a squash-merge collapses a contributor's PR into an internal branch, preserve their `Co-authored-by:` line in the squash commit message.
179+
- This applies to human contributors only. Do not add trailers or credit lines naming an AI model, assistant, vendor, or coding harness.
180+
181+
## User Override
169182

170183
If the user's instructions conflict with the rules above, ask for confirmation that they want to override the rules. Only then execute their instructions.

CLAUDE.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# CLAUDE.md — coven-code
2+
3+
Read [`AGENTS.md`](AGENTS.md). It is the canonical agent-facing ruleset for this
4+
repo: code quality bar, commands, CI gates, issue/PR-comment conventions, git
5+
workflow, and contributor attribution.
6+
7+
The Rust-scoped rules in `src-rust/.claude/CLAUDE.md` extend these; when the two
8+
disagree, the rule closer to the code wins. There is no separate Claude-only
9+
workflow at the repo root — follow `AGENTS.md`.

0 commit comments

Comments
 (0)