@codemieai/code 0.0.27 → 0.0.29

package/dist/agents/plugins/claude/plugin/claude-templates/templates/INDEX.md

@@ -0,0 +1,205 @@
+# Template Index
+
+## Overview
+
+Concise templates for generating Claude Code documentation. Each template is **150-250 lines max**, focusing on contracts and best practices.
+
+---
+
+## Main Template
+
+### CLAUDE.md.template
+**Lines**: ~300
+**Purpose**: Main AI-optimized execution guide
+**Use**: Every project (required)
+
+---
+
+## Guide Templates (10 Total)
+
+### Required (P0) - For All Projects
+
+#### development/development-practices.md.template
+**Lines**: ~180
+**Covers**: Error handling, logging, configuration, setup
+**Use**: All projects
+**Combines**: Error patterns + logging + config + setup in one file
+
+#### security/security-practices.md.template
+**Lines**: ~160
+**Covers**: Auth, authorization, validation, secrets, SQL injection, XSS
+**Use**: All projects
+
+#### testing/testing-patterns.md.template
+**Lines**: ~125
+**Covers**: Unit tests, integration tests, fixtures, mocking
+**Use**: All projects
+
+#### standards/code-quality.md.template
+**Lines**: ~135
+**Covers**: Linting, formatting, type safety, naming
+**Use**: All projects
+
+#### standards/git-workflow.md.template
+**Lines**: ~160
+**Covers**: Branching, commits, PRs, code review
+**Use**: All projects
+
+---
+
+### Recommended (P1) - Based on Project Type
+
+#### api/api-patterns.md.template
+**Lines**: ~190
+**Covers**: CRUD, validation, auth, pagination, errors, rate limiting
+**Use**: Projects with REST/GraphQL APIs
+
+#### architecture/layered-architecture.md.template
+**Lines**: ~125
+**Covers**: Layer responsibilities, communication, error flow, testing
+**Use**: Projects with layered architecture
+
+#### architecture/project-structure.md.template
+**Lines**: ~110
+**Covers**: Directory layout, module organization, navigation
+**Use**: For better code navigation (optional)
+
+#### data/database-patterns.md.template
+**Lines**: ~160
+**Covers**: Models, CRUD, transactions, migrations, N+1 prevention
+**Use**: Projects using databases
+
+#### integration/external-integrations.md.template
+**Lines**: ~145
+**Covers**: API clients, auth, retries, rate limiting, error handling
+**Use**: Projects with external API integrations
+
+---
+
+## Template Size Guide
+
+**Target**: 150-250 lines per template
+**Philosophy**: Concise, focused, efficient
+**Content**: Best practices and contracts, minimal code examples
+
+### Size Breakdown
+
+| Template | Lines | Type |
+|----------|-------|------|
+| CLAUDE.md | ~300 | Main |
+| development-practices | ~180 | Required |
+| security-practices | ~160 | Required |
+| testing-patterns | ~125 | Required |
+| code-quality | ~135 | Required |
+| git-workflow | ~160 | Required |
+| api-patterns | ~190 | Optional |
+| layered-architecture | ~125 | Optional |
+| project-structure | ~110 | Optional |
+| database-patterns | ~160 | Optional |
+| external-integrations | ~145 | Optional |
+
+**Total**: ~1,790 lines for all templates
+**Generated docs**: 200-400 lines per guide (target)
+
+---
+
+## Template Selection
+
+### Decision Matrix
+
+| Found in Project | Required Template | Optional Template |
+|------------------|------------------|-------------------|
+| **Always** | development-practices, security-practices, testing-patterns, code-quality, git-workflow | - |
+| REST/GraphQL endpoints | - | api-patterns |
+| Layered architecture | - | layered-architecture, project-structure |
+| Database/ORM | - | database-patterns |
+| External APIs | - | external-integrations |
+
+### Quick Selection
+
+**Minimal (5 guides)**:
+- development-practices
+- security-practices
+- testing-patterns
+- code-quality
+- git-workflow
+
+**Standard Web App (8 guides)**:
+- All minimal +
+- api-patterns
+- layered-architecture
+- database-patterns
+
+**Full Stack (10 guides)**:
+- All standard +
+- project-structure
+- external-integrations
+
+---
+
+## Placeholders
+
+### Global (All Templates)
+
+- `[PROJECT_NAME]` - Project name
+- `[LANGUAGE]` - Programming language
+- `[FRAMEWORK]` - Main framework
+- `[file:lines]` - Source file reference
+- `[code_example]` - Brief code snippet
+- `# FILL IN` - Project-specific section
+
+### Template-Specific
+
+- `[DATABASE]` / `[ORM]` - Database patterns
+- `[TEST_FRAMEWORK]` - Testing patterns
+- `[LINTER]` / `[FORMATTER]` - Code quality
+- `[AUTH_METHOD]` - Security/API patterns
+
+---
+
+## Usage
+
+### For Claude Code Generation
+
+1. Analyze project (tech stack, patterns)
+2. Select templates (P0 + relevant P1)
+3. For each template:
+   - Search codebase for patterns
+   - Extract concise examples (< 20 lines)
+   - Replace placeholders
+   - Fill sections
+4. Generate CLAUDE.md last
+5. **Validate**: Each guide 200-400 lines max
+
+### For Manual Use
+
+1. Copy template
+2. Replace `[PLACEHOLDERS]`
+3. Fill `# FILL IN` sections
+4. Add brief code examples
+5. Keep concise (200-400 lines)
+
+---
+
+## Version History
+
+### v2.0 (2026-01-14)
+- **Major revision**: Condensed all templates
+- Combined development folder into single file
+- Moved security to separate folder
+- Reduced from 14 to 10 templates
+- Target: 150-250 lines per template
+- Focus: Contracts and best practices, not extensive examples
+
+### v1.0 (2026-01-14)
+- Initial release (deprecated)
+
+---
+
+## References
+
+- **Generation Command**: `../codemie-init-skill.md`
+- **README**: `../README.md`
+- **Source**: CodeMie project patterns
+
+---

