agent-ctx 1.0.0 → 2.0.0

package/src/templates/es/skills/skill-api.md

@@ -1,117 +0,0 @@
----
-name: api-design
-description: Diseña APIs REST con patrones consistentes, códigos HTTP apropiados y validación. Usar cuando se crean endpoints, manejo de errores o versionado de APIs.
----
-
-# API Design
-
-Patrones y mejores prácticas para diseñar APIs REST.
-
-## Cuándo usar
-
-- Diseñar endpoints REST
-- Manejar errores de forma consistente
-- Versionado de APIs
-- Validación de requests
-
-## Convenciones REST
-
-### Estructura de URLs
-
-```
-GET    /api/v1/users          # Listar usuarios
-GET    /api/v1/users/:id      # Obtener usuario
-POST   /api/v1/users          # Crear usuario
-PUT    /api/v1/users/:id      # Actualizar completo
-PATCH  /api/v1/users/:id      # Actualizar parcial
-DELETE /api/v1/users/:id      # Eliminar usuario
-```
-
-### Query Parameters
-
-```
-GET /api/v1/users?
-  page=1&                     # Paginación
-  limit=20&                   # Items por página
-  sort=createdAt:desc&        # Ordenamiento
-  filter[status]=active       # Filtros
-```
-
-## Respuestas Estándar
-
-### Éxito (200, 201)
-
-```json
-{
-  "success": true,
-  "data": { "id": "123", "name": "John Doe" },
-  "meta": { "page": 1, "total": 100 }
-}
-```
-
-### Error (400, 404, 500)
-
-```json
-{
-  "success": false,
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Email is required",
-    "details": [{ "field": "email", "message": "Required" }]
-  }
-}
-```
-
-## Códigos HTTP
-
-| Código | Significado | Uso |
-|--------|-------------|-----|
-| 200 | OK | GET, PUT/PATCH exitoso |
-| 201 | Created | POST exitoso |
-| 204 | No Content | DELETE exitoso |
-| 400 | Bad Request | Validación fallida |
-| 401 | Unauthorized | No autenticado |
-| 403 | Forbidden | Sin permisos |
-| 404 | Not Found | Recurso no existe |
-| 500 | Server Error | Error interno |
-
-## Ejemplo de Validación
-
-```typescript
-import { z } from 'zod';
-
-const userSchema = z.object({
-  email: z.string().email(),
-  name: z.string().min(2),
-  role: z.enum(['admin', 'user'])
-});
-
-export function validate(schema: z.ZodSchema) {
-  return (req, res, next) => {
-    const result = schema.safeParse(req.body);
-    if (!result.success) {
-      return res.status(400).json({
-        success: false,
-        error: { code: 'VALIDATION_ERROR', details: result.error.issues }
-      });
-    }
-    req.body = result.data;
-    next();
-  };
-}
-```
-
-## Mejores prácticas
-
-### ✅ Hacer
-
-- Usar HTTPS siempre
-- Versionado en URL (`/api/v1/`)
-- Rate limiting
-- Respuestas consistentes
-
-### ❌ Evitar
-
-- Verbos en URLs (`/getUsers`, `/deleteUser`)
-- Exponer IDs internos
-- Respuestas sin formato estándar

package/src/templates/es/skills/skill-git.md

