# Internal Documentation

> Strategic and operational documents for the VenomQA team.

---

## Document Index

| Document | Purpose | Audience |
|----------|---------|----------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | Technical architecture overview | Developers |
| [DECISIONS.md](DECISIONS.md) | Architecture Decision Records | Developers, Leadership |
| [TECH_DEBT.md](TECH_DEBT.md) | Technical debt tracker | Developers |
| [COMPETITIVE_ANALYSIS.md](COMPETITIVE_ANALYSIS.md) | Market positioning | Leadership, Marketing |
| [METRICS.md](METRICS.md) | KPIs and success metrics | Leadership |
| [ONBOARDING.md](ONBOARDING.md) | New contributor guide | New developers |
| [RELEASE.md](RELEASE.md) | Release process | Maintainers |

---

## Also See

| Document | Location | Purpose |
|----------|----------|---------|
| [PROJECT_TRACKER.md](../PROJECT_TRACKER.md) | Root | Roadmap, issues, sprint tracking |
| [CONTRIBUTING.md](../CONTRIBUTING.md) | Root | Public contribution guide |
| [CHANGELOG.md](../CHANGELOG.md) | Root | Version history |

---

## Updating These Docs

- **Architecture**: Update when making structural changes
- **Decisions**: Add new ADR for each significant decision
- **Tech Debt**: Add items as discovered, close when fixed
- **Competitive**: Review quarterly
- **Metrics**: Update targets quarterly
- **Onboarding**: Update when dev setup changes
- **Release**: Update when process changes

---

## Document Ownership

| Document | Owner | Review Cadence |
|----------|-------|----------------|
| ARCHITECTURE | Tech Lead | On change |
| DECISIONS | Tech Lead | On decision |
| TECH_DEBT | All devs | Weekly |
| COMPETITIVE | Product | Quarterly |
| METRICS | Leadership | Monthly |
| ONBOARDING | Tech Lead | Monthly |
| RELEASE | Maintainers | On change |
