# Documentation Path Map

English is canonical. Simplified Chinese mirrors should stay path-compatible with English.

| Area | English canonical | Chinese mirror |
| --- | --- | --- |
| Root README | `README.md` | `README.zh-CN.md` |
| AI agent guide | `AGENTS.md` | `AGENTS.zh-CN.md` |
| Framework guide | `FRAMEWORK_GUIDE.md` | `FRAMEWORK_GUIDE.zh-CN.md` |
| Docs home | `docs/en/README.md` | `docs/zh-CN/README.md` |
| AI guides | `docs/en/ai/README.md` | `docs/zh-CN/ai/README.md` |
| Phase 0 design | `docs/en/ai/design.md` | `docs/zh-CN/ai/design.md` |
| New module guide | `docs/en/ai/new-module.md` | `docs/zh-CN/ai/new-module.md` |
| Testing guide | `docs/en/ai/testing.md` | `docs/zh-CN/ai/testing.md` |
| Completion checklist | `docs/en/ai/completion-checklist.md` | `docs/zh-CN/ai/completion-checklist.md` |
| API conventions | `docs/en/conventions/api.md` | `docs/zh-CN/conventions/api.md` |
| Web/API/Worker split | `docs/en/architecture/web-api-service-split.md` | `docs/zh-CN/architecture/web-api-service-split.md` |
| Cloud deploy | `docs/en/deployment/cloud-deploy.md` | `docs/zh-CN/deployment/cloud-deploy.md` |
| Debugging | `docs/en/debugging/online-local-debug.md` | `docs/zh-CN/debugging/online-local-debug.md` |
| Integrations | `docs/en/integrations/README.md` | `docs/zh-CN/integrations/README.md` |
| Auth | `docs/en/integrations/auth/README.md` | `docs/zh-CN/integrations/auth/README.md` |
| Payment | `docs/en/integrations/payment/README.md` | `docs/zh-CN/integrations/payment/README.md` |
| Email | `docs/en/integrations/email/README.md` | `docs/zh-CN/integrations/email/README.md` |
| Database | `docs/en/integrations/database/README.md` | `docs/zh-CN/integrations/database/README.md` |
| Storage | `docs/en/integrations/storage/README.md` | `docs/zh-CN/integrations/storage/README.md` |
| Queue | `docs/en/integrations/queue/README.md` | `docs/zh-CN/integrations/queue/README.md` |
| Analytics | `docs/en/integrations/analytics/README.md` | `docs/zh-CN/integrations/analytics/README.md` |
| Ads | `docs/en/integrations/ads/README.md` | `docs/zh-CN/integrations/ads/README.md` |
| Security | `docs/en/integrations/security/README.md` | `docs/zh-CN/integrations/security/README.md` |
| Product modules | `docs/en/modules/README.md` | `docs/zh-CN/modules/README.md` |
| AI Chat module | `docs/en/modules/ai-chat/README.md` | `docs/zh-CN/modules/ai-chat/README.md` |
| Features | `docs/en/features/README.md` | `docs/zh-CN/features/README.md` |
| Daily bonus | `docs/en/features/daily-bonus/README.md` | `docs/zh-CN/features/daily-bonus/README.md` |
| Anti-abuse | `docs/en/features/anti-abuse/README.md` | `docs/zh-CN/features/anti-abuse/README.md` |
| CDN adapters | `docs/en/features/cdn-adapters/README.md` | `docs/zh-CN/features/cdn-adapters/README.md` |

Module-local documentation can stay next to module code, but should use English prose by default and link to the localized framework docs when the same guidance exists in `docs/en/**` and `docs/zh-CN/**`.
