generated from practical-stack/turborepo-template
-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
docDocumentation changesDocumentation changes
Description
Context
This project (oss-kit) is designed to be used as a template for general OSS projects. It leverages Claude custom commands to streamline the entire contribution workflow from issue creation to PR submission. Currently, there is no CONTRIBUTION.md to guide contributors through this workflow. The README.md references CONTRIBUTION.md but the file doesn't exist yet, and the project will soon be ready to accept external contributions.
Requirement
Create a comprehensive CONTRIBUTION.md that documents the complete contribution workflow using Claude custom commands:
- Creating issues with
/issue-task - Creating branches with
/branch - Planning implementation with
/plan - Committing changes with
/commit - Creating pull requests with
/pr
The documentation should be suitable for general OSS projects and provide clear, step-by-step guidance.
Content Outline
- Welcome and Prerequisites (Claude Code setup, gh CLI)
- Complete Contribution Workflow
- Step 1: Create an Issue (
/issue-task) - Step 2: Create a Branch (
/branch) - Step 3: Plan Implementation (
/plan) - Step 4: Commit Changes (
/commit) - Step 5: Create Pull Request (
/pr)
- Step 1: Create an Issue (
- Commit Convention (reference to CONVENTIONAL_COMMITS.md)
- Code of Conduct reference
- Getting Help
Verification
- Ensure all custom commands are accurately documented
- Verify workflow steps are in correct order
- Test that examples match actual command behavior
- Check that links to other documents (CONVENTIONAL_COMMITS.md, CODE_OF_CONDUCT.md) are correct
- Verify the workflow is suitable for general OSS projects
Reference
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
docDocumentation changesDocumentation changes
Type
Projects
Status
Todo