docs: add collaboration process and improve project context#3
Merged
allaspectsdev merged 1 commit intomainfrom Mar 30, 2026
Merged
docs: add collaboration process and improve project context#3allaspectsdev merged 1 commit intomainfrom
allaspectsdev merged 1 commit intomainfrom
Conversation
- Add CONTRIBUTING.md with full collaboration workflow (claiming work, PR sizing, review process, disagreement resolution, discussion venues) - Expand CLAUDE.md with architecture decisions, module ownership, error handling policy, and dependency guidelines - Update PR template with approach section and CLAUDE.md checklist - Update README contributing section to reference CONTRIBUTING.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes no specific issue — this establishes the collaboration workflow for both developers.
Approach
Took the process questions that naturally come up when two Claude Code users share a repo and turned them into concrete, lightweight conventions. Expanded CLAUDE.md to be a real shared context doc rather than a skeleton.
Changes
CONTRIBUTING.md (new) — Full collaboration workflow:
CLAUDE.md (expanded) — Added:
PR template (updated) — Added Approach section and CLAUDE.md checklist
README — Contributing section now references CONTRIBUTING.md
CLAUDE.md
Notes for Reviewer
This is purely documentation — no code changes. It's meant to start a conversation about process, not dictate it. Push back on anything that doesn't work for you.