@qubiit/lmagent 2.5.0

package/templates/plan.yaml

@@ -0,0 +1,320 @@
+# Plan Template (SPEC DRIVEN Development)
+# LMAgent Framework v3.0 - SPEC+LM Methodology
+#
+# This template creates an implementation plan from a spec.yaml.
+# It defines HOW to build what the spec defined (WHAT).
+# Use with `/arch` persona.
+#
+# Usage:
+#   1. Requires: specs/[feature-name]/spec.yaml (approved)
+#   2. Copy to: specs/[feature-name]/plan.yaml
+#   3. Get approval before proceeding to tasks.yaml
+
+---
+metadata:
+  title: "Implementation Plan: [Feature Name]"
+  spec_reference: "specs/[feature-name]/spec.yaml"
+  spec_version: "1.0"
+  plan_version: "1.0"
+  author: "[Architect Name or Agent ID]"
+  created: "[YYYY-MM-DD]"
+  status: draft  # draft | review | approved
+
+# ============================================
+# ARCHITECTURE DECISIONS
+# ============================================
+
+architecture:
+  # High-level approach
+  approach: "[Describe the technical approach]"
+  
+  # Architecture style
+  style: microservices  # monolith | microservices | serverless | hybrid
+  
+  # Key patterns used
+  patterns:
+    - name: "Repository Pattern"
+      rationale: "[Why using this pattern]"
+    - name: "Event-Driven"
+      rationale: "[Why using this pattern]"
+  
+  # ADRs (Architecture Decision Records)
+  decisions:
+    - id: "ADR-001"
+      title: "[Decision title]"
+      status: proposed  # proposed | accepted | deprecated
+      context: "[Why this decision is needed]"
+      decision: "[What was decided]"
+      consequences:
+        positive:
+          - "[Benefit 1]"
+        negative:
+          - "[Trade-off 1]"
+        risks:
+          - "[Risk to monitor]"
+
+# ============================================
+# SYSTEM DESIGN
+# ============================================
+
+components:
+  - name: "[Component Name]"
+    type: service  # service | database | queue | cache | external
+    responsibility: "[What this component does]"
+    technology: "[Tech stack]"
+    owner_persona: "/dev"  # Which LMAgent persona owns this
+    
+  - name: "[Database Name]"
+    type: database
+    responsibility: "[Data it stores]"
+    technology: "PostgreSQL 16"
+    schemas:
+      - name: "[table_name]"
+        description: "[Purpose]"
+
+# Data flow
+data_flow:
+  - from: "[Component A]"
+    to: "[Component B]"
+    method: REST  # REST | gRPC | event | queue
+    data: "[What data flows]"
+
+# Diagram (Mermaid format for rendering)
+diagram: |
+  graph TB
+      subgraph "Frontend"
+          A[Web App]
+      end
+      
+      subgraph "Backend"
+          B[API Service]
+          C[Worker]
+      end
+      
+      subgraph "Data"
+          D[(PostgreSQL)]
+          E[(Redis)]
+      end
+      
+      A -->|REST| B
+      B -->|Queue| C
+      B --> D
+      B --> E
+      C --> D
+
+# ============================================
+# IMPLEMENTATION PHASES
+# ============================================
+
+phases:
+  - phase: 1
+    name: "Foundation & Setup"
+    description: "[What this phase establishes]"
+    estimated_time: "4h"
+    personas: ["/dev"]
+    deliverables:
+      - "Project structure created"
+      - "Database schema migrated"
+      - "Base configurations set"
+    validation:
+      - "All services start without errors"
+      - "Database migrations run successfully"
+    blocks: [2, 3]  # Which phases this blocks
+    
+  - phase: 2
+    name: "Core Logic"
+    description: "[Main business logic implementation]"
+    estimated_time: "8h"
+    personas: ["/dev"]
+    deliverables:
+      - "Service layer implemented"
+      - "Unit tests passing (>80%)"
+    validation:
+      - "All unit tests pass"
+      - "Coverage >80%"
+    depends_on: [1]
+    blocks: [3, 4]
+    
+  - phase: 3
+    name: "API Layer"
+    description: "[REST/GraphQL endpoints]"
+    estimated_time: "4h"
+    personas: ["/dev"]
+    deliverables:
+      - "Endpoints implemented"
+      - "OpenAPI docs generated"
+      - "Integration tests passing"
+    validation:
+      - "All endpoints respond correctly"
+      - "Swagger/OpenAPI available"
+    depends_on: [2]
+    
+  - phase: 4
+    name: "Integration & Polish"
+    description: "[Connect everything, polish]"
+    estimated_time: "4h"
+    personas: ["/dev", "/qa"]
+    deliverables:
+      - "E2E tests passing"
+      - "Performance benchmarks met"
+    validation:
+      - "All acceptance criteria met"
+      - "No critical bugs"
+    depends_on: [2, 3]
+
+# ============================================
+# DEPENDENCIES MAP
+# ============================================
+
+dependencies:
+  # User story execution order
+  user_story_order:
+    - story_id: "US-001"
+      depends_on: []
+      blocks: ["US-002"]
+    - story_id: "US-002"
+      depends_on: ["US-001"]
+      blocks: []
+  
+  # Phase dependencies (critical path)
+  critical_path:
+    - phase: 1
+      slack: 0
+    - phase: 2
+      slack: 0
+    - phase: 3
+      slack: "2h"
+
+# ============================================
+# PARALLEL EXECUTION
+# ============================================
+
+parallel_execution:
+  enabled: true
+  groups:
+    - phase: 3
+      parallel_tasks:
+        group_a:
+          tasks: ["API endpoints", "Auth middleware"]
+          rationale: "Independent concerns"
+        group_b:
+          tasks: ["Tests", "Docs"]
+          rationale: "Can run alongside implementation"
+    
+    - phase: 4
+      parallel_tasks:
+        group_a:
+          tasks: ["E2E tests", "Performance tests"]
+          rationale: "Different test types"
+
+# ============================================
+# SECURITY CONSIDERATIONS
+# ============================================
+
+security:
+  authentication:
+    method: "[JWT | Session | OAuth2]"
+    provider: "[Service/library]"
+    
+  authorization:
+    model: "[RBAC | ABAC | ACL]"
+    roles: ["admin", "user", "guest"]
+    
+  data_protection:
+    encryption_at_rest: true
+    encryption_in_transit: true
+    pii_handling: "[How PII is protected]"
+    
+  vulnerabilities_addressed:
+    - "[OWASP Top 10 consideration 1]"
+    - "[OWASP Top 10 consideration 2]"
+
+# ============================================
+# OBSERVABILITY
+# ============================================
+
+observability:
+  logging:
+    level: INFO
+    format: json
+    sensitive_fields_masked: ["password", "token", "ssn"]
+    
+  metrics:
+    - name: "request_duration"
+      type: histogram
+      labels: ["endpoint", "status"]
+    - name: "active_users"
+      type: gauge
+      
+  alerts:
+    - name: "High Error Rate"
+      condition: "error_rate > 5%"
+      severity: critical
+      notify: ["#alerts-channel"]
+
+# ============================================
+# ROLLBACK PLAN
+# ============================================
+
+rollback:
+  triggers:
+    - "Error rate > 10%"
+    - "P95 latency > 2s"
+    - "Data corruption detected"
+    - "Critical security issue"
+    
+  steps:
+    - step: 1
+      action: "Halt deployment"
+      command: "[deployment pause command]"
+    - step: 2
+      action: "Revert to previous version"
+      command: "[rollback command]"
+    - step: 3
+      action: "Verify rollback"
+      validation: "[Health check]"
+    - step: 4
+      action: "Notify stakeholders"
+      template: "[Communication template]"
+  
+  data_rollback:
+    strategy: "[backup restore | reverse migration | manual]"
+    max_data_loss: "[RPO: X minutes]"
+
+# ============================================
+# RESOURCE ESTIMATES
+# ============================================
+
+resources:
+  team:
+    - role: "Backend Engineer"
+      allocation: "100%"
+      duration: "[X days]"
+    - role: "QA Engineer"
+      allocation: "50%"
+      duration: "[X days]"
+  
+  infrastructure:
+    - resource: "[Cloud resource]"
+      estimated_cost: "$X/month"
+    
+  total_estimated_effort: "[X person-days]"
+  total_estimated_cost: "$[X]"
+
+# ============================================
+# VALIDATION CHECKLIST
+# ============================================
+
+validation:
+  pre_implementation:
+    - "[ ] Spec approved"
+    - "[ ] Architecture reviewed"
+    - "[ ] Security reviewed"
+    - "[ ] Resources allocated"
+    
+  post_implementation:
+    - "[ ] All acceptance criteria met"
+    - "[ ] Tests passing (>80% coverage)"
+    - "[ ] Documentation updated"
+    - "[ ] Security scan passed"
+    - "[ ] Performance benchmarks met"

