openprompt-lang 0.3.0 → 0.4.0

package/docs/COMMANDS.md

@@ -1,6 +1,6 @@
 # openPrompt-Lang — Comandos CLI
 
-> **Versión:** 0.1.0
+> **Versión:** 0.4.0
 
 ---
 
@@ -18,160 +18,247 @@ npx openprompt-lang <comando>
 
 ### `init` — Inicializar proyecto
 
-Crea la estructura base del proyecto con configuración openPrompt-Lang, incluyendo un `package.json` con scripts descriptivos.
+Crea la estructura base del proyecto con configuración openPrompt-Lang.
 
 ```bash
-npx openPrompt-Lang init [--name nombre] [--describe "descripción"]
+npx openPrompt-Lang init [--name nombre] [--describe "descripción"] [--existing]
 ```
 
 **Opciones:**
 - `--name <nombre>` — Nombre del proyecto (default: mi-proyecto)
 - `--describe <texto>` — Descripción para sugerencia de stack vía IA
+- `--existing` — Configurar proyecto existente (solo prompt-lang.json + AGENTS.md)
+
+---
+
+### `context` — Extraer contexto para IA
+
+Genera un archivo markdown con el código y anotaciones del proyecto.
 
-**Ejemplo interactivo:**
 ```bash
-npx openPrompt-Lang init
-# ? Project name: mi-app
-# ? Use AI to suggest stack? Yes
-# → Crea: package.json (scripts descriptivos), prompt-lang.json, AGENTS.md, docs/, scripts/, estructura src/
+npx openPrompt-Lang context [--output contexto.md] [--scope auth] [--no-ai]
 ```
 
-**Scripts descriptivos generados:**
+**Opciones:**
+- `--output <archivo>` — Archivo de salida (default: contexto.md)
+- `--scope <módulo>` — Filtrar por módulo (@scope)
+- `--no-ai` — No incluir anotaciones PromptLang en el output
 
-| Script | Comando real | Propósito |
-|---|---|---|
-| `dev:start` | `vite` | Iniciar servidor de desarrollo |
-| `dev:preview` | `vite preview` | Vista previa del build |
-| `build:prod` | `vite build` | Build para producción |
-| `build:analyze` | `vite build --analyze` | Build con análisis de bundle |
-| `lint:check` | `eslint src --ext .ts,.tsx` | Verificar lint |
-| `lint:fix` | `eslint src --ext .ts,.tsx --fix` | Auto-corregir lint |
-| `type:check` | `tsc --noEmit` | Verificar tipos TypeScript |
-| `quality:doctor` | `npx react-doctor check ./src` | Auditoría React |
-| `test:unit` | `vitest run` | Ejecutar tests unitarios |
-| `test:watch` | `vitest` | Tests en modo watch |
-| `test:coverage` | `vitest run --coverage` | Tests con cobertura |
-| `validate:all` | lint + typecheck + doctor + test | Pipeline completo
+---
 
-### `context` — Extraer contexto para IA
+### `validate` — Validar proyecto
 
-Genera un archivo markdown con todo el código del proyecto para dar contexto a la IA.
+Ejecuta el pipeline de validación y verifica anotaciones PromptLang.
 
 ```bash
-npx openPrompt-Lang context [--output contexto.md] [--scope auth]
+npx openPrompt-Lang validate [--fix]
 ```
 
 **Opciones:**
-- `--output <archivo>` — Archivo de salida (default: contexto.md)
-- `--scope <módulo>` — Filtrar por módulo (@scope)
-- `--no-ai` — No incluir anotaciones PromptLang
+- `--fix` — Auto-corregir estructura del proyecto (crea src/, docs/, prompt-lang.json, AGENTS.md si faltan)
+
+---
 
 ### `figma` — Generar prompt para Figma
 
-Genera un prompt listo para copiar-pegar en herramientas de diseño Figma.
+Genera un prompt listo para copiar-pegar en Figma.
 
 ```bash
 npx openPrompt-Lang figma
-# ? Tipo: Dashboard SaaS
-# ? Pantallas: Login, Dashboard, Products
-# ? Mobile-first: Yes
-# → docs/PROMPTS/figma-prompt.md
 ```
 
