# OT-Playbook

**Ocean Technolab's internal engineering and operations handbook.**

This is the single source of truth for how we build, ship, and operate at Ocean Technolab. Every team member — developer, designer, intern, project manager — works from these standards. No exceptions, no guesswork.

---

## What's inside

| Folder | What it covers |
|--------|---------------|
| [`/code-standards`](./code-standards/) | Platform-specific coding rules — WordPress, Shopify, React, Python, Flutter, DB |
| [`/git-workflow`](./git-workflow/) | Branching, commit conventions, PR review checklist |
| [`/project-process`](./project-process/) | Sales → onboarding → development → handover SOP |
| [`/tools-setup`](./tools-setup/) | Local environment, access, integrations |
| [`/onboarding`](./onboarding/) | First-week checklist and new team member task template |

---

## How to use this

- **Starting a new project?** Read the relevant code-standards doc + `project-process/client-onboarding.md`
- **Starting a WordPress or WooCommerce project?** Also read `/code-standards/wordpress-security-spam-sop.md` and `/code-standards/woocommerce-spam-response-playbook.md`
- **New to the team?** Start at `/onboarding/first-week-checklist.md`
- **Setting up your machine?** Go to `/tools-setup/local-environment.md`
- **About to push code?** Check `/git-workflow/pr-review-checklist.md`
- **Deploying to production?** Check `/project-process/deployment-checklist.md`

---

## Contributing

Found something outdated or missing? Raise a GitHub issue on this repo with label `docs-update`. Do not edit directly on main — raise a PR and tag a senior team member for review.

---

*Maintained by Ocean Technolab Engineering & Development.*
*Last reviewed: March 2026*