3 ms·

Yesterday while i was adding some nitpicks to a CLAUDE.md/AGENTS.md file, I thought « this file could be renamed CONTRIBUTING.md and be done with it ». Maybe I

Yesterday while i was adding some nitpicks to a CLAUDE.md/AGENTS.md file, I thought « this file could be renamed CONTRIBUTING.md and be done with it ». Maybe I’m wrong but sure feels like we might soon drop all of this extra cruft for more rationale practices

nielstron 8mo ago
Exactly my thoughts... the model should just auto ingest README and CONTRIBUTING when started.
- rmnclmnt 8mo ago
  And that makes total sense. Honestly working since a few days with Opus 4.6, it really feels like a competent coworker, but need some explicit conventions to follow … exactly when onboarding a new IC! So i think there is a bright light to be seen: this will force having proper and explicit contribution rules and conventions, both for humans and robots
- delaminator 8mo ago
  You could have claude --init create this hook and then it gets into the context at start and resume Or create it in some other way { "hookSpecificOutput": { "hookEventName": "SessionStart", "additionalContext": "<contents of your file here>" } } I thought it was such a good suggestion that I made this just now and made it global to inject README at startup / resume / post compact - I'll see how it works out https://gist.github.com/lawless-m/fa5d261337dfd4b5daad4ac964c2ebd4 https://gist.github.com/lawless-m/fa5d261337dfd4b5daad4ac964... #!/bin/bash # ~/.claude/hooks/inject-readme.sh README="$(pwd)/README.md" if [ -f "$README" ]; then CONTENT=$(jq -Rs . < "$README") echo "{\"hookSpecificOutput\" :{\"hookEventName\":\"SessionStart\",\"additionalContext\":${CONTENT}}}" exit 0 else echo "README.md not found" >&2 exit 1 fi with this hook { "hooks": { "SessionStart": [ { "matcher": "startup|clear|compact", "hooks": [ { "type": "command", "command": "~/.claude/hooks/inject-readme.sh" } ] } ] } }
  - delaminator 8mo ago
    Unlike other content - what you put in here survives compacting
gordonhart 8mo ago
Exactly, it's the same documentation any contributor would need, just actually up-to-date and pared down to the essentials because it's "tested" continuously. If I were starting out on a new codebase, AGENTS.md is the first place I'd look to get my bearings.

nielstron 8mo ago

Exactly my thoughts... the model should just auto ingest README and CONTRIBUTING when started.

rmnclmnt 8mo ago
And that makes total sense. Honestly working since a few days with Opus 4.6, it really feels like a competent coworker, but need some explicit conventions to follow … exactly when onboarding a new IC! So i think there is a bright light to be seen: this will force having proper and explicit contribution rules and conventions, both for humans and robots
delaminator 8mo ago
You could have claude --init create this hook and then it gets into the context at start and resume Or create it in some other way { "hookSpecificOutput": { "hookEventName": "SessionStart", "additionalContext": "<contents of your file here>" } } I thought it was such a good suggestion that I made this just now and made it global to inject README at startup / resume / post compact - I'll see how it works out https://gist.github.com/lawless-m/fa5d261337dfd4b5daad4ac964c2ebd4 https://gist.github.com/lawless-m/fa5d261337dfd4b5daad4ac964... #!/bin/bash # ~/.claude/hooks/inject-readme.sh README="$(pwd)/README.md" if [ -f "$README" ]; then CONTENT=$(jq -Rs . < "$README") echo "{\"hookSpecificOutput\" :{\"hookEventName\":\"SessionStart\",\"additionalContext\":${CONTENT}}}" exit 0 else echo "README.md not found" >&2 exit 1 fi with this hook { "hooks": { "SessionStart": [ { "matcher": "startup|clear|compact", "hooks": [ { "type": "command", "command": "~/.claude/hooks/inject-readme.sh" } ] } ] } }
- delaminator 8mo ago
  Unlike other content - what you put in here survives compacting

gordonhart 8mo ago

Exactly, it's the same documentation any contributor would need, just actually up-to-date and pared down to the essentials because it's "tested" continuously. If I were starting out on a new codebase, AGENTS.md is the first place I'd look to get my bearings.