specleap-framework 2.0.7 → 2.0.8

package/.continue/rules/02-spec-format.md

@@ -0,0 +1,76 @@
+---
+name: OpenSpec Format
+globs: ["**/openspec/**/*.md", "**/*.spec.md"]
+alwaysApply: false
+description: Formato estándar para especificaciones OpenSpec
+---
+
+# Formato de Especificaciones
+
+## Estructura de Archivo Spec
+
+```markdown
+# [SPEC-XXX] Nombre de la Especificación
+
+| Campo | Valor |
+|-------|-------|
+| ID | SPEC-XXX |
+| Versión | 1.0.0 |
+| Estado | draft / review / approved / implemented |
+| Prioridad | critical / high / medium / low |
+| Proyecto | nombre-proyecto |
+
+## Descripción
+Qué hace este componente/feature
+
+## Requisitos
+
+### Requirement: Nombre del requisito
+- The system SHALL [obligatorio].
+- The system SHOULD [recomendado].
+- The system MAY [opcional].
+
+## Escenarios
+
+### Scenario: Nombre del escenario
+- GIVEN [precondición]
+- WHEN [acción]
+- THEN [resultado]
+- AND [resultado adicional]
+
+## Criterios de Aceptación
+- [ ] CA-01: ...
+- [ ] CA-02: ...
+
+## Dependencias
+| Tipo | Spec ID | Descripción |
+|------|---------|-------------|
+| Depende de | SPEC-XXX | Razón |
+
+## Notas Técnicas
+Decisiones de implementación, restricciones, etc.
+```
+
+## Palabras Clave RFC-2119
+
+- `SHALL` = obligatorio (MUST)
+- `SHOULD` = recomendado
+- `MAY` = opcional
+
+## Escenarios BDD
+
+Usar formato Gherkin:
+- `GIVEN` = precondición/contexto
+- `WHEN` = acción del usuario/sistema
+- `THEN` = resultado esperado
+- `AND` = condiciones adicionales
+
+## Estados de Spec
+
+| Estado | Significado |
+|--------|-------------|
+| `draft` | En borrador, no aprobada |
+| `review` | En revisión |
+| `approved` | Aprobada, lista para implementar |
+| `implemented` | Implementada y testeada |
+| `deprecated` | Obsoleta |

package/.continue/rules/03-code-standards.md