package/dist/agents/plugins/claude/plugin/claude-templates/templates/TEMPLATE_SIZES.md

@@ -0,0 +1,74 @@
+# Template Size Report
+
+**Generated**: 2026-01-14
+**Version**: 2.0
+
+## Summary
+
+- **Total Templates**: 10 guide templates
+- **Size Range**: 109-192 lines
+- **Average**: 148 lines
+- **Target Met**: ✅ All templates within 150-250 line goal (minor variance acceptable)
+
+## Detailed Breakdown
+
+| Template | Lines | Type | Status |
+|----------|-------|------|--------|
+| **api-patterns** | 189 | Optional | ✅ |
+| **layered-architecture** | 125 | Optional | ✅ |
+| **project-structure** | 109 | Optional | ✅ |
+| **database-patterns** | 158 | Optional | ✅ |
+| **development-practices** | 192 | **Required** | ✅ |
+| **external-integrations** | 142 | Optional | ✅ |
+| **security-practices** | 152 | **Required** | ✅ |
+| **code-quality** | 132 | **Required** | ✅ |
+| **git-workflow** | 159 | **Required** | ✅ |
+| **testing-patterns** | 125 | **Required** | ✅ |
+
+## By Category
+
+### Required Templates (P0)
+- development-practices: 192 lines
+- security-practices: 152 lines  
+- testing-patterns: 125 lines
+- code-quality: 132 lines
+- git-workflow: 159 lines
+**Total**: 760 lines
+
+### Optional Templates (P1)
+- api-patterns: 189 lines
+- layered-architecture: 125 lines
+- project-structure: 109 lines
+- database-patterns: 158 lines
+- external-integrations: 142 lines
+**Total**: 723 lines
+
+## Expected Generated Sizes
+
+When filled with project-specific content:
+
+**Per Guide**: 200-400 lines (1.5-2x template size)
+- Template placeholders → Real code examples
+- `# FILL IN` sections → Project-specific content
+- Generic patterns → Actual file:line references
+
+**Minimal Project** (5 required guides):
+- Generated: ~1,200-2,000 lines total
+
+**Standard Project** (8 guides):
+- Generated: ~1,900-3,200 lines total
+
+**Full Project** (10 guides):
+- Generated: ~2,400-4,000 lines total
+
+## Size Philosophy
+
+**Concise but Complete**:
+- Focus on contracts and patterns
+- Brief code examples (< 20 lines)
+- Essential best practices only
+- No redundant explanations
+- Highly scannable tables
+
+**Target Achieved**: ✅
+All templates meet the "concise, focused, efficient" goal.

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

