This is the central index for all agent-operational documentation. Before starting any task, find the relevant doc here. If a doc doesn't exist for what you need, create one and add it to this index.
| Document | When to Use |
|---|---|
| Development Commands | Building, testing, linting, and other common commands |
| E2E Testing | Running, monitoring, and debugging e2e tests (cloud and local) |
| Dependabot & Dependencies | Handling dependency upgrades, security alerts, Dependabot PRs |
| Code Navigation & Architecture | Codebase architecture, package catalog, dependency graph, where to find things |
| Customer Experience & Known Issues | What customers build, how they use the API, common problems, outstanding issues |
packages/— Lerna monorepo packagesscripts/— Build, test, and deployment utilitiescodebuild_specs/— CI/CD build spec configuration
Agents are responsible for keeping these docs accurate and well-organized:
- Fix redundancy on sight. If you find the same information in two places, consolidate it into the correct doc and remove the duplicate.
- Relocate misplaced knowledge. If you find operational details outside
.agent-docs/, move them here and update references. - Fill gaps proactively. If you had trouble finding information you needed, update or create a doc so the next session doesn't struggle.
- Keep the index current. Every doc in this folder must be listed in this README. No orphan files.
- Avoid sprawl. Prefer updating an existing doc over creating a new one. Only create a new doc when the topic is clearly distinct from all existing docs.