@codemieai/code 0.0.28 → 0.0.29

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/architecture/project-structure.md.template

@@ -0,0 +1,127 @@
+# Project Structure
+
+## Quick Summary
+
+[PROJECT_NAME] directory layout and organization guide.
+
+**Category**: Architecture
+**Complexity**: Simple
+**Prerequisites**: File system basics
+
+---
+
+## 🚨 SIZE LIMIT WARNING
+
+**This generated guide MUST be 200-400 lines maximum.**
+
+**When filling this template**:
+- ✅ Code examples: 5-15 lines (NEVER > 20)
+- ✅ ONE example per pattern
+- ✅ Use file:line references, not full code
+- ✅ Use tables for multiple patterns
+- ❌ NO multiple examples for same pattern
+- ❌ NO verbose explanations
+- ❌ NO copying entire functions
+
+**Validate line count after generation**: `wc -l [this-file]`
+**If > 400 lines**: Condense immediately before continuing!
+
+---
+
+## Directory Structure
+
+```
+[project-root]/
+├── [src]/              Source code
+├── [tests]/            Tests
+├── [config]/           Configuration
+├── [docs]/             Documentation
+├── .gitignore
+├── [build-config]      Build/dependency file
+└── README.md
+```
+
+---
+
+## Source Organization
+
+```
+[src]/
+├── [layer1]/           [Layer 1 description]
+│   └── [module]/
+├── [layer2]/           [Layer 2 description]
+│   └── [module]/
+├── [layer3]/           [Layer 3 description]
+│   └── [module]/
+├── [shared]/           Common utilities
+│   ├── exceptions
+│   ├── constants
+│   └── utils
+└── [main]              Entry point
+```
+
+---
+
+## Test Organization
+
+```
+[tests]/
+├── unit/               Mirrors source structure
+│   └── [module]/
+│       └── test_[file]
+├── integration/
+│   └── test_[feature]
+└── fixtures/
+```
+
+---
+
+## File Naming
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Modules | [convention] | `[example]` |
+| Tests | [convention] | `test_[name]` |
+| Config | [convention] | `[example]` |
+
+---
+
+## Module Boundaries
+
+```
+[Layer1] (Top)
+    ↓
+[Layer2] (Middle)
+    ↓
+[Layer3] (Bottom)
+    ↓
+[Shared/Core]
+```
+
+**Rules**:
+- ✅ Upper → Lower
+- ✅ All → Shared
+- ❌ Lower → Upper
+- ❌ Circular dependencies
+
+---
+
+## Finding Code
+
+| Need | Location |
+|------|----------|
+| API endpoints | `[path]` |
+| Business logic | `[path]` |
+| Data models | `[path]` |
+| Database | `[path]` |
+| Exceptions | `[path]` |
+| Config | `[path]` |
+
+---
+
+## References
+
+- **Source**: `[src-directory]/`
+- **Tests**: `[test-directory]/`
+
+---

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/data/database-patterns.md.template

@@ -0,0 +1,168 @@
+# Database Patterns
+
+## Quick Summary
+
+Database patterns for [PROJECT_NAME]: models, queries, transactions, and migrations using [ORM] with [DATABASE].
+
+**Category**: Data
+**Complexity**: Medium-High
+**Prerequisites**: SQL, [ORM], [DATABASE]
+
+---
+
+## 🚨 SIZE LIMIT WARNING
+
+**This generated guide MUST be 200-400 lines maximum.**
+
+**When filling this template**:
+- ✅ Code examples: 5-15 lines (NEVER > 20)
+- ✅ ONE example per pattern
+- ✅ Use file:line references, not full code
+- ✅ Use tables for multiple patterns
+- ❌ NO multiple examples for same pattern
+- ❌ NO verbose explanations
+- ❌ NO copying entire functions
+
+**Validate line count after generation**: `wc -l [this-file]`
+**If > 400 lines**: Condense immediately before continuing!
+
+---
+
+## Connection Configuration
+
+```[language]
+# Source: [file:lines]
+[connection_config]
+```
+
+**Connection String**: `[database]://[user]:[pass]@[host]:[port]/[db]`
+
+---
+
+## Model Definition
+
+```[language]
+# Source: [file:lines]
+[model_example]
+```
+
+**Relationships**: [Describe key relationships]
+
+---
+
+## CRUD Operations
+
+### Create
+
+```[language]
+# Source: [file:lines]
+[create_example]
+```
+
+### Read
+
+```[language]
+# Source: [file:lines]
+[read_example]
+```
+
+### Update
+
+```[language]
+# Source: [file:lines]
+[update_example]
+```
+
+### Delete
+
+```[language]
+# Source: [file:lines]
+[delete_example]
+```
+
+---
+
+## Transactions
+
+```[language]
+# Source: [file:lines]
+[transaction_example]
+```
+
+**When to Use**:
+- Multiple related writes
+- Data consistency requirements
+
+**Rules**:
+- Keep short
+- Avoid external API calls in transactions
+- Handle rollback
+
+---
+
+## Pagination
+
+```[language]
+# Source: [file:lines]
+[pagination_example]
+```
+
+**Pattern**: Offset-based | Cursor-based
+
+---
+
+## N+1 Prevention
+
+```[language]
+# Problem: N+1
+[n_plus_1_problem]
+
+# Solution: Eager loading
+[n_plus_1_solution]
+```
+
+---
+
+## Migrations
+
+```bash
+# Create migration
+[create_migration]
+
+# Run migrations
+[run_migrations]
+
+# Rollback
+[rollback_migration]
+```
+
+**Rules**:
+- Always include rollback
+- Test on copy of prod data
+- Never modify existing migrations
+
+---
+
+## Raw Queries
+
+```[language]
+# ALWAYS parameterized - Source: [file:lines]
+[parameterized_query]
+
+# NEVER string interpolation (SQL injection!)
+[bad_query_example]
+```
+
+---
+
+## Best Practices
+
+| ✅ DO | ❌ DON'T |
+|-------|----------|
+| Use parameterized queries | String interpolation in SQL |
+| Close connections | Leave connections open |
+| Use transactions for multi-step writes | Individual commits |
+| Add indexes to queried columns | Index everything |
+| Eager load when needed | Lazy load always (N+1) |
+
+---

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/development/development-practices.md.template