-### `validate` — Validar proyecto
+---
 
-Ejecuta el pipeline de validación y verifica anotaciones PromptLang.
+### `suggest` — Sugerir stack y estructura
+
+Analiza una descripción y sugiere stack, módulos y prioridades vía IA.
 
 ```bash
-npx openPrompt-Lang validate [--fix]
+npx openPrompt-Lang suggest "App de inventario con acceso mobile y dashboard"
+```
+
+---
+
+### `wizard` — Asistente interactivo
+
+Asistente paso a paso para configurar el proyecto openPrompt-Lang, detectar stack, elegir módulos y configurar templates.
+
+```bash
+npx openPrompt-Lang wizard
+```
+
+---
+
+### `teach` — Enseñanza desde template
+
+Muestra lección estructurada, buenas prácticas y código desde un template con @teachMe.
+
+```bash
+npx openPrompt-Lang teach <templateId> [--lang react] [--code] [--force]
 ```
 
 **Opciones:**
-- `--fix` — Auto-corregir errores cuando sea posible
+- `--lang <lang>` — Lenguaje del template (default: react)
+- `--code` — Mostrar código completo del template
+- `--force` — Mostrar template aunque no tenga @teachMe
 
-### `suggest` — Sugerir stack y estructura
+---
+
+### `ai-gen` — Generar componentes vía IA
 
-Analiza una descripción y sugiere stack, módulos y prioridades.
+Genera componentes desde descripciones en lenguaje natural usando OpenAI/Anthropic/Ollama.
 
 ```bash
-npx openPrompt-Lang suggest "App de inventario con acceso mobile y dashboard"
+npx openPrompt-Lang ai-gen --description "un botón con variante danger y loading state"
+```
+
+**Opciones:**
+- `--description <texto>` — Descripción de lo que generar
+- `--name <nombre>` — Nombre del componente (auto-sugerido si se omite)
+- `--lang <lang>` — Módulo de lenguaje (default: react)
+- `--profile <profile>` — senior | mid | junior (default: mid)
+- `--provider <provider>` — openai | anthropic | ollama | mock
+- `--output <dir>` — Directorio de salida (default: src/components)
+- `--force` — Sobrescribir archivos existentes
+- `--validate` — Ejecutar validación de anotaciones después de generar
+- `--temperature <num>` — Temperatura (default: 0.3)
+- `--max-tokens <num>` — Max tokens (default: 4096)
+
+### `ai-providers` — Listar proveedores IA
+
+```bash
+npx openPrompt-Lang ai-providers
+```
+
+---
+
+### `extract` — Extraer templates
+
+Analiza el proyecto y extrae componentes reutilizables como templates en el módulo de lenguaje.
+
+```bash
+npx openPrompt-Lang extract [sourceDir] [--lang react] [--min-reuse 2] [--dry-run]
+```
+
+**Opciones:**
+- `sourceDir` — Directorio a analizar (default: src)
+- `--lang <lang>` — Módulo de lenguaje destino
+- `--min-reuse <n>` — Mínimo de imports para calificar (default: 2)
+- `--dry-run` — Solo analizar, no escribir archivos
+
+### `analyze` — Analizar proyecto
+
+```bash
+npx openPrompt-Lang analyze [sourceDir]
 ```
 
-### `component` — Gestionar biblioteca de componentes
+Muestra estructura, dependencias y salud del código.
+
+---
+
+### `integrate` — Integrar con editores
 
-Gestiona componentes reutilizables desde una biblioteca externa.
+Configura Opencode, Cursor y VS Code para el proyecto.
 
 ```bash
-# Inicializar una biblioteca de componentes
-npx openPrompt-Lang component init --library ./diseno-componentes
+npx openPrompt-Lang integrate [--all] [--lang react] [--no-ask]
+```
 