package/templates/session.yaml

@@ -0,0 +1,125 @@
+# Session State Template
+# LMAgent Framework v3.0 - Persistent Context System
+#
+# Este archivo mantiene el estado del proyecto para que el agente NUNCA
+# pierda el contexto, incluso en proyectos grandes con múltiples sesiones.
+#
+# UBICACIÓN: .lmagent/session.yaml (en el proyecto del usuario)
+#
+# 🤖 AGENTE: Lee este archivo AL INICIO de cada sesión de trabajo.
+#           Actualízalo DESPUÉS de cada milestone completado.
+
+---
+# ═══════════════════════════════════════════════════════════════════════════
+#                         ESTADO DEL PROYECTO
+# ═══════════════════════════════════════════════════════════════════════════
+
+project:
+  name: "[nombre del proyecto]"
+  created_at: "[YYYY-MM-DD]"
+  last_updated: "[YYYY-MM-DD HH:MM]"
+  current_phase: specify  # specify | plan | tasks | implement | verify | done
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                         PROGRESO DEL SPEC WORKFLOW
+# ═══════════════════════════════════════════════════════════════════════════
+
+spec_workflow:
+  phase_1_specify:
+    status: pending  # pending | in_progress | review | approved | completed
+    artifact: null  # specs/[project]/spec.yaml
+    approved_at: null
+    approved_by: null
+    
+  phase_2_plan:
+    status: pending
+    artifact: null  # specs/[project]/plan.yaml
+    approved_at: null
+    approved_by: null
+    
+  phase_3_tasks:
+    status: pending
+    artifact: null  # specs/[project]/tasks.yaml
+    
+  phase_4_implement:
+    status: pending
+    current_task_id: null  # T001, T002, etc.
+    completed_tasks: []
+    blocked_tasks: []
+    
+  phase_5_verify:
+    status: pending
+    tests_passing: null
+    coverage: null
+    issues_found: []
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                         CONTEXTO ACTUAL
+# ═══════════════════════════════════════════════════════════════════════════
+
+current_context:
+  # ¿Qué estaba haciendo el agente?
+  last_action: "[Descripción de la última acción]"
+  
+  # ¿En qué archivo estaba trabajando?
+  last_file: null
+  
+  # ¿Qué persona estaba activa?
+  active_persona: null  # /pm, /arch, /dev, /qa, etc.
+  
+  # ¿Hay algo pendiente de aprobación del usuario?
+  awaiting_user_input: false
+  pending_question: null
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                         HISTORIAL DE SESIONES
+# ═══════════════════════════════════════════════════════════════════════════
+
+sessions:
+  - session_id: 1
+    started_at: "[timestamp]"
+    ended_at: "[timestamp]"
+    summary: "[Qué se logró en esta sesión]"
+    next_steps: "[Qué falta hacer]"
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                         DECISIONES IMPORTANTES
+# ═══════════════════════════════════════════════════════════════════════════
+
+decisions:
+  - id: "D001"
+    date: "[YYYY-MM-DD]"
+    decision: "[Qué se decidió]"
+    rationale: "[Por qué]"
+    # Esto ayuda al agente a recordar decisiones pasadas
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                         BLOQUEOS Y ISSUES
+# ═══════════════════════════════════════════════════════════════════════════
+
+blockers:
+  - id: "B001"
+    description: "[Descripción del bloqueo]"
+    status: open  # open | resolved
+    created_at: null
+    resolved_at: null
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                    INSTRUCCIONES PARA EL AGENTE
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# 🤖 AGENTE: AL INICIO DE CADA SESIÓN:
+#
+# 1. Lee este archivo completo
+# 2. Identifica current_phase y current_context
+# 3. Resume desde donde quedaste
+# 4. Si awaiting_user_input es true, pregunta al usuario primero
+#
+# 🤖 AGENTE: AL FINALIZAR TRABAJO O CAMBIAR DE TAREA:
+#
+# 1. Actualiza current_context con tu última acción
+# 2. Actualiza el status de la fase actual
+# 3. Si completaste una task, agrégala a completed_tasks
+# 4. Guarda este archivo
+#
+# ═══════════════════════════════════════════════════════════════════════════