@@ -0,0 +1,210 @@
+# Development Practices
+
+## Quick Summary
+
+Core development practices for [PROJECT_NAME]: error handling, logging, and configuration patterns.
+
+**Category**: Development
+**Complexity**: Medium
+**Prerequisites**: [LANGUAGE] fundamentals, [FRAMEWORK]
+
+---
+
+## 🚨 SIZE LIMIT WARNING
+
+**This generated guide MUST be 200-400 lines maximum.**
+
+**When filling this template**:
+- ✅ Code examples: 5-15 lines (NEVER > 20)
+- ✅ ONE example per pattern
+- ✅ Use file:line references, not full code
+- ✅ Use tables for multiple patterns
+- ❌ NO multiple examples for same pattern
+- ❌ NO verbose explanations
+- ❌ NO copying entire functions
+
+**Validate line count after generation**: `wc -l [this-file]`
+**If > 400 lines**: Condense immediately before continuing!
+
+---
+
+## Error Handling
+
+### Exception Hierarchy
+
+| Exception | When to Use | HTTP Status | Source |
+|-----------|-------------|-------------|--------|
+| `[ValidationError]` | Invalid input | 400 | [file:lines] |
+| `[NotFoundError]` | Resource missing | 404 | [file:lines] |
+| `[AuthError]` | Auth failed | 401/403 | [file:lines] |
+| `[ServerError]` | Internal error | 500 | [file:lines] |
+
+### Pattern: Raise & Handle
+
+```[language]
+# Raise - Source: [file:lines]
+[raise_example]
+
+# Handle - Source: [file:lines]
+[handler_example]
+```
+
+### Error Response Format
+
+```json
+{
+  "error": {
+    "code": "[ERROR_CODE]",
+    "message": "[human-readable]",
+    "details": "[context]"
+  }
+}
+```
+
+**Rules**:
+- ✅ Specific exceptions (not bare `except:`)
+- ✅ Log with context
+- ✅ Return consistent format
+- ❌ Expose internal details
+
+---
+
+## Logging
+
+### Configuration
+
+```[language]
+# Source: [file:lines]
+[logging_config]
+```
+
+### Log Levels
+
+| Level | When | Example |
+|-------|------|---------|
+| DEBUG | Development details | `[example]` |
+| INFO | Normal operations | `[example]` |
+| WARNING | Recoverable issues | `[example]` |
+| ERROR | Failures | `[example]` |
+
+### Pattern: Structured Logging
+
+```[language]
+# Good - Source: [file:lines]
+[good_logging]
+
+# Bad
+[bad_logging]
+```
+
+**Rules**:
+- ✅ Include context (user_id, request_id, etc.)
+- ✅ Use appropriate levels
+- ❌ Log secrets/PII
+- ❌ Log in hot paths
+
+---
+
+## Configuration
+
+### Environment Variables
+
+**Required**:
+```bash
+[VAR1]=[description]
+[VAR2]=[description]
+```
+
+**Optional** (with defaults):
+```bash
+[VAR3]=[description] # default: [value]
+```
+
+### Pattern: Load Config
+
+```[language]
+# Source: [file:lines]
+[config_loading]
+```
+
+### Multi-Environment
+
+```[language]
+# Source: [file:lines]
+[env_detection]
+```
+
+**Environments**: development | staging | production
+
+**Rules**:
+- ✅ Use env vars for deployment-specific config
+- ✅ Validate at startup
+- ✅ Never commit `.env` files
+- ❌ Hardcode secrets
+
+---
+
+## Setup Guide
+
+### Quick Start
+
+```bash
+# Install
+[install_command]
+
+# Configure
+[config_command]
+
+# Run
+[run_command]
+```
+
+### Environment Setup
+
+```bash
+# 1. Activate environment
+[activate_command]
+
+# 2. Install dependencies
+[dependency_command]
+
+# 3. Setup database (if needed)
+[db_setup_command]
+
+# 4. Run
+[dev_server_command]
+```
+
+**Verify**: [URL or command to verify setup]
+
+---
+
+## Common Commands
+
+| Task | Command | Notes |
+|------|---------|-------|
+| Run dev | `[command]` | [Notes] |
+| Lint | `[command]` | Auto-fix with `[fix_flag]` |
+| Format | `[command]` | [Notes] |
+| Test | `[command]` | ONLY if user requests |
+| Build | `[command]` | [Notes] |
+
+---
+
+## Troubleshooting
+
+| Symptom | Likely Cause | Fix |
+|---------|--------------|-----|
+| [error_pattern] | [cause] | [solution] |
+| [error_pattern] | [cause] | [solution] |
+
+---
+
+## References
+
+- **Error Handling**: `[path/to/exceptions]`
+- **Logging Config**: `[path/to/logging/config]`
+- **Configuration**: `[path/to/config]`
+- **Setup Docs**: `README.md`
+
+---

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/integration/external-integrations.md.template