-# Listar componentes disponibles (proyecto + biblioteca)
-npx openPrompt-Lang component list
+**Opciones:**
+- `--all` — Configurar todas las integraciones sin preguntar
+- `--lang <lang>` — Lenguaje (auto-detectado desde prompt-lang.json)
+- `--no-ask` — Saltar prompts interactivos
 
-# Agregar un componente de la biblioteca al proyecto
-npx openPrompt-Lang component add ConfirmModal
+Genera:
+- `.opencode/opencode.json` + `.opencode/agent/openPrompt.md` + `.opencode/skills/openPrompt/SKILL.md`
+- `.cursor/config.json` + `.cursorrules`
+- `.vscode/settings.json` + `.vscode/extensions.json`
 
-# Ver el manifiesto de la biblioteca
-npx openPrompt-Lang component manifest
+---
 
-# Usar --library si no está configurado en prompt-lang.json
-npx openPrompt-Lang component list --library ./diseno-componentes
+### `qa-gen` — Generar tests desde errores aprendidos
+
+Genera tests Vitest desde anotaciones @learn-error.
+
+```bash
+npx openPrompt-Lang qa-gen [--lang react] [--source src] [--output tests/] [--dry-run]
 ```
 
-**Estructura de la biblioteca:**
+**Opciones:**
+- `--lang <lang>` — Módulo de lenguaje
+- `--source <dir>` — Directorio a escanear por @learn-error
+- `--output <dir>` — Directorio de salida (default: src/__tests__)
+- `--template <id>` — Generar tests solo para un template específico
+- `--dry-run` — Previsualizar sin escribir archivos
+- `--no-scan` — Saltar escaneo de nuevas anotaciones @learn-error
+
+### `qa-learn` — Aprender de errores
 
+Parsea @learn-error de un archivo y lo persiste al módulo de lenguaje.
+
+```bash
+npx openPrompt-Lang qa-learn --file src/mi-archivo.ts [--lang react]
 ```
-diseno-componentes/
-├── componentes.json      ← Manifiesto con nombre, versión, lista de componentes
-├── ui/
-│   ├── Button.tsx        ← Botón con variantes (primary, danger, ghost)
-│   ├── ConfirmModal.tsx  ← Modal centrado para acciones destructivas
-│   ├── Input.tsx         ← Input con label y error
-│   └── index.ts          ← Barrel export
-└── layouts/              ← Layouts reutilizables
+
+---
+
+### `lang` — Gestión de módulos de lenguaje
+
+```bash
+npx openPrompt-Lang lang list                                                    # Listar lenguajes
+npx openPrompt-Lang lang index react [--category components]                      # Índice de templates
+npx openPrompt-Lang lang search "button" [--lang react]                           # Buscar templates
+npx openPrompt-Lang lang errors [react] [--template button-primary]               # Errores aprendidos
 ```
 
-**Configuración en prompt-lang.json:**
-```json
-{
-  "components": {
-    "source": "src/components/ui",
-    "library": "./diseno-componentes"
-  }
-}
+---
+
+### `scaffold` — Scaffolding de proyectos
+
+```bash
+npx openPrompt-Lang scaffold folders react [--name mi-app] [--force]              # Crear estructura
+npx openPrompt-Lang scaffold list                                                 # Frameworks disponibles
 ```
 
 ---
 
-## Configuración (prompt-lang.json)
+### `component` — Biblioteca de componentes
 
-```json
-{
-  "name": "mi-app",
-  "version": "0.1.0",
-  "stack": {
-    "base": ["react", "typescript", "vite", "tailwind"],
-    "extensions": ["supabase"]
-  },
-  "profile": "senior",
-  "pipeline": {
-    "pre-commit": ["lint", "typecheck", "doctor", "test"],
-    "scripts": {
-      "lint:check": "eslint src --ext .ts,.tsx",
-      "type:check": "tsc --noEmit",
-      "quality:doctor": "npx react-doctor check ./src",
-      "test:unit": "vitest run"
-    }
-  },
-  "annotations": { "enabled": true, "strict": false },
-  "docs": { "commits": true, "logs": true, "backlog": true },
-  "extractor": {
-    "ignore": [".env", "*.local", "dist"],
-    "output": "contexto.md"
-  }
-}
+```bash
+npx openPrompt-Lang component init [--library ./diseno-componentes] [--name ...]  # Inicializar biblioteca
+npx openPrompt-Lang component list [--library ./diseno-componentes]               # Listar componentes
+npx openPrompt-Lang component add ConfirmModal [--library ./diseno-componentes]   # Agregar componente
+npx openPrompt-Lang component manifest [--library ./diseno-componentes]           # Mostrar manifiesto
 ```
 