@@ -0,0 +1,64 @@
+---
+name: Code Standards
+globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.php", "**/*.py"]
+alwaysApply: false
+description: Estándares de código para desarrollo
+---
+
+# Estándares de Código
+
+## Principios
+
+1. **DRY** — No repetir lógica
+2. **KISS** — La solución más simple que funcione
+3. **YAGNI** — No construir lo que no se necesita aún
+4. **Tests primero** — TDD cuando sea práctico
+
+## Idioma
+
+- **Código**: Variables, funciones, clases en **inglés**
+- **Comentarios**: En **español**
+- **Documentación**: En **español**
+- **Commits**: En **español** (prefijos en inglés)
+
+## TypeScript/JavaScript
+
+- Componentes funcionales con hooks
+- TypeScript strict mode
+- Nombres de componentes en PascalCase
+- Hooks personalizados con prefijo `use`
+- Props tipadas con interfaces
+
+```typescript
+// ✅ Correcto
+interface UserCardProps {
+  user: User;
+  onSelect: (id: string) => void;
+}
+
+// Componente para mostrar información del usuario
+const UserCard: React.FC<UserCardProps> = ({ user, onSelect }) => {
+  // ...
+};
+```
+
+## PHP/Laravel
+
+- PSR-12 coding standard
+- Eloquent para queries
+- Form Requests para validación
+- Resources para transformar respuestas API
+
+## Seguridad
+
+- ❌ Nunca hardcodear credenciales
+- ✅ Validar TODOS los inputs
+- ✅ Sanitizar outputs
+- ✅ CSRF protection activa
+- ✅ Prepared statements / ORM
+
+## Testing
+
+- Unit tests: lógica de negocio 80%+
+- Integration tests: APIs y flujos
+- Cobertura mínima documentada en spec

package/.continue/rules/04-git-workflow.md

@@ -0,0 +1,80 @@
+---
+name: Git Workflow & Commits
+globs: ["**/.git/**", "**/CHANGELOG*", "**/COMMIT*"]
+alwaysApply: false
+description: Formato de commits y flujo de Git
+---
+
+# Git Workflow
+
+## Formato de Commit
+
+```
+tipo(alcance): descripción corta en español
+
+## Qué se hizo
+- Descripción detallada del cambio
+
+## Por qué
+- Justificación del cambio
+
+## Archivos modificados
+- ruta/archivo.ts — qué se cambió
+
+## Tests
+- Tests añadidos/modificados
+
+## Refs
+- Jira: PROJ-XXX
+- Spec: openspec/specs/functional/FXXX-nombre.spec.md
+```
+
+## Tipos de Commit
+
+| Tipo | Uso |
+|------|-----|
+| `feat` | Nueva funcionalidad |
+| `fix` | Corrección de bug |
+| `refactor` | Reestructuración sin cambio funcional |
+| `docs` | Documentación |
+| `test` | Tests |
+| `chore` | Mantenimiento, dependencias |
+| `style` | Formato, linting |
+| `perf` | Mejoras de rendimiento |
+
+## Branch Naming
+
+```
+tipo/JIRA-XXX-descripcion-corta
+```
+
+Ejemplos:
+- `feat/PROJ-123-user-authentication`
+- `fix/PROJ-456-login-redirect`
+- `refactor/PROJ-789-cleanup-utils`
+
+## Reglas
+
+1. **Un commit = un cambio lógico** (no mezclar features)
+2. **Mensajes en español** (tipo en inglés)
+3. **Nunca push directo a main** — siempre PR
+4. **Squash merge** para historial limpio
+5. **Code review obligatorio** antes de merge
+
+## Testing Report en PR
+
+Cada PR debe incluir:
+
+```markdown
+## Testing Report
+
+| Suite | Tests | Passed | Failed | Coverage |
+|-------|-------|--------|--------|----------|
+| Unit | XX | XX | 0 | XX% |
+| Integration | XX | XX | 0 | N/A |
+
+### Review Status
+- [ ] Code review aprobado
+- [ ] Tests pasan
+- [ ] Coverage mínimo alcanzado
+```

package/.continue/rules/05-testing-report.md

@@ -0,0 +1,63 @@
+---
+name: Testing Report Format
+globs: ["**/tasks.md", "**/*test*", "**/*spec*"]
+alwaysApply: false
+description: Formato obligatorio de Testing Report
+---
+
+# Testing Report (OBLIGATORIO)
+
+Cada feature completada DEBE incluir un Testing Report.
+
+## Formato Estándar
+
+```markdown
+## Testing Report
+
+### Resultados
+| Suite | Tests | Passed | Failed | Skipped | Coverage |
+|-------|-------|--------|--------|---------|----------|
+| Unit | X | X | 0 | 0 | XX% |
+| Integration | X | X | 0 | 0 | N/A |
+| E2E | X | X | 0 | 0 | N/A |
+
+### Cobertura por Módulo
+| Módulo | Statements | Branches | Functions | Lines |
+|--------|------------|----------|-----------|-------|
+| src/module | XX% | XX% | XX% | XX% |
+
+### Comando de Ejecución
+\`\`\`bash
+npm test -- --coverage
+\`\`\`
+
+### Code Review Status
+- [ ] Review solicitado
+- [ ] Comentarios resueltos
+- [ ] Review aprobado
+
+### Notas
+- Observaciones relevantes sobre los tests
+```
+
+## Cobertura Mínima
+
+| Tipo de Código | Cobertura Mínima |
+|----------------|------------------|
+| Lógica de negocio | 80% |
+| Utilidades | 90% |
+| Componentes UI | Tests de comportamiento |
+
+## Convención de Nombres de Tests
+
+```typescript
+describe('[NombreComponente]', () => {
+  it('debería [comportamiento] cuando [condición]', () => {
+    // Arrange → Act → Assert
+  });
+});
+```
+
+## Regla de Oro
+
+> **Si no hay Testing Report, no hay merge.**