@@ -1,108 +0,0 @@
----
-name: git-workflow
-description: Convenciones Git, estrategias de branching y formato de commits. Usar cuando se crean commits, branches, PRs o se resuelven conflictos.
----
-
-# Git Workflow
-
-Convenciones Git, commits y patrones de flujo de trabajo.
-
-## Cuándo usar
-
-- Escribir mensajes de commit
-- Crear feature branches
-- Gestionar pull requests
-- Resolver conflictos o hacer rebase
-
-## Commits (Conventional Commits)
-
-### Formato
-
-```
-<type>(<scope>): <description>
-
-[cuerpo opcional]
-
-[footer opcional]
-```
-
-### Tipos
-
-| Tipo | Descripción |
-|------|-------------|
-| `feat` | Nueva funcionalidad |
-| `fix` | Corrección de bug |
-| `docs` | Solo documentación |
-| `style` | Formato (sin cambio de código) |
-| `refactor` | Refactorización |
-| `test` | Añadir/modificar tests |
-| `chore` | Mantenimiento, deps |
-| `perf` | Mejora de rendimiento |
-
-### Ejemplos
-
-```bash
-feat(auth): añadir login con Google OAuth
-fix(api): manejar respuesta null en fetch de usuario
-docs: actualizar guía de instalación
-
-# Breaking change
-feat(api)!: cambiar formato de respuesta
-
-BREAKING CHANGE: Response ahora devuelve datos en `result` en vez de `data`
-```
-
-## Estrategia de Branching (Git Flow)
-
-```
-main (producción)
-  │
-  └── develop (desarrollo)
-        │
-        ├── feature/nueva-funcionalidad
-        ├── bugfix/corregir-bug
-        └── release/v1.2.0
-```
-
-### Crear Feature Branch
-
-```bash
-git checkout develop
-git pull origin develop
-git checkout -b feature/nombre-descriptivo
-```
-
-## Comandos Útiles
-
-```bash
-# Stash
-git stash                    # Guardar cambios
-git stash pop                # Restaurar cambios
-
-# Rebase interactivo
-git rebase -i HEAD~3         # Últimos 3 commits
-
-# Cherry Pick
-git cherry-pick abc123       # Aplicar commit específico
-
-# Bisect (encontrar bug)
-git bisect start
-git bisect bad               # Commit actual tiene bug
-git bisect good abc123       # Commit bueno conocido
-```
-
-## Mejores prácticas
-
-### ✅ Hacer
-
-- Commits atómicos (un cambio lógico por commit)
-- PRs pequeños y enfocados
-- Rebase antes de merge
-- Squash commits WIP
-
-### ❌ Evitar
-
-- Commits con solo "fix" o "update"
-- PRs gigantes (>500 líneas)
-- Force push a branches compartidas
-- Mezclar refactors con features

package/src/templates/es/skills/skill-react.md

@@ -1,94 +0,0 @@
----
-name: react-patterns
-description: Patrones de componentes React, hooks y mejores prácticas con TypeScript. Usar cuando se crean componentes, custom hooks u optimización de renderizado.
----
-
-# React Patterns
-
-Patrones y mejores prácticas para desarrollo React.
-
-## Cuándo usar
-
-- Crear componentes reutilizables
-- Manejar estado complejo
-- Optimizar rendimiento de renderizado
-- Construir custom hooks
-
-## Patrones de Componentes
-
-### Componente Funcional con Props Tipadas
-
-```tsx
-interface ButtonProps {
-  variant: 'primary' | 'secondary';
-  children: React.ReactNode;
-  onClick?: () => void;
-  disabled?: boolean;
-}
-
-export function Button({ variant, children, onClick, disabled }: ButtonProps) {
-  return (
-    <button
-      className={`btn btn-${variant}`}
-      onClick={onClick}
-      disabled={disabled}
-    >
-      {children}
-    </button>
-  );
-}
-```
-
-### Custom Hook
-
-```tsx
-function useToggle(initialValue = false) {
-  const [value, setValue] = useState(initialValue);
-  
-  const toggle = useCallback(() => setValue(v => !v), []);
-  const setTrue = useCallback(() => setValue(true), []);
-  const setFalse = useCallback(() => setValue(false), []);
-  
-  return { value, toggle, setTrue, setFalse };
-}
-```
-
-### Compound Components
-
-```tsx
-const Card = ({ children }) => <div className="card">{children}</div>;
-Card.Header = ({ children }) => <div className="card-header">{children}</div>;
-Card.Body = ({ children }) => <div className="card-body">{children}</div>;
-
-// Uso:
-<Card>
-  <Card.Header>Título</Card.Header>
-  <Card.Body>Contenido</Card.Body>
-</Card>
-```
-
-## Estructura de Directorios
-
-```
-components/
-├── ui/           # Componentes base (Button, Input, Modal)
-├── features/     # Componentes específicos de features
-├── layouts/      # Layouts y wrappers
-└── hooks/        # Custom hooks reutilizables
-```
-
-## Mejores prácticas
-
-### ✅ Hacer
-
-- Usar `useMemo` y `useCallback` para optimización
-- Tipar todas las props con TypeScript
-- Extraer lógica a custom hooks
-- Composición sobre herencia
-
-### ❌ Evitar
-
-- Props drilling excesivo (usar Context)
-- useEffect sin dependencias correctas
-- Estado en el componente incorrecto
-- Listas sin `key`

package/src/templates/es/skills/skill-testing.md

@@ -1,139 +0,0 @@
----
-name: testing-practices
-description: Estrategias de testing, patrones y mejores prácticas con Jest/Vitest. Usar cuando se escriben unit tests, integration tests o mocking de dependencias.
----
-
-# Testing Practices
-
-Estrategias y patrones para testing efectivo.
-
-## Cuándo usar
-
-- Escribir unit tests
-- Crear integration tests
-- Mockear dependencias
-- Testear componentes React
-
-## Pirámide de Testing
-
-```
-        /\
-       /  \     E2E Tests (Playwright, Cypress)
-      /----\    
-     /      \   Integration Tests
-    /--------\  
-   /          \ Unit Tests
-  /____________\
-```
-
-## Unit Tests (Vitest)
-
-### Test Básico
-
-```typescript
-import { describe, it, expect } from 'vitest';
-import { sum } from './sum';
-
-describe('sum', () => {
-  it('debería sumar dos números positivos', () => {
-    expect(sum(1, 2)).toBe(3);
-  });
-  
-  it('debería manejar números negativos', () => {
-    expect(sum(-1, 1)).toBe(0);
-  });
-});
-```
-
-### Test con Setup/Teardown
-
-```typescript
-describe('UserService', () => {
-  let service: UserService;
-  
-  beforeEach(() => {
-    service = new UserService();
-  });
-  
-  afterEach(() => {
-    vi.clearAllMocks();
-  });
-  
-  it('debería crear un usuario', async () => {
-    const user = await service.create({ name: 'Test' });
-    expect(user.id).toBeDefined();
-  });
-});
-```
-
-## Mocking
-
-```typescript
-// Mock de módulo
-vi.mock('./database', () => ({
-  query: vi.fn().mockResolvedValue([{ id: 1, name: 'Test' }])
-}));
-
-// Mock de función
-const mockFetch = vi.fn().mockResolvedValue({
-  json: () => Promise.resolve({ data: 'test' })
-});
-
-// Spy
-const spy = vi.spyOn(console, 'log');
-myFunction();
-expect(spy).toHaveBeenCalledWith('mensaje esperado');
-```
-
-## React Testing Library
-
-```typescript
-import { render, screen, fireEvent } from '@testing-library/react';
-
-test('debería mostrar e interactuar con botón', async () => {
-  const handleClick = vi.fn();
-  render(<Button onClick={handleClick}>Click me</Button>);
-  
-  const button = screen.getByRole('button', { name: /click me/i });
-  expect(button).toBeInTheDocument();
-  
-  await fireEvent.click(button);
-  expect(handleClick).toHaveBeenCalledTimes(1);
-});
-```
-
-## Estructura de Tests
-
-```
-__tests__/
-├── unit/
-│   ├── services/
-│   └── utils/
-├── integration/
-│   └── api/
-└── e2e/
-    └── flows/
-```
-
-## Mejores prácticas
-
-### ✅ Hacer
-
-- Una aserción por test (cuando sea posible)
-- Nombres descriptivos: `debería_X_cuando_Y`
-- Arrange-Act-Assert (AAA)
-- Tests independientes
-
-### ❌ Evitar
-
-- Tests que dependen del orden
-- Lógica en tests
-- Tests flaky (intermitentes)
-- Mockear todo indiscriminadamente
-
-## Cobertura Recomendada
-
-- Statements: 80%
-- Branches: 75%
-- Functions: 80%
-- Lines: 80%