CONTRIBUTING.md

Contributing to the RapidKit Ecosystem Hub

Thanks for contributing to RapidKit.

This repository is the ecosystem hub, not an implementation repo. Please use it for:

• ecosystem architecture updates
• roadmap proposals
• cross-repo governance improvements
• platform positioning and contributor experience improvements

Where to Open Issues

• CLI behavior/issues: rapidkit-npm
• VS Code extension behavior/issues: rapidkit-vscode
• Engine/generation/contracts: rapidkit-core
• Example app quality and scenarios: rapidkit-examples
• Cross-repo architecture or direction: this repository

Contributing to Specific Repos

• CLI: rapidkit-npm contributing guide
• IDE: rapidkit-vscode contributing guide
• Core Engine: rapidkit-core contributing guide
• Examples: rapidkit-examples contributing guide

Contribution Workflow

1. Open an issue describing the proposal and affected repos.
2. Include impact analysis:
   • contract impact
   • migration impact
   • docs impact
3. Submit a PR with focused scope.
4. Add links to dependent PRs in other repositories if needed.

PR Quality Expectations

• Keep changes minimal and explicit
• Prefer clear structure over long narrative
• Update linked docs when architecture decisions change
• Avoid mixing unrelated improvements in one PR

Commit and PR Hygiene

• Use clear commit messages
• Use descriptive PR titles and summaries
• Include rollout notes for cross-repo changes

Code of Collaboration

• Be respectful and evidence-driven
• Assume positive intent
• Prefer reproducible examples when proposing changes