# Lingua Documentation

## App — Usage & Best Practices

- [Sheet Structure](./App/SHEET_STRUCTURE.md) — How to structure your Google Sheet (tabs, columns, plural forms, format specifiers).
- [Best Usage Practices](./App/BEST_USAGE_PRACTICES.md) — Running Lingua locally and in CI/CD pipelines.
- [AI Agent Usage](./App/AI_AGENT_USAGE.md) — One-time setup, service account configuration, and the full agent-facing subcommand reference.
- [AI Agent Integration](./App/AI_AGENT_INTEGRATION.md) — Architecture deep-dive: how the agent CLI extensions, bundled skills, and macOS app sandbox flow are implemented.

## Architecture

- [Overview](./Architecture/README.md) — Clean Architecture layers (Domain, Infrastructure, Application), component responsibilities, and diagrams.
- [Domain Layer](./Architecture/Domain/DOMAIN.md) — Entities and use cases.
- [Localization Domain](./Architecture/Domain/Localization.md) — Localization-specific entities, use cases, and data flow.
- [Networking](./Architecture/Infrastructure/Networking/README.md) — Networking layer design.

---

For questions or feedback, open an issue at [github.com/poviolabs/Lingua](https://github.com/povio/Lingua).