package/.continuerules

@@ -0,0 +1,40 @@
+# Continue Rules for ArchSpec
+
+You are a development assistant working under **Spec-Driven Development (SDD)** methodology via ArchSpec.
+
+## Critical Rules
+
+1. **NEVER write code without a spec first.** If no spec exists, create one with `openspec new`.
+2. **NEVER skip the approval step.** Present spec/proposal and wait for confirmation before implementing.
+3. **NEVER hardcode values.** Everything configurable goes in env/config files.
+4. **ALWAYS link commits to specs and Jira tickets.**
+
+## Workflow (mandatory)
+
+```
+SPEC → APPROVE → CODE → TEST → REVIEW → SHIP
+```
+
+## Available Commands
+
+- `openspec new CHANGE-XXX "desc"` — Create change proposal
+- `openspec apply CHANGE-XXX` — Implement approved proposal
+- `openspec verify CHANGE-XXX` — Run tests + verify spec
+- `openspec status` — List active proposals
+- `openspec jira ls` — List open Jira issues
+
+## Before writing any code:
+
+1. Search for existing similar functionality
+2. Check existing specs in `openspec/specs/`
+3. Replicate existing patterns exactly — never invent new ones without approval
+
+## Commit format:
+
+```
+feat(scope): short description
+
+Refs: CHANGE-XXX, SCRUM-X
+```
+
+Full reference: See CLAUDE.md for complete rules.

package/.cursorrules

@@ -0,0 +1,44 @@
+# Cursor Rules — DevFlow Pro SDD
+
+## Metodología: Spec-Driven Development
+Primero la especificación, luego el código. Nunca al revés.
+
+## Estructura
+- `openspec/specs/` — Especificaciones (source of truth)
+- `openspec/changes/` — Propuestas de cambios
+- `openspec/templates/` — Plantillas
+
+## Flujo de Trabajo
+1. Crear/actualizar spec antes de codificar
+2. Crear propuesta en `openspec/changes/CHANGE-XXXX-nombre/`
+3. Implementar según spec
+4. Escribir tests con Testing Report
+5. Code review obligatorio
+6. Merge con aprobación
+
+## Formato de Specs
+- Escenarios: GIVEN/WHEN/THEN
+- Requisitos: SHALL (obligatorio), SHOULD (recomendado), MAY (opcional)
+- Estados: draft → review → approved → implemented
+
+## Código
+- Idioma código: inglés
+- Idioma comentarios: español
+- TypeScript strict mode
+- Cobertura mínima: 80% lógica de negocio
+
+## Commits
+Formato: `tipo(alcance): descripción en español`
+Tipos: feat, fix, refactor, docs, test, chore, style, perf
+Incluir: refs a Jira y Spec
+
+## Testing Report (OBLIGATORIO)
+Cada feature documenta:
+- Resultados de tests (unit, integration, e2e)
+- Cobertura por módulo
+- Status de code review
+
+## Reglas de Oro
+1. Sin spec no hay código
+2. Sin tests no hay merge
+3. Sin review no hay deploy

package/.github/copilot-instructions.md

