References
Reference categories for adapting the enterprise project handbook to a specific organization.
This handbook is an operating framework. Adapt it with source material from the organization, platform, and product context where the project runs.
Source Categories
| Category | Examples | Use |
|---|---|---|
| Architecture records | ADRs, diagrams, system maps | Boundary and dependency decisions |
| Platform docs | Hosting, CI, cache, environment rules | Deployment and build governance |
| Product docs | Roadmaps, user flows, feature specs | App and package ownership |
| Security docs | Access policy, data classification, incident policy | Governance and review gates |
| Operational docs | Runbooks, dashboards, postmortems | Monitoring and incident practice |
| Team docs | Ownership map, onboarding, review rules | Collaboration and escalation |
Current Source Anchors
| Area | Source |
|---|---|
| Next.js | Next.js 16 upgrade guide, Proxy, Cache Components |
| Turborepo | Turborepo 2.9, caching, filtering, configuration |
| Vercel | Rolling Releases, Deployment Protection, Fluid Compute |
| Skills | skills.sh and Vercel Skills v1.1.1 changelog |
| Codex | Managed configuration, hooks, approvals and security |
Documents to Maintain
- Repository architecture map
- Workspace ownership table
- Shared package contract rules
- CI/CD pipeline diagram
- Environment variable inventory
- Security review checklist
- Incident runbooks and postmortems
- Agent context packs and reusable skills
- Copy-ready operating templates for CI, CODEOWNERS, agent policy, and incidents
Review Cadence
Review references during major architecture changes, team expansion, new deployment targets, security incidents, and recurring CI or production failures.