+Agregar componente con opciones:
+```bash
+npx openPrompt-Lang component add Button --template --lang react --variants primary,danger --output MiBoton --force
+```
+
+---
+
+### `mcp` — Servidor MCP
+
+Inicia el servidor MCP (Model Context Protocol) para integración con Opencode.
+
+```bash
+npx openPrompt-Lang mcp
+```
+
+Lee JSON-RPC de stdin y escribe respuestas en stdout. Expone 9 herramientas:
+`validate`, `lint_file`, `parse_code`, `context`, `search_templates`, `teach_template`, `generate_tests`, `analyze_project`, `scaffold_project`.
+
+---
+
+### `lint` — Linting de anotaciones (por archivo)
+
+```bash
+npx openPrompt-Lang lint src/hooks/useAuth.ts
+```
+
+Muestra anotaciones encontradas, errores y warnings. Internamente usa `lintFile()` del parser de anotaciones.
+
 ---
 
 ## Pipeline de Validación
@@ -181,18 +268,13 @@ npx openPrompt-Lang validate
 # → 1. Verifica estructura del proyecto
 # → 2. Valida prompt-lang.json y AGENTS.md
 # → 3. Analiza anotaciones PromptLang en archivos
-# → 4. Ejecuta pipeline configurado (lint:check → type:check → quality:doctor → test:unit)
-# → 5. Reporta resumen
+# → 4. Reporta resumen de errores/warnings
 ```
 
----
-
-## Linting de Anotaciones (por archivo)
-
+Con `--fix`:
 ```bash
