Skip to content

Add CONTRIBUTING.md and a CLAUDE.md label rule - #67

Merged
mj-hahn merged 1 commit into
mainfrom
claude/great-knuth-vshx6f
Nov 13, 2026
Merged

mj-hahn merged 1 commit into
mainfrom
claude/great-knuth-vshx6f

Conversation

@mj-hahn

@mj-hahn mj-hahn commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Change

  • New CONTRIBUTING.md:
    • Claim an issue, and wait until it is assigned to you, before opening a pull request. A pull request for an issue not assigned to its author is closed without review.
    • One claimed issue at a time. A claim lapses after 7 days with no pull request.
    • Each pull request needs: one issue only, a test that fails before and passes after, the checks from docs/development.md, a changelog line, Closes #N, and the Change / User impact / Risk / Rollback / Evidence sections.
    • AI tools are allowed but must be disclosed and named.
  • New CLAUDE.md:
    • Agents use only bug, documentation and accessibility, and never apply good first issue, help wanted or a label that means the same. It gives the reason.
    • Agents flag outside pull requests for issues that aren't assigned, and don't merge them.
  • The README's Development section and docs/development.md link to CONTRIBUTING.md. The changelog has an entry under [Unreleased] → ### Added.
  • tests/test_contract.py: the doc link test now also checks CONTRIBUTING.md and CLAUDE.md.

User impact

Risk

  • Docs and one test only. One-way door: no.

Rollback

Revert the merge.

Evidence

  • python3 -m unittest tests.test_contract: 26 tests OK, 4 skipped (they need an installed Kiro Crew).

Generated by Claude Code

- CONTRIBUTING.md: claim an issue and wait to be assigned before opening a
  pull request; one claim at a time, lapsing after 7 days; a failing-first
  test, the checks, a changelog line, and disclosure of AI tools.
- CLAUDE.md: agents use only bug, documentation and accessibility, and never
  apply good first issue, help wanted or a label that means the same.
- README and docs/development.md link to CONTRIBUTING.md. The doc link
  contract test now covers both new files.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VstQaZZN5u1CtruQbjcLE
@mj-hahn
mj-hahn merged commit 0f383ac into main Nov 13, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants