# Governance

Project governance model for Semantica.

!!! info "Open Source"
    Semantica is maintained by Hawksight AI with community contributions.

---

## 👥 Roles

**Maintainers** (Hawksight AI team)
- Review and merge pull requests
- Manage releases and code quality
- Community management and project direction

**Contributors**
- Submit code, documentation, and bug reports
- Help with issues and reviews
- Recognized in [CONTRIBUTORS.md](https://github.com/Hawksight-AI/semantica/blob/main/CONTRIBUTORS.md)

**Community Members**
- Use Semantica and provide feedback
- Share use cases and participate in discussions

---

## 🔄 Decision Process

### Code Changes
1. Proposal via GitHub Issues
2. Community discussion
3. Implementation (PR)
4. Review by maintainers
5. Approval (at least 1 maintainer)
6. Merge after CI passes

### Major Decisions
- RFC in GitHub Issues
- 1 week minimum discussion
- Maintainers decide based on community feedback and technical feasibility

---

## 📦 Releases

### Versioning (Semantic Versioning)
- **MAJOR**: Breaking changes
- **MINOR**: New features (backward compatible)
- **PATCH**: Bug fixes (backward compatible)

### Schedule
- **Major**: Quarterly or as needed
- **Minor**: Monthly or when ready
- **Patch**: As bugs are fixed

---

## 🔍 Code Review

**Criteria**: Functionality, code quality, tests, documentation, performance, security

**Timeline**: Initial review within 48 hours, follow-up within 7 days

**Guidelines**:
- Reviewers: Be constructive, explain reasoning
- Contributors: Address comments, ask questions, be open to feedback

---

## 💬 Communication

- **GitHub Issues**: Bug reports, features, questions
- **GitHub PRs**: Code contributions
- **GitHub Security Advisories**: [Report security issues](https://github.com/Hawksight-AI/semantica/security/advisories/new)

---

## 🎯 Project Goals

1. **Usability** - Easy to use and understand
2. **Reliability** - Production-ready quality
3. **Performance** - Efficient and scalable
4. **Extensibility** - Easy to extend
5. **Community** - Welcoming and inclusive

---

## 📄 License

MIT License - See [LICENSE](https://github.com/Hawksight-AI/semantica/blob/main/LICENSE)

---

**Contact**: [GitHub Issues](https://github.com/Hawksight-AI/semantica/issues)
