@codemieai/code 0.0.33 → 0.0.35

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

@@ -1,207 +1,179 @@
-# 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]
-
 ---
+# API Patterns Guide
 
-## 🚨 SIZE LIMIT WARNING
+## Overview
 
-**This generated guide MUST be 200-400 lines maximum.**
+<!-- 
+GENERATION INSTRUCTIONS:
+1. Scan codebase for API routes, controllers, middleware
+2. Extract ACTUAL patterns used (don't invent)
+3. Fill each section with REAL file paths and code
+4. Keep examples minimal (5-15 lines, one per pattern)
+5. Final output: 150-300 lines
+-->
 
-**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!
+**Project**: [Extract from package.json/config]
+**Stack**: [Detect framework, language, auth library]
+**Base URL**: [Find in config/env]
 
 ---
 
-## Endpoint Structure
+## File Structure
 
-```
-[base_url]/
-├── [resource1]/
-│   ├── GET    /           List all
-│   ├── POST   /           Create
-│   ├── GET    /:id        Get one
-│   ├── PUT    /:id        Update
-│   └── DELETE /:id        Delete
-└── [resource2]/
-```
+<!-- Find and document where API code lives -->
 
-**Source**: `[path/to/routes]`
+| Purpose | Path |
+|---------|------|
+| Routes/Endpoints | `[scan for router files]` |
+| Controllers/Handlers | `[scan for controller pattern]` |
+| Middleware | `[scan for middleware folder]` |
+| Validation | `[scan for validators/schemas]` |
+| Models/Types | `[scan for models/entities]` |
 
 ---
 
-## CRUD Patterns
+## Endpoint Pattern
 
-### Create (POST)
+<!-- Extract ONE canonical endpoint showing the full pattern -->
 
-```[language]
-# Source: [file:lines]
-[create_endpoint]
+```[detected_language]
+// Source: [actual_file:lines]
+[extract representative endpoint - prefer one with auth + validation]
 ```
 
-**Status**: 201 Created | 400 Bad Request | 401 Unauthorized
+**To add new endpoint, replicate this structure:**
+1. Define route in `[routes_file]`
+2. Add handler in `[controllers_path]`
+3. Add validation in `[validators_path]` (if needed)
 
 ---
 
-### Read (GET)
+## Validation Pattern
 
-```[language]
-# Source: [file:lines]
-[read_endpoint]
-```
+<!-- Find how this codebase validates requests -->
 
-**Status**: 200 OK | 404 Not Found
+**Approach**: [Detect: Zod/Joi/Yup/Pydantic/class-validator/custom]
 
----
-
-### Update (PUT/PATCH)
-
-```[language]
-# Source: [file:lines]
-[update_endpoint]
+```[lang]
+// Source: [actual_file:lines]
+[extract one validation schema example]
 ```
 
-**Status**: 200 OK | 404 Not Found | 400 Bad Request
+**Usage:**
+```[lang]
+// How validation is applied to routes
+[extract middleware/decorator usage]
+```
 
 ---
 
-### Delete (DELETE)
+## Authentication
 
-```[language]
-# Source: [file:lines]
-[delete_endpoint]
+<!-- Find auth middleware/guards -->
+
+**Method**: [Detect: JWT/Session/API Key/OAuth]
+
+```[lang]
+// Source: [actual_file:lines]
+[extract auth middleware]
 ```
 
-**Status**: 204 No Content | 404 Not Found
+**Protect route:** `[extract exact syntax used]`
+**Access user:** `[extract how user object is accessed]`
 
 ---
 
-## Request Validation
+## Response Patterns
+
+<!-- Find consistent response structures -->
 
-```[language]
-# Source: [file:lines]
-[validation_example]
+**Success format:**
+```json
+[extract actual success response structure from code]
 ```
 
-**Validation Error Response**:
+**Error format:**
 ```json
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Validation failed",
-    "details": [
-      {"field": "[field]", "message": "[error]"}
-    ]
-  }
-}
+[extract actual error response structure from code]
 ```
 
+**Helper/Utility** (if exists): `[path to response helpers]`
+
 ---
 
-## Authentication & Authorization
+## Status Codes
 
-```[language]
-# Source: [file:lines]
-[auth_middleware]
-```
+<!-- Extract from actual handlers OR document conventions found -->
 
-**Status**: 401 Unauthorized | 403 Forbidden
+| Operation | Success | Common Errors |
+|-----------|---------|---------------|
+| Create | [find in POST handlers] | [find error codes] |
+| Read | [find in GET handlers] | [find error codes] |
+| Update | [find in PUT/PATCH] | [find error codes] |
+| Delete | [find in DELETE] | [find error codes] |
 
 ---
 
-## Pagination
-
-```[language]
-# Source: [file:lines]
-[pagination_example]
-```
+## Error Handling
 
-**Query Params**: `page`, `limit`, `sort`, `order`
+<!-- Find centralized error handling -->
 
-**Response**:
-```json
-{
-  "data": [],
-  "pagination": {
-    "page": 1,
-    "limit": 20,
-    "total": 100,
-    "pages": 5
-  }
-}
+```[lang]
+// Source: [actual_file:lines]
+[extract error handler/middleware or throwing pattern]
 ```
 
+**Throw errors using:** `[extract exact syntax]`
+
 ---
 
-## Error Responses
+## Pagination
 
-| 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 |
+<!-- Find if pagination exists, extract pattern -->
 
-**Format**:
-```json
-{
-  "error": {
-    "code": "[ERROR_CODE]",
-    "message": "[human-readable]",
-    "details": "[additional info]"
-  }
-}
+```[lang]
+// Source: [actual_file:lines]
+[extract pagination implementation]
 ```
 
+**Params**: [extract actual query param names used]
+**Defaults**: page=`[find]`, limit=`[find]`
+
 ---
 
-## Rate Limiting
+## Conventions
 
-```[language]
-# Source: [file:lines]
-[rate_limit_config]
-```
+<!-- Extract by analyzing multiple endpoints -->
 
-**Headers**:
-- `X-RateLimit-Limit`: Max requests
-- `X-RateLimit-Remaining`: Requests left
-- `X-RateLimit-Reset`: Reset time
+| Aspect | Convention Used |
+|--------|-----------------|
+| Route naming | `[kebab-case/camelCase/snake_case]` |
+| Controller methods | `[naming pattern found]` |
+| Async handling | `[async/await, promises, try/catch wrapper]` |
+| ID parameter | `[id/:id/uuid format]` |
 
 ---
 
-## Best Practices
+## Anti-Patterns
 
-| ✅ 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 |
+<!-- Document what NOT to do based on codebase patterns -->
+
+| ❌ Avoid | ✅ Use Instead | Reason |
+|----------|----------------|--------|
+| [detect inconsistencies or deprecated patterns] | [correct pattern from code] | [why] |
 
 ---
 
-## References
+## Quick Reference
 
-- **Routes**: `[path/to/routes]`
-- **Models**: `[path/to/models]`
-- **API Docs**: [URL]
+<!-- Condensed lookup table -->
 
----
+| Task | Syntax | Example |
+|------|--------|---------|
+| Define route | `[extract]` | `[file:line]` |
+| Add validation | `[extract]` | `[file:line]` |
+| Protect route | `[extract]` | `[file:line]` |
+| Return success | `[extract]` | `[file:line]` |
+| Throw error | `[extract]` | `[file:line]` |
+
+---

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

@@ -0,0 +1,197 @@
+---
+# Architecture Guide
+
+<!--
+GENERATION INSTRUCTIONS:
+1. Identify architectural style (layered/modular/hexagonal/clean/microservices)
+2. Detect design patterns by scanning code structures
+3. Map actual dependencies between components
+4. Extract from: imports, folder structure, class relationships
+5. Output: 300 lines max
+-->
+
+**Project**: [Extract from config]
+**Style**: [Detect: Layered | Modular | Hexagonal | Clean | Microservices | Monolith]
+**Language**: [Detect] | **Framework**: [Detect]
+
+---
+
+## Architecture Overview
+
+<!-- Generate diagram based on detected style -->
+
+```
+[Generate ASCII diagram showing main components and their relationships]
+```
+
+**Key Decision**: [Extract or infer WHY this architecture - scalability/simplicity/team structure]
+
+---
+
+## Component Structure
+
+<!-- Scan and document actual project organization -->
+
+```
+[root]/
+├── [component1]/     [Detected purpose]
+├── [component2]/     [Detected purpose]
+├── [component3]/     [Detected purpose]
+├── [shared/common]/  [Detected purpose]
+└── [entry point]
+```
+
+---
+
+## Design Patterns Detected
+
+<!-- Scan codebase for these patterns, document only those found -->
+
+| Pattern | Usage | Location |
+|---------|-------|----------|
+| [Repository] | [How it's used] | `[file:line]` |
+| [Factory] | [How it's used] | `[file:line]` |
+| [Singleton] | [How it's used] | `[file:line]` |
+| [Dependency Injection] | [How it's used] | `[file:line]` |
+| [Observer/Event] | [How it's used] | `[file:line]` |
+| [Strategy] | [How it's used] | `[file:line]` |
+
+### Primary Pattern: [Most significant pattern]
+
+```[lang]
+// Source: [file:lines]
+[Extract canonical example of main pattern]
+```
+
+**When to use**: [Detect from usage context]
+
+---
+
+## Layer/Module Responsibilities
+
+<!-- Adapt based on detected architecture style -->
+
+| Component | Responsibility | Depends On | Depended By |
+|-----------|----------------|------------|-------------|
+| [Layer/Module 1] | [Detected role] | [List] | [List] |
+| [Layer/Module 2] | [Detected role] | [List] | [List] |
+| [Layer/Module 3] | [Detected role] | [List] | [List] |
+
+---
+
+## Dependency Rules
+
+<!-- Extract from imports analysis -->
+
+```
+[Component A] ──► [Component B] ──► [Component C]
+                       │
+                       ▼
+                  [Shared/Core]
+```
+
+| Rule | Enforced By |
+|------|-------------|
+| [e.g., Controllers never import Repositories directly] | [Convention / Linter / DI Container] |
+| [e.g., Domain has no external dependencies] | [Convention / Module boundary] |
+
+**Violations to avoid:**
+- ❌ [Detected anti-pattern or rule]
+- ❌ [Detected anti-pattern or rule]
+
+---
+
+## Data Flow
+
+<!-- Trace a typical request through the system -->
+
+```
+[Entry] → [Component1] → [Component2] → [Component3] → [Storage/External]
+   │           │              │              │
+   │      [Transform]    [Process]      [Persist]
+   │           │              │              │
+   └───────────┴──────────────┴──────────────┘
+                     Response
+```
+
+**Example flow** (`[common operation]`):
+1. `[entry point]` receives request
+2. `[component]` validates/transforms
+3. `[component]` executes logic
+4. `[component]` persists/fetches data
+5. Response returns through chain
+
+---
+
+## Key Abstractions
+
+<!-- Find interfaces/base classes that define contracts -->
+
+| Abstraction | Purpose | Implementations |
+|-------------|---------|-----------------|
+| `[Interface/Base]` | [Contract purpose] | `[file:line]` |
+| `[Interface/Base]` | [Contract purpose] | `[file:line]` |
+
+```[lang]
+// Source: [file:lines]
+[Extract key interface/abstract class]
+```
+
+---
+
+## Adding New Features
+
+<!-- Document extension points based on existing patterns -->
+
+### To add new [entity/resource/feature]:
+
+1. **[Component1]**: Create `[path/pattern]`
+2. **[Component2]**: Create `[path/pattern]`
+3. **[Component3]**: Create `[path/pattern]`
+4. **Wire up**: [How components connect - DI/imports/registration]
+
+### To add new [integration/external service]:
+
+1. Create adapter in `[path]`
+2. Implement interface `[interface name]`
+3. Register in `[config/di location]`
+
+---
+
+## Configuration & Environment
+
+<!-- Find how config flows through architecture -->
+
+| Config Type | Location | Accessed Via |
+|-------------|----------|--------------|
+| Environment | `[.env / env files]` | `[config module/pattern]` |
+| App Config | `[config files]` | `[how injected/imported]` |
+| Secrets | `[secrets handling]` | `[access pattern]` |
+
+---
+
+## Boundaries Summary
+
+<!-- Concise rules for AI to follow -->
+
+| ✅ DO | ❌ DON'T |
+|-------|----------|
+| [Detected convention] | [Detected anti-pattern] |
+| [Detected convention] | [Detected anti-pattern] |
+| [Detected convention] | [Detected anti-pattern] |
+| Follow existing [pattern] for new code | Introduce new patterns without reason |
+
+---
+
+## Quick Reference
+
+| Need | Location | Pattern |
+|------|----------|---------|
+| Entry point | `[path]` | - |
+| Business logic | `[path]` | [pattern] |
+| Data access | `[path]` | [pattern] |
+| External services | `[path]` | [pattern] |
+| Shared utilities | `[path]` | - |
+| Configuration | `[path]` | [pattern] |
+
+---