-npx openPrompt-Lang lint src/hooks/useAuth.ts
-# → Muestra anotaciones encontradas
-# → Reporta errores y warnings
+npx openPrompt-Lang validate --fix
+# → Además: crea src/, docs/, prompt-lang.json, AGENTS.md si faltan
 ```
 
 ---
@@ -200,30 +282,21 @@ npx openPrompt-Lang lint src/hooks/useAuth.ts
 ## Variables de Entorno
 
 | Variable | Propósito |
-|---|---|---|
-| `OPENAI_API_KEY` | API key de OpenAI para sugerencias IA |
-| `OPENPROMPT_API_KEY` | API key alternativa para openPrompt-Lang |
+|---|---|
+| `OPENAI_API_KEY` | API key de OpenAI para sugerencias IA / ai-gen |
+| `ANTHROPIC_API_KEY` | API key de Anthropic para ai-gen |
+| `OPENPROMPT_API_KEY` | API key alternativa |
 
 ---
 
 ## VS Code Extension
 
-El paquete incluye una extensión para VS Code en `vscode-extension/`:
-
-- **Syntax highlighting**: todos los tags PromptLang (`@kind`, `@props`, `@contract`, etc.) se resaltan en comentarios de TypeScript/JavaScript
-- **Snippets**: prefijo `@kind-` para insertar estructuras completas:
-  - `@kind-hook` → hook con `@contract`
-  - `@kind-component` → componente con `@props`
-  - `@kind-service` → servicio con `@contract` + `@platform`
-  - `@kind-page` → página con `@compose`
-  - `@kind-store` → store Zustand
-  - `@use-header` → declaración `@use()`
-  - `@props-ts` → props con sintaxis tipo TypeScript
-- **Instalación**:
-  ```bash
-  # Desde el proyecto
-  code --install-extension vscode-extension/
-
-  # O empaquetar como .vsix
-  cd vscode-extension && npx @vscode/vsce package && code --install-extension *.vsix
-  ```
+El paquete incluye una extensión VS Code en `vscode-extension/`:
+
+- **Syntax highlighting**: todos los tags PromptLang se resaltan
+- **Snippets**: `@kind-hook`, `@kind-component`, `@kind-service`, `@kind-page`, `@kind-store`, `@use-header`, `@props-ts`
+
+**Instalación:**
+```bash
+code --install-extension ./node_modules/openprompt-lang/vscode-extension/
+```

package/docs/COMMITS/INDEX.md

@@ -9,3 +9,4 @@
 | 2026-05-14 | v0.3.0 | feat: versionado SemVer, sistema de componentes, preparar npm publish |
 | 2026-05-15 | v0.3.0 | fix: eliminar dependencia glob no usada |
 | 2026-05-15 | v0.3.0 | fix: parser paréntesis anidados, @props TS-like, @state(error) condicional, VS Code extension |
+| 2026-05-15 | v0.4.0 | feat: 16 tests nuevos (ai-gen, extract, component), 12 templates Vue, ESLint+Prettier, bugfix analyzeImports |

package/docs/PROMPT_AI_CONTEXT.md

@@ -0,0 +1,99 @@
+# Prompt para dar contexto de openPrompt-Lang a cualquier IA
+
+Copia y pega este prompt al empezar una conversación con **Google Gemini**, **Claude**, **ChatGPT**, o cualquier asistente de IA.
+
+---
+
+## Prompt base
+
+```
+Eres un desarrollador senior especializado en React + TypeScript.
+Vas a trabajar en un proyecto que usa **openPrompt-Lang** — un framework de anotaciones como código para desarrollo asistido por IA.
+
+## Reglas obligatorias
+
+1. TODO archivo nuevo debe empezar con `// @use()` declarando los tags que usa
+2. Usa `@kind` para definir el tipo de elemento (component, hook, service, page, store, util)
+3. Respeta los límites de líneas por archivo:
+   - hook: max 80 líneas
+   - component: max 120 líneas
+   - page: max 200 líneas
+   - service: max 150 líneas
+   - util: max 100 líneas
+4. Cada componente debe manejar los estados: loading, empty, error, success
+5. 100% Tailwind utility classes (no CSS personalizado)
+6. Named exports, no default exports
+7. No usar `any` — usa `unknown` + narrowing
+
+## Anotaciones disponibles
+
+| Tag | Propósito | Ejemplo |
+|-----|-----------|---------|
+| @use | Importar tags | `// @use(kind, contract, limit, deps)` |
+| @kind | Tipo de elemento | `// @kind(component)` |
+| @contract | Contrato de función | `// @contract(in: X -> out: Y @error: Z)` |
+| @props | Props de componente | `// @props({ name: string, age?: number })` |
+| @limit | Límites del archivo | `// @limit(lines: 120, functions: 3)` |
+| @state | Estados visuales | `// @state(loading, empty, error, success)` |
+| @compose | Dependencias internas | `// @compose(Header, Sidebar)` |
+| @deps | Dependencias externas | `// @deps(@external: [react, zustand])` |
+| @platform | Plataforma target | `// @platform(web)` |
+| @scope | Módulo de impacto | `// @scope(module: auth, affects: [login])` |
+| @pattern | Patrón de diseño | `// @pattern(composition)` |
+| @test | Requisitos de test | `// @test(@coverage: 80)` |
+| @meta | Metadatos | `// @meta(@version: "1.0.0")` |
+| @learn-error | Documentar bug | `// @learn-error id=X input='...' expected=N actual=N fix='...'` |
+
+## Validación cruzada
+
+- `@kind(hook)` → requiere `@contract`, prohíbe `@props`, max 80 líneas
+- `@kind(component)` → requiere `@props` (recomendado), prohíbe `@contract`, max 120 líneas
+- `@kind(page)` → requiere `@compose`, max 200 líneas
+- `@kind(service)` → requiere `@contract`, prohíbe `@props` y `@state`, max 150 líneas
+- `@kind(store)` → sugiere `@deps`, max 100 líneas
+
+## Ejemplo
+
+```typescript
+// @use(kind, props, state, limit, pattern)
+// @kind(component)
+// @props({ variant: string, size: string, children: ReactNode, disabled?: boolean })
+// @state(idle, disabled, loading)
+// @limit(lines: 90, functions: 2)
+// @pattern(composition)
+export function Button(props: ButtonProps) { ... }
+```
+
+## Contexto del proyecto
+
+[PEGA AQUI EL CONTENIDO DE contexto.md GENERADO CON: npx openprompt-lang context]
+```
+
+---
+
+## Cómo usarlo
+
+1. **Extrae el contexto del proyecto:**
+   ```bash
+   npx openprompt-lang context --output contexto.md
+   ```
+
+2. **Copia el prompt base arriba y pégalo en la conversación con la IA.**
+
+3. **Reemplaza `[PEGA AQUI EL CONTENIDO DE contexto.md]` con el contenido real de `contexto.md`.**
+
+4. **Alternativa rápida** (si el proyecto es pequeño):
+   ```bash
+   # Pega directamente estos archivos a la IA:
+   cat contexto.md AGENTS.md docs/SYNTAX.md | pbcopy  # macOS
+   cat contexto.md AGENTS.md docs/SYNTAX.md | clip    # Windows
+   ```
+
+---
+
+## Tips para mejores resultados
+
+- **Sé específico**: di "genera un hook useAuth con @kind(hook) y @contract" en vez de solo "genera un hook"
+- **Muestra ejemplos**: si la IA genera código sin anotaciones, muestra un ejemplo concreto
+- **Valida siempre**: `npx openprompt-lang validate` detecta errores que la IA pueda pasar por alto
+- **Documenta errores**: cuando la IA cometa un error, agrega `// @learn-error` para que futuras sesiones no lo repitan

