- Yarn workspaces monorepo for React Native Firebase.
- Library code:
packages/**/lib; e2e app:tests/. - Contributor/review norms:
CONTRIBUTING.md.
- Run from repo root; install once with
yarn. - Agent shell commands: agent-command-policy.md only (allowlist). E2e additionally running-e2e.md § agent rule.
- Follow local package patterns; check
type-test.ts,__tests__/, and plugin dirs before public API/platform changes. - Start with
okf-bundle/index.mdfor repo-specific implementation/testing/maintenance knowledge. - Change authoring: change-authoring-workflow.md — baseline → unit-focused implementation →
documentation?→ area-focusedindependent-review→ commit; validation evidence and coverage evidence required before gates close or push. Do not add OKF /AGENTS.md/CONTRIBUTING.mdafter a frozen review without anotherindependent-review. - Use package indexes under
okf-bundle/packages/for package-specific workflows and active work queues (Linear project documents; see documentation-policy.md). Do not create newokf-bundle/**/*work-queue.mdfiles. - Follow documentation-policy § public vs ephemeral vs private: GitHub-public reference docs, this file, commits, and PR titles must not contain ephemeral fields or Linear issue identifiers. Gated queue state lives on Linear, not in new git files.
- Testing entry points:
okf-bundle/testing/index.md; validation requirements:okf-bundle/testing/validation-checklist.md. - Match validation to the work type and validation tier in OKF (change authoring workflow; term ids in iteration vocabulary).
- Keep pull requests scoped to one package or one repo concern where possible.
- PR titles: documentation-policy § pull requests. Examples:
CONTRIBUTING.md. - When public APIs or observable behavior change, update tests, docs, and types in the same PR.