@fernando.zavaleta/ai-platform-core 0.0.7-beta

package/03-domains/03.4-product/skills/validate-story.md

@@ -0,0 +1,152 @@
+# Skill: Validate Story
+
+## Objective
+
+Evaluate whether a Jira story is well defined and ready for development using standardized story quality principles.
+
+All outputs must be generated in SPANISH.
+
+---
+
+# Input
+
+The Jira ticket must be retrieved via the MCP bridge:
+
+02-mcp/02.1-jira/bridge.md
+
+The response from Jira is a JSON object.
+
+This JSON may be used by the agent for reasoning, but **must NOT be stored in the output directory**.
+
+---
+
+# Output Policy
+
+The output directory must only contain final documentation artifacts.
+
+The agent MUST NOT store intermediate JSON files in:
+
+05-output/
+
+Only Markdown files are allowed as final artifacts.
+
+---
+
+# Knowledge Source
+
+Apply the story quality framework defined in:
+
+03-domains/03.4-product/knowledge/story-quality.md
+
+---
+
+# Validation Dimensions
+
+The story must be evaluated across the following dimensions.
+
+## Problem Clarity
+
+Determine if the story clearly explains the problem or functionality requested.
+
+Indicators:
+
+- Clear description
+- Understandable goal
+- Context provided
+
+---
+
+## Business Value
+
+Evaluate whether the story explains the benefit for the user or the business.
+
+Indicators:
+
+- Business impact described
+- User value identified
+- Stakeholder relevance
+
+---
+
+## Acceptance Criteria
+
+Verify that acceptance criteria exist.
+
+Preferred format:
+
+Given  
+When  
+Then
+
+If acceptance criteria are missing, mark as FAIL.
+
+---
+
+## Testability
+
+Determine if QA can design test cases based on the ticket description.
+
+Indicators:
+
+- Measurable behavior
+- Clear expected outcomes
+
+---
+
+## Dependencies
+
+Evaluate whether the ticket identifies dependencies or related work.
+
+Indicators:
+
+- Linked tickets
+- System dependencies
+- Integration references
+
+---
+
+# Scoring
+
+Each validation dimension must be classified as:
+
+PASS  
+PARTIAL  
+FAIL
+
+---
+
+# Readiness Decision
+
+READY
+
+All validation dimensions PASS.
+
+PARTIALLY READY
+
+Some PARTIAL but no FAIL.
+
+NOT READY
+
+At least one FAIL.
+
+Development must not start.
+
+---
+
+# Output
+
+Generate the validation report in:
+
+05-output/agent-product/[JIRA_ID]/
+
+File name:
+
+[JIRA_ID].story-validation.md
+
+---
+
+# Output Format
+
+Use the template defined in:
+
+03-domains/03.4-product/templates/story-quality-template.md

package/03-domains/03.4-product/templates/story-quality-template.md

@@ -0,0 +1,67 @@
+# Story Validation Report
+
+Ticket: [JIRA_ID]
+
+---
+
+## Problem Clarity
+
+Status:
+
+PASS / PARTIAL / FAIL
+
+Analysis:
+
+---
+
+## Business Value
+
+Status:
+
+PASS / PARTIAL / FAIL
+
+Analysis:
+
+---
+
+## Acceptance Criteria
+
+Status:
+
+PASS / PARTIAL / FAIL
+
+Analysis:
+
+---
+
+## Testability
+
+Status:
+
+PASS / PARTIAL / FAIL
+
+Analysis:
+
+---
+
+## Dependencies
+
+Status:
+
+PASS / PARTIAL / FAIL
+
+Analysis:
+
+---
+
+# Final Decision
+
+READY  
+PARTIALLY READY  
+NOT READY
+
+---
+
+# Recommendations
+
+Suggestions to improve the story definition.

package/README.md