@@ -0,0 +1,160 @@
+# External Integrations
+
+## Quick Summary
+
+External service integration patterns for [PROJECT_NAME]: API clients, authentication, retries, and error handling.
+
+**Category**: Integration
+**Complexity**: Medium-High
+**Prerequisites**: HTTP clients, async/await, API fundamentals
+
+---
+
+## 🚨 SIZE LIMIT WARNING
+
+**This generated guide MUST be 200-400 lines maximum.**
+
+**When filling this template**:
+- ✅ Code examples: 5-15 lines (NEVER > 20)
+- ✅ ONE example per pattern
+- ✅ Use file:line references, not full code
+- ✅ Use tables for multiple patterns
+- ❌ NO multiple examples for same pattern
+- ❌ NO verbose explanations
+- ❌ NO copying entire functions
+
+**Validate line count after generation**: `wc -l [this-file]`
+**If > 400 lines**: Condense immediately before continuing!
+
+---
+
+## Integrated Services
+
+| Service | Purpose | Auth | Source |
+|---------|---------|------|--------|
+| [Service1] | [Purpose] | [Method] | [file:lines] |
+| [Service2] | [Purpose] | [Method] | [file:lines] |
+
+---
+
+## Client Pattern
+
+```[language]
+# Source: [file:lines]
+[client_class]
+```
+
+**Components**: Base URL, auth, retries, timeouts
+
+---
+
+## Authentication
+
+### API Key
+
+```[language]
+# Source: [file:lines]
+[api_key_auth]
+```
+
+### OAuth2
+
+```[language]
+# Source: [file:lines]
+[oauth2_auth]
+```
+
+**Token Management**: Store securely, refresh before expiry
+
+---
+
+## Error Handling
+
+```[language]
+# Source: [file:lines]
+[error_handling]
+```
+
+| Status | Action |
+|--------|--------|
+| 4xx | Log, don't retry (usually) |
+| 5xx | Log, retry with backoff |
+| Timeout | Retry with backoff |
+
+---
+
+## Retry Logic
+
+```[language]
+# Source: [file:lines]
+[retry_pattern]
+```
+
+**Strategy**: Exponential backoff
+**Max Retries**: [N]
+**When**: 5xx, timeouts, connection errors
+**When Not**: 4xx (usually), auth failures
+
+---
+
+## Rate Limiting
+
+```[language]
+# Source: [file:lines]
+[rate_limit]
+```
+
+**Headers**: `X-RateLimit-*`, `Retry-After`
+
+---
+
+## Timeouts
+
+```[language]
+# Source: [file:lines]
+[timeout_config]
+```
+
+**Types**: Connection | Read | Total
+
+---
+
+## Best Practices
+
+| ✅ DO | ❌ DON'T |
+|-------|----------|
+| Retry with backoff | Infinite retries |
+| Set timeouts | Wait forever |
+| Log external calls | Silent failures |
+| Cache when possible | Call repeatedly |
+| Store secrets securely | Hardcode API keys |
+
+---
+
+## Security
+
+- ✅ Env vars / secrets manager
+- ✅ HTTPS only
+- ✅ Validate TLS certs
+- ❌ Log API keys
+- ❌ Ignore cert errors
+
+---
+
+## Testing
+
+```[language]
+# Source: [test_file:lines]
+[mock_example]
+```
+
+**Strategy**: Mock in unit tests, use test APIs in integration tests
+
+---
+
+## References
+
+- **Clients**: `[path/to/clients]`
+- **Service Docs**: [Links]
+
+---