package/docs/langs/dotnet.md

@@ -0,0 +1,36 @@
+# PromptLang para C# / .NET
+
+## Tags Adaptados
+
+| Tag PromptLang | Equivalente C# | Descripción |
+|---|---|---|
+| `@kind(controller)` | `[ApiController]` | Controlador Web API |
+| `@kind(service)` | `class Service` | Lógica de negocio |
+| `@kind(repository)` | `DbContext` / `Repository` | Acceso a datos EF Core |
+| `@kind(entity)` | `class Entity` | Modelo de datos |
+| `@kind(dto)` | `record` | DTO |
+| `@kind(middleware)` | `Middleware` | Middleware pipeline |
+
+## Contratos
+
+```csharp
+// @kind(controller)
+// @contract(in: CreateUserRequest -> out: UserResponse @error: ValidationProblemDetails)
+// @platform(dotnet)
+[ApiController]
+[Route("api/[controller]")]
+public class UsersController : ControllerBase { ... }
+
+// @kind(service)
+// @contract(in: UserDto -> out: User @error: DbUpdateException)
+// @limit(lines: 120)
+public class UserService { ... }
+```
+
+## Scaffolding Generado
+
+- `UsersController.cs` (endpoints REST)
+- `UserService.cs` (lógica con DI)
+- `UserRepository.cs` (EF Core queries)
+- `User.cs` (entidad con data annotations)
+- `UserDto.cs` (record inmutable)

package/docs/langs/java-spring.md