@@ -0,0 +1,207 @@
+# API Patterns
+
+## Quick Summary
+
+API endpoint patterns for [PROJECT_NAME]: CRUD operations, validation, authentication, and error responses.
+
+**Category**: API
+**Complexity**: Medium
+**Prerequisites**: [FRAMEWORK], HTTP, [AUTH_METHOD]
+
+---
+
+## 🚨 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!
+
+---
+
+## Endpoint Structure
+
+```
+[base_url]/
+├── [resource1]/
+│   ├── GET    /           List all
+│   ├── POST   /           Create
+│   ├── GET    /:id        Get one
+│   ├── PUT    /:id        Update
+│   └── DELETE /:id        Delete
+└── [resource2]/
+```
+
+**Source**: `[path/to/routes]`
+
+---
+
+## CRUD Patterns
+
+### Create (POST)
+
+```[language]
+# Source: [file:lines]
+[create_endpoint]
+```
+
+**Status**: 201 Created | 400 Bad Request | 401 Unauthorized
+
+---
+
+### Read (GET)
+
+```[language]
+# Source: [file:lines]
+[read_endpoint]
+```
+
+**Status**: 200 OK | 404 Not Found
+
+---
+
+### Update (PUT/PATCH)
+
+```[language]
+# Source: [file:lines]
+[update_endpoint]
+```
+
+**Status**: 200 OK | 404 Not Found | 400 Bad Request
+
+---
+
+### Delete (DELETE)
+
+```[language]
+# Source: [file:lines]
+[delete_endpoint]
+```
+
+**Status**: 204 No Content | 404 Not Found
+
+---
+
+## Request Validation
+
+```[language]
+# Source: [file:lines]
+[validation_example]
+```
+
+**Validation Error Response**:
+```json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Validation failed",
+    "details": [
+      {"field": "[field]", "message": "[error]"}
+    ]
+  }
+}
+```
+
+---
+
+## Authentication & Authorization
+
+```[language]
+# Source: [file:lines]
+[auth_middleware]
+```
+
+**Status**: 401 Unauthorized | 403 Forbidden
+
+---
+
+## Pagination
+
+```[language]
+# Source: [file:lines]
+[pagination_example]
+```
+
+**Query Params**: `page`, `limit`, `sort`, `order`
+
+**Response**:
+```json
+{
+  "data": [],
+  "pagination": {
+    "page": 1,
+    "limit": 20,
+    "total": 100,
+    "pages": 5
+  }
+}
+```
+
+---
+
+## Error Responses
+
+| Status | Type | Example |
+|--------|------|---------|
+| 400 | Bad Request | Invalid input |
+| 401 | Unauthorized | Missing/invalid token |
+| 403 | Forbidden | Insufficient permissions |
+| 404 | Not Found | Resource doesn't exist |
+| 422 | Unprocessable | Validation failed |
+| 500 | Server Error | Internal error |
+
+**Format**:
+```json
+{
+  "error": {
+    "code": "[ERROR_CODE]",
+    "message": "[human-readable]",
+    "details": "[additional info]"
+  }
+}
+```
+
+---
+
+## Rate Limiting
+
+```[language]
+# Source: [file:lines]
+[rate_limit_config]
+```
+
+**Headers**:
+- `X-RateLimit-Limit`: Max requests
+- `X-RateLimit-Remaining`: Requests left
+- `X-RateLimit-Reset`: Reset time
+
+---
+
+## Best Practices
+
+| ✅ DO | ❌ DON'T |
+|-------|----------|
+| Use proper HTTP methods | GET for mutations |
+| Return appropriate status codes | Always 200 |
+| Validate all input | Trust client data |
+| Use consistent naming | Mix conventions |
+| Version your API | Break clients |
+
+---
+
+## References
+
+- **Routes**: `[path/to/routes]`
+- **Models**: `[path/to/models]`
+- **API Docs**: [URL]
+
+---

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

