gmailarchiver-patterns
GMailArchiver architecture, layer patterns, and component design. Use when working with cli, core, data, connectors, or shared layers, or understanding component dependencies. Triggers on: architecture, layer, pattern, component, cli layer, core layer, data layer, SOLID, dependency, contract.
When & Why to Use This Skill
This Claude skill provides comprehensive guidance on the GMailArchiver system architecture, layer patterns, and component design. It ensures developers adhere to SOLID principles and project-specific coding standards across CLI, core, data, and connector layers by serving as a centralized reference for architectural integrity.
Use Cases
- Navigating and implementing changes within the multi-layered architecture (CLI, core, data, connectors) while maintaining strict layer boundaries and dependency rules.
- Ensuring new code contributions follow established SOLID principles and project-specific coding standards documented in ARCHITECTURE.md and CODING.md.
- Onboarding developers to the GMailArchiver project by providing clear insights into component responsibilities, data integrity architecture, and the 6-phase development process.
| name | gmailarchiver-patterns |
|---|---|
| description | >- |
| component dependencies. Triggers on | architecture, layer, pattern, component, |
GMailArchiver Coding Patterns
This skill provides guidance on coding patterns and conventions for GMailArchiver.
Source Documentation
Always read the authoritative sources for current patterns:
CLAUDE.md- Quick reference for AI assistants, includes:- Project overview
- Development commands
- Architecture summary
- Key patterns and safety architecture
docs/ARCHITECTURE.md- Complete system architecture:- Layer-based architecture (cli, core, data, connectors, shared)
- Layer dependency rules and contracts
- Data integrity architecture
- Component responsibilities
docs/CODING.md- Coding standards:- Style guidelines (line length, imports)
- Type hint requirements
- Error handling patterns
docs/PROCESS.md- Development workflow:- 6-phase development process
- Definition of done
- Quality gates
Layer Documentation
Each layer has its own architecture documentation:
src/gmailarchiver/cli/ARCHITECTURE.md- CLI layer designsrc/gmailarchiver/core/ARCHITECTURE.md- Business logic designsrc/gmailarchiver/data/ARCHITECTURE.md- Data layer designsrc/gmailarchiver/connectors/ARCHITECTURE.md- Connectors designsrc/gmailarchiver/shared/ARCHITECTURE.md- Shared utilities design
Usage
When working on code:
- Read the relevant ARCHITECTURE.md files for the layer(s) you're modifying
- Follow patterns documented in those files
- If patterns change, update the documentation (not this skill)
The source documentation is the single source of truth - this skill just points you there.