package/templates/spec.yaml

@@ -0,0 +1,229 @@
+# Spec Template (SPEC DRIVEN Development)
+# LMAgent Framework v3.0 - SPEC+LM Methodology
+#
+# This template creates a structured specification that serves as the
+# source of truth for feature development. Use with `/pm` persona.
+#
+# Usage:
+#   1. Copy to: specs/[feature-name]/spec.yaml
+#   2. Fill in all [bracketed] sections
+#   3. Get approval before proceeding to plan.yaml
+
+---
+metadata:
+  title: "[Feature Name]"
+  version: "1.0"
+  author: "[PM Name or Agent ID]"
+  created: "[YYYY-MM-DD]"
+  updated: "[YYYY-MM-DD]"
+  status: draft  # draft | review | approved | superseded
+  tags:
+    - "[category]"
+    - "[priority]"
+
+# ============================================
+# PROBLEM DEFINITION
+# ============================================
+
+problem_statement:
+  # One clear sentence describing the problem
+  description: "[What problem are we solving?]"
+  
+  # Who experiences this problem?
+  affected_users:
+    - type: "[User type 1]"
+      pain_level: high  # high | medium | low
+    - type: "[User type 2]"
+      pain_level: medium
+  
+  # How significant is this problem?
+  impact:
+    business: "[Revenue impact, efficiency, etc.]"
+    users: "[User experience impact]"
+    technical: "[Technical debt, scalability, etc.]"
+  
+  # Evidence that this problem exists
+  evidence:
+    - type: data
+      source: "[Analytics, metrics]"
+      finding: "[What the data shows]"
+    - type: feedback
+      source: "[Support tickets, interviews]"
+      finding: "[What users say]"
+    - type: observation
+      source: "[Competitive analysis, market research]"
+      finding: "[External validation]"
+
+# ============================================
+# SOLUTION DEFINITION
+# ============================================
+
+solution:
+  overview: "[High-level description of the proposed solution]"
+  
+  approach: "[Technical/product approach - 2-3 sentences]"
+  
+  # What IS included
+  in_scope:
+    - feature: "[Feature 1]"
+      priority: must_have  # must_have | should_have | could_have
+    - feature: "[Feature 2]"
+      priority: must_have
+    - feature: "[Feature 3]"
+      priority: should_have
+  
+  # What is NOT included (explicit anti-scope)
+  out_of_scope:
+    - "[Anti-feature 1 - Why excluded]"
+    - "[Anti-feature 2 - Future consideration]"
+  
+  # Key decisions already made
+  decisions:
+    - decision: "[Decision 1]"
+      rationale: "[Why this choice]"
+      alternatives_considered:
+        - "[Alternative A - rejected because...]"
+        - "[Alternative B - rejected because...]"
+
+# ============================================
+# USER STORIES
+# ============================================
+
+user_stories:
+  - id: "US-001"
+    title: "[Short descriptive title]"
+    as_a: "[user type]"
+    i_want: "[action/capability]"
+    so_that: "[benefit/value]"
+    priority: 1  # 1 = highest
+    story_points: 3  # 1, 2, 3, 5, 8, 13
+    acceptance_criteria:
+      - "Given [context], when [action], then [result]"
+      - "Given [context], when [action], then [result]"
+    notes: "[Additional context]"
+    
+  - id: "US-002"
+    title: "[Short descriptive title]"
+    as_a: "[user type]"
+    i_want: "[action/capability]"
+    so_that: "[benefit/value]"
+    priority: 2
+    story_points: 5
+    acceptance_criteria:
+      - "Given [context], when [action], then [result]"
+    dependencies:
+      - "US-001"
+
+# ============================================
+# SUCCESS METRICS
+# ============================================
+
+success_metrics:
+  # Primary success metric (North Star)
+  primary:
+    metric: "[KPI name]"
+    baseline: "[current value]"
+    target: "[goal value]"
+    timeline: "[when to measure]"
+    measurement_method: "[How to measure]"
+  
+  # Secondary metrics
+  secondary:
+    - metric: "[KPI name]"
+      baseline: "[current value]"
+      target: "[goal value]"
+      timeline: "[when]"
+    - metric: "[KPI name]"
+      baseline: "[current value]"
+      target: "[goal value]"
+      timeline: "[when]"
+  
+  # Guardrail metrics (should NOT get worse)
+  guardrails:
+    - metric: "[Metric to protect]"
+      current: "[value]"
+      acceptable_variance: "[+/- X%]"
+
+# ============================================
+# CONSTRAINTS & DEPENDENCIES
+# ============================================
+
+constraints:
+  technical:
+    - "[Must use existing auth system]"
+    - "[Must work on PostgreSQL 16+]"
+  business:
+    - "[Must launch before Q2]"
+    - "[Budget: $X]"
+  compliance:
+    - "[GDPR requirements]"
+    - "[Security standards]"
+  resources:
+    - "[Available team capacity]"
+    - "[External dependencies]"
+
+dependencies:
+  internal:
+    - system: "[System name]"
+      type: blocking  # blocking | optional
+      status: available  # available | in_progress | blocked
+  external:
+    - service: "[Third-party service]"
+      type: integration
+      owner: "[Team/vendor]"
+
+# ============================================
+# RISKS
+# ============================================
+
+risks:
+  - id: "R-001"
+    description: "[Risk description]"
+    probability: high  # high | medium | low
+    impact: high  # high | medium | low
+    mitigation: "[How to mitigate]"
+    owner: "[Who owns this risk]"
+    
+  - id: "R-002"
+    description: "[Risk description]"
+    probability: medium
+    impact: medium
+    mitigation: "[How to mitigate]"
+    contingency: "[Plan B if risk materializes]"
+
+# ============================================
+# TIMELINE
+# ============================================
+
+timeline:
+  estimated_total: "[X days/weeks]"
+  phases:
+    - phase: "Planning"
+      duration: "[X days]"
+      milestone: "Plan approved"
+    - phase: "Implementation"
+      duration: "[X days]"
+      milestone: "Feature complete"
+    - phase: "Testing"
+      duration: "[X days]"
+      milestone: "QA sign-off"
+    - phase: "Rollout"
+      duration: "[X days]"
+      milestone: "100% deployed"
+
+# ============================================
+# APPROVALS
+# ============================================
+
+approvals:
+  required:
+    - role: "[Product Manager]"
+      status: pending  # pending | approved | rejected
+      date: null
+    - role: "[Tech Lead]"
+      status: pending
+      date: null
+  optional:
+    - role: "[Security]"
+      status: pending
+      condition: "If auth changes"