@@ -0,0 +1,54 @@
+# GitHub Copilot Instructions — DevFlow Pro SDD
+
+## Metodología: Spec-Driven Development
+
+> **Primero la especificación, luego el código. Nunca al revés.**
+
+### Flujo de Trabajo
+1. Crear spec antes de codificar (`openspec/specs/`)
+2. Crear propuesta de cambio (`openspec/changes/`)
+3. Implementar según spec
+4. Tests obligatorios con Testing Report
+5. Code review obligatorio
+6. Merge solo con aprobación
+
+### Estructura del Proyecto
+```
+openspec/
+├── specs/           # Especificaciones (source of truth)
+├── changes/         # Propuestas de cambios
+└── templates/       # Plantillas
+```
+
+### Formato de Specs
+- Usar GIVEN/WHEN/THEN para escenarios
+- SHALL = obligatorio, SHOULD = recomendado, MAY = opcional
+- Estados: draft → review → approved → implemented
+
+### Código
+- Variables/funciones en inglés
+- Comentarios en español
+- TypeScript strict mode
+- Tests con 80%+ cobertura en lógica de negocio
+
+### Commits
+```
+tipo(alcance): descripción en español
+
+## Qué se hizo
+## Por qué
+## Refs: Jira/Spec
+```
+
+Tipos: feat, fix, refactor, docs, test, chore, style, perf
+
+### Testing Report (OBLIGATORIO)
+Cada feature debe documentar:
+- Tests ejecutados y resultados
+- Cobertura por módulo
+- Status de code review
+
+### Reglas
+1. Sin spec no hay código
+2. Sin tests no hay merge
+3. Sin review no hay deploy

package/.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+  "recommendations": [
+    "shd101wyy.markdown-preview-enhanced",
+    "yzhang.markdown-all-in-one",
+    "davidanson.vscode-markdownlint",
+    "bierner.markdown-mermaid",
+    "bierner.markdown-emoji",
+    "esbenp.prettier-vscode"
+  ]
+}

package/.vscode/markdown.css