@@ -0,0 +1,45 @@
+# PromptLang para Java Spring Boot
+
+## Tags Adaptados
+
+| Tag PromptLang | Equivalente Java | Descripción |
+|---|---|---|
+| `@kind(service)` | `@Service` | Servicio con lógica de negocio |
+| `@kind(controller)` | `@RestController` | Controlador REST |
+| `@kind(repository)` | `@Repository` | Acceso a datos JPA |
+| `@kind(entity)` | `@Entity` | Entidad JPA |
+| `@kind(dto)` | `record` / `class` | DTO de entrada/salida |
+| `@kind(config)` | `@Configuration` | Configuración |
+| `@kind(exception)` | `@ControllerAdvice` | Manejador de excepciones |
+
+## Contratos
+
+```java
+// @kind(controller)
+// @contract(in: CreateUserDTO -> out: UserDTO @error: ValidationException)
+// @platform(spring-boot)
+@RestController
+@RequestMapping("/api/users")
+public class UserController { ... }
+
+// @kind(service)
+// @contract(in: UserDTO -> out: User @error: DataIntegrityException)
+// @limit(lines: 100)
+@Service
+public class UserService { ... }
+
+// @kind(repository)
+// @contract(in: Long -> out: Optional<User>)
+@Repository
+public interface UserRepository extends JpaRepository<User, Long> { ... }
+```
+
+## Scaffolding Generado
+
+`npx scaffold service --platform=spring-boot --contract="DTO->Entity"` genera:
+- `UserController.java` (REST endpoints)
+- `UserService.java` (lógica con @Transactional)
+- `UserRepository.java` (JPA CRUD)
+- `User.java` (entidad con validaciones @NotNull, @Email)
+- `UserDTO.java` (record con @Valid)
+- `GlobalExceptionHandler.java` (manejo errores)

package/docs/langs/python-fastapi.md

@@ -0,0 +1,35 @@
+# PromptLang para Python FastAPI
+
+## Tags Adaptados
+
+| Tag PromptLang | Equivalente Python | Descripción |
+|---|---|---|
+| `@kind(router)` | `@router` | Router de FastAPI |
+| `@kind(service)` | `class Service` | Lógica de negocio |
+| `@kind(model)` | `BaseModel` (Pydantic) | Modelo de datos |
+| `@kind(schema)` | `BaseModel` | Esquema request/response |
+| `@kind(deps)` | `Depends()` | Dependencias FastAPI |
+
+## Contratos
+
+```python
+# @kind(router)
+# @contract(in: CreateUserSchema -> out: UserSchema @error: HTTPException)
+# @platform(fastapi)
+@router.post("/users", response_model=UserSchema)
+async def create_user(data: CreateUserSchema): ...
+
+# @kind(service)
+# @contract(in: UserCreate -> out: User @error: IntegrityError)
+# @limit(lines: 80)
+class UserService:
+    async def create(self, data: UserCreate) -> User: ...
+```
+
+## Scaffolding Generado
+
+- `routes/users.py` (endpoints)
+- `services/user_service.py` (lógica)
+- `models/user.py` (SQLAlchemy model)
+- `schemas/user.py` (Pydantic schemas)
+- `core/database.py` (conexión)

package/docs/langs/unity.md

@@ -0,0 +1,30 @@
+# PromptLang para Unity (C#)
+
+## Tags Adaptados
+
+| Tag PromptLang | Equivalente Unity | Descripción |
+|---|---|---|
+| `@kind(monobehaviour)` | `MonoBehaviour` | Componente Unity |
+| `@kind(scriptable)` | `ScriptableObject` | Configuración/Data |
+| `@kind(manager)` | `GameManager` | Singleton manager |
+| `@kind(ui)` | `UI Behaviour` | Componente UI Unity |
+| `@kind(state)` | `StateMachine` | Máquina de estados |
+
+## Contratos
+
+```csharp
+// @kind(monobehaviour)
+// @contract(in: float -> out: Vector3)
+// @limit(lines: 150)
+// @platform(unity)
+public class PlayerMovement : MonoBehaviour { ... }
+
+// @kind(manager)
+// @contract(in: GameEvent -> out: Unit @error: GameException)
+public class GameManager : MonoBehaviour { ... }
+```
+
+## Notas
+- `@limit` default para MonoBehaviour: 150 líneas
+- `@state` se mapea a animator parameters
+- Usar `@deps(@external: [UniTask, DOTween])` para dependencias comunes