@@ -0,0 +1,52 @@
+# AI Platform Engineering
+
+AI Platform Engineering is the core engineering framework used to design, build and operate enterprise AI platforms, copilots and intelligent services.
+
+This repository defines the architecture, standards, engineering practices and reusable capabilities required to develop scalable AI-powered systems across the organization.
+
+It serves as the foundation for:
+
+- AI copilots for engineering, support and operations
+- intelligent automation systems
+- incident analysis and root cause analysis agents
+- knowledge-driven AI assistants
+- internal AI development standards
+
+The goal of this platform is to provide a structured approach for building reliable, secure and production-ready AI systems.
+
+## Scope
+
+This repository includes:
+
+- AI platform architecture
+- engineering principles and standards
+- reusable AI skills
+- agent patterns
+- prompt engineering guidelines
+- context management strategies
+- examples and reference implementations
+
+## Target users
+
+- AI engineers
+- platform engineers
+- backend engineers
+- DevOps / SRE
+- internal AI product teams
+
+# AI Platform Engineering - Installation
+
+Para activar la inteligencia en tu editor **Cursor**, sigue estos pasos:
+
+### 1. Requisitos
+- Node.js instalado.
+- Abrir este proyecto en **Visual Studio Code** (Desarrollo) o **Cursor** (Uso).
+
+### 2. Instalación por Perfil
+Si eres un QA Engineer, ejecuta:
+```bash
+npm run install:qa  
+
+
+### Deploy TAG 
+ai-platform-engineering@v0.0.1

package/bin/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const profileKey = process.argv[2];
+const PACKAGE_ROOT = path.join(__dirname, '..');
+const TARGET_DIR = path.join(process.cwd(), '.cursor', 'skills');
+
+const profiles = {
+    "qa": "03.1-qa",
+    "l3": "03.3-l3",
+    "product": "03.4-product"
+};
+
+const domainFolder = profiles[profileKey];
+if (!domainFolder) {
+    console.error("❌ Perfil no válido. Usa: qa, l3 o product");
+    process.exit(1);
+}
+
+const domainPath = path.join(PACKAGE_ROOT, '03-domains', domainFolder);
+const config = JSON.parse(fs.readFileSync(path.join(domainPath, 'profile.json'), 'utf8'));
+
+if (!fs.existsSync(TARGET_DIR)) fs.mkdirSync(TARGET_DIR, { recursive: true });
+
+console.log(`🚀 Instalando inteligencia para ${profileKey}...`);
+
+// Escaneo automático de carpetas
+config.include_dirs.forEach(dirName => {
+    const sourceDir = path.join(domainPath, dirName);
+    
+    if (fs.existsSync(sourceDir)) {
+        const files = fs.readdirSync(sourceDir);
+        files.forEach(file => {
+            // Solo copiamos archivos (evitamos subcarpetas por ahora)
+            const srcFile = path.join(sourceDir, file);
+            if (fs.lstatSync(srcFile).isFile()) {
+                fs.copyFileSync(srcFile, path.join(TARGET_DIR, file));
+                console.log(`   ✅ [${dirName}] ${file} proyectado.`);
+            }
+        });
+    }
+});
+
+console.log(`\n✨ Perfil ${profileKey} actualizado correctamente.`);

package/bin/ia_install.py

@@ -0,0 +1,38 @@
+import os, sys, shutil, json
+from pathlib import Path
+
+def install_profile(profile_key):
+    package_root = Path(__file__).parent.parent
+    target_dir = Path(os.getcwd()) / ".cursor" / "skills"
+    
+    profiles = {"qa": "03.1-qa", "l3": "03.3-l3", "product": "03.4-product"}
+    domain_folder = profiles.get(profile_key)
+    
+    if not domain_folder:
+        print(f"❌ Perfil {profile_key} no válido")
+        return
+
+    domain_path = package_root / "03-domains" / domain_folder
+    profile_json = domain_path / "profile.json"
+    
+    with open(profile_json) as f:
+        config = json.load(f)
+
+    target_dir.mkdir(parents=True, exist_ok=True)
+
+    print(f"🚀 Sincronizando carpetas para {profile_key}...")
+
+    # Escaneo automático de archivos en las carpetas configuradas
+    for dir_name in config.get("include_dirs", []):
+        source_dir = domain_path / dir_name
+        if source_dir.exists():
+            for item in source_dir.iterdir():
+                if item.is_file():
+                    shutil.copy2(item, target_dir / item.name)
+                    print(f"   ✅ [{dir_name}] {item.name} copiado.")
+
+    print(f"\n✨ ¡Instalación modular completa!")
+
+def main():
+    if len(sys.argv) > 1:
+        install_profile(sys.argv[1])

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@fernando.zavaleta/ai-platform-core",
+  "version": "0.0.7-beta",
+  "description": "Enterprise AI Framework Distribution Tool",
+  "main": "index.js",
+  "bin": {
+    "ia-install": "./bin/cli.js"
+  },
+  "files": [
+    "03-domains",
+    "02-mcp",
+    "00-config/global-base.md",
+    "bin"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}