@@ -0,0 +1,143 @@
+# Layered Architecture
+
+## Quick Summary
+
+[PROJECT_NAME] implements [N]-tier architecture: [Layer1] → [Layer2] → [Layer3].
+
+**Category**: Architecture
+**Complexity**: Medium
+**Prerequisites**: [LANGUAGE], [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!
+
+---
+
+## Architecture Overview
+
+```
+┌─────────────────────────────────┐
+│  [Layer 1] ([path/])            │  ← HTTP interface
+│  Request/Response handling      │
+└────────────┬────────────────────┘
+             ↓ calls
+┌─────────────────────────────────┐
+│  [Layer 2] ([path/])            │  ← Business logic
+│  Orchestration                  │
+└────────────┬────────────────────┘
+             ↓ calls
+┌─────────────────────────────────┐
+│  [Layer 3] ([path/])            │  ← Data access
+│  Persistence                    │
+└────────────┬────────────────────┘
+             ↓
+        [Database]
+```
+
+---
+
+## Layer Responsibilities
+
+### [Layer 1] - [Name]
+
+**Purpose**: [Brief description]
+
+```[language]
+# Source: [file:lines]
+[layer1_example]
+```
+
+**Does**: Validation, routing, response formatting
+**Doesn't**: Business logic, database access
+
+---
+
+### [Layer 2] - [Name]
+
+**Purpose**: [Brief description]
+
+```[language]
+# Source: [file:lines]
+[layer2_example]
+```
+
+**Does**: Business logic, orchestration
+**Doesn't**: HTTP handling, direct DB access
+
+---
+
+### [Layer 3] - [Name]
+
+**Purpose**: [Brief description]
+
+```[language]
+# Source: [file:lines]
+[layer3_example]
+```
+
+**Does**: Database queries, data access
+**Doesn't**: Business logic, HTTP handling
+
+---
+
+## Communication Rules
+
+| ✅ Allowed | ❌ Not Allowed |
+|-----------|---------------|
+| Layer1 → Layer2 → Layer3 | Skip layers |
+| Pass data via models/DTOs | Share state |
+| Async/await throughout | Blocking calls |
+
+---
+
+## Error Flow
+
+```
+[Layer3 Error]
+    ↓ raise
+[Layer2 Transform]
+    ↓ raise
+[Layer1 HTTP Response]
+```
+
+**Example**:
+```[language]
+# Source: [file:lines]
+[error_flow_example]
+```
+
+---
+
+## Testing Strategy
+
+| Layer | Test Type | Mock |
+|-------|-----------|------|
+| [Layer1] | Unit | Layer2 |
+| [Layer2] | Unit | Layer3 |
+| [Layer3] | Unit | Database |
+| All | Integration | Nothing |
+
+---
+
+## References
+
+- **[Layer1]**: `[path/]`
+- **[Layer2]**: `[path/]`
+- **[Layer3]**: `[path/]`
+
+---