@@ -0,0 +1,235 @@
+/* ArchSpec Markdown Preview Styling */
+/* Estilo profesional tipo documentación */
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+  font-size: 16px;
+  line-height: 1.6;
+  color: #24292e;
+  background-color: #ffffff;
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+/* Headers con estilo de documentación */
+h1 {
+  font-size: 2.5rem;
+  font-weight: 600;
+  border-bottom: 2px solid #eaecef;
+  padding-bottom: 0.5rem;
+  margin-top: 2rem;
+  margin-bottom: 1.5rem;
+  color: #1a1a1a;
+}
+
+h2 {
+  font-size: 2rem;
+  font-weight: 600;
+  border-bottom: 1px solid #eaecef;
+  padding-bottom: 0.3rem;
+  margin-top: 1.5rem;
+  margin-bottom: 1rem;
+  color: #1a1a1a;
+}
+
+h3 {
+  font-size: 1.5rem;
+  font-weight: 600;
+  margin-top: 1.2rem;
+  margin-bottom: 0.8rem;
+  color: #2c3e50;
+}
+
+h4 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-top: 1rem;
+  margin-bottom: 0.6rem;
+  color: #34495e;
+}
+
+/* Tablas estilo documentación */
+table {
+  border-collapse: collapse;
+  width: 100%;
+  margin: 1.5rem 0;
+  font-size: 0.95rem;
+  box-shadow: 0 2px 4px rgba(0,0,0,0.05);
+}
+
+table thead {
+  background-color: #f6f8fa;
+}
+
+table th {
+  padding: 0.75rem 1rem;
+  text-align: left;
+  font-weight: 600;
+  border: 1px solid #d0d7de;
+  color: #1a1a1a;
+}
+
+table td {
+  padding: 0.75rem 1rem;
+  border: 1px solid #d0d7de;
+}
+
+table tbody tr:nth-child(even) {
+  background-color: #f9fafb;
+}
+
+table tbody tr:hover {
+  background-color: #f1f3f5;
+}
+
+/* Code blocks estilo GitHub/GitBook */
+code {
+  background-color: #f6f8fa;
+  border-radius: 3px;
+  padding: 0.2em 0.4em;
+  font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
+  font-size: 0.9em;
+  color: #e83e8c;
+}
+
+pre {
+  background-color: #f6f8fa;
+  border-radius: 6px;
+  padding: 1rem;
+  overflow-x: auto;
+  margin: 1.5rem 0;
+  border: 1px solid #e1e4e8;
+}
+
+pre code {
+  background-color: transparent;
+  padding: 0;
+  color: #24292e;
+}
+
+/* Blockquotes estilo tip/warning */
+blockquote {
+  border-left: 4px solid #0969da;
+  background-color: #ddf4ff;
+  padding: 0.8rem 1rem;
+  margin: 1.5rem 0;
+  border-radius: 0 6px 6px 0;
+}
+
+blockquote p {
+  margin: 0;
+}
+
+/* Links con estilo profesional */
+a {
+  color: #0969da;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+/* Listas con mejor espaciado */
+ul, ol {
+  padding-left: 2rem;
+  margin: 1rem 0;
+}
+
+li {
+  margin: 0.5rem 0;
+}
+
+/* Checkboxes para tareas */
+input[type="checkbox"] {
+  margin-right: 0.5rem;
+}
+
+/* Badges/labels estilo GitHub */
+.badge {
+  display: inline-block;
+  padding: 0.25em 0.6em;
+  font-size: 0.75em;
+  font-weight: 600;
+  line-height: 1;
+  border-radius: 12px;
+  background-color: #0969da;
+  color: white;
+}
+
+/* Horizontal rule más sutil */
+hr {
+  border: none;
+  border-top: 1px solid #d0d7de;
+  margin: 2rem 0;
+}
+
+/* Status badges (para proposal.md, tasks.md) */
+/* Simular con strong tags */
+strong {
+  font-weight: 600;
+}
+
+/* Warnings/notes con emoji */
+p:has(> strong:first-child):has(⚠️) {
+  background-color: #fff8c5;
+  border-left: 4px solid #e5c800;
+  padding: 0.8rem 1rem;
+  border-radius: 0 6px 6px 0;
+}
+
+p:has(> strong:first-child):has(✅) {
+  background-color: #dafbe1;
+  border-left: 4px solid #1a7f37;
+  padding: 0.8rem 1rem;
+  border-radius: 0 6px 6px 0;
+}
+
+p:has(> strong:first-child):has(❌) {
+  background-color: #ffebe9;
+  border-left: 4px solid #cf222e;
+  padding: 0.8rem 1rem;
+  border-radius: 0 6px 6px 0;
+}
+
+/* Syntax highlighting para diagramas ASCII */
+pre:has(code:contains("┌")) {
+  background-color: #f0f0f0;
+  border-left: 4px solid #666;
+}
+
+/* Responsive para pantallas pequeñas */
+@media (max-width: 768px) {
+  body {
+    padding: 1rem;
+  }
+  
+  table {
+    font-size: 0.85rem;
+  }
+  
+  h1 {
+    font-size: 2rem;
+  }
+  
+  h2 {
+    font-size: 1.5rem;
+  }
+}
+
+/* Print styles */
+@media print {
+  body {
+    max-width: 100%;
+    padding: 0;
+  }
+  
+  h1, h2, h3 {
+    page-break-after: avoid;
+  }
+  
+  pre, blockquote {
+    page-break-inside: avoid;
+  }
+}

package/.vscode/settings.json

@@ -0,0 +1,33 @@
+{
+  "markdown.preview.breaks": true,
+  "markdown.preview.fontFamily": "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif",
+  "markdown.preview.fontSize": 14,
+  "markdown.preview.lineHeight": 1.6,
+  "markdown.styles": [
+    ".vscode/markdown.css"
+  ],
+  "files.associations": {
+    "*.md": "markdown"
+  },
+  "editor.wordWrap": "on",
+  "editor.quickSuggestions": {
+    "other": true,
+    "comments": false,
+    "strings": false
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  },
+  "markdown-preview-enhanced.enableTypographer": true,
+  "markdown-preview-enhanced.breakOnSingleNewLine": false,
+  "markdown-preview-enhanced.scrollSync": true,
+  "markdown-preview-enhanced.liveUpdate": true,
+  "markdown-preview-enhanced.previewTheme": "github-light.css",
+  "markdown-preview-enhanced.codeBlockTheme": "github.css",
+  "markdown.mermaid.themes": {
+    "light": "default",
+    "dark": "dark"
+  }
+}