@cristiancorreau/forge 2.1.0

package/assets/scripts/setup-codex.sh

@@ -0,0 +1,229 @@
+#!/usr/bin/env bash
+# setup-codex.sh — Inicializar soporte de Forge v2 para Codex CLI
+#
+# Uso:
+#   bash scripts/setup-codex.sh
+#
+# Qué hace:
+#   1. Verifica que git y python3 están disponibles
+#   2. Inicializa el submódulo de forge si es necesario
+#   3. Crea .codex/codex.yaml desde la plantilla (si no existe)
+#   4. Copia los scripts de hooks a .codex/
+#   5. Ejecuta generate-codex-config.py para generar AGENTS.md
+#   6. Imprime resumen de lo que se instaló
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Colores para output (solo si el terminal los soporta)
+# ---------------------------------------------------------------------------
+if [ -t 1 ] && command -v tput &>/dev/null && tput colors &>/dev/null 2>&1; then
+    GREEN="$(tput setaf 2)"
+    YELLOW="$(tput setaf 3)"
+    RED="$(tput setaf 1)"
+    RESET="$(tput sgr0)"
+else
+    GREEN=""
+    YELLOW=""
+    RED=""
+    RESET=""
+fi
+
+ok()   { printf "  %s[OK]%s   %s\n" "$GREEN" "$RESET" "$1"; }
+warn() { printf "  %s[WARN]%s %s\n" "$YELLOW" "$RESET" "$1"; }
+fail() { printf "  %s[FAIL]%s %s\n" "$RED" "$RESET" "$1"; }
+
+echo ""
+echo "forge — Setup Codex CLI adapter"
+echo "================================"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 1 — Verificar herramientas requeridas
+# ---------------------------------------------------------------------------
+echo "Verificando herramientas..."
+
+if ! command -v git &>/dev/null; then
+    fail "git no está instalado o no está en PATH"
+    echo ""
+    echo "Instalar git: https://git-scm.com/downloads"
+    exit 1
+fi
+ok "git $(git --version | awk '{print $3}')"
+
+if ! command -v python3 &>/dev/null; then
+    fail "python3 no está instalado o no está en PATH"
+    echo ""
+    echo "Instalar python3: https://www.python.org/downloads/"
+    exit 1
+fi
+ok "python3 $(python3 --version | awk '{print $2}')"
+
+if ! python3 -c "import yaml" &>/dev/null 2>&1; then
+    warn "pyyaml no está instalado — instalando..."
+    if python3 -m pip install pyyaml --quiet; then
+        ok "pyyaml instalado"
+    else
+        fail "No se pudo instalar pyyaml. Instalar manualmente: pip install pyyaml"
+        exit 1
+    fi
+else
+    ok "pyyaml disponible"
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 2 — Verificar que estamos en la raíz del repositorio con project.yaml
+# ---------------------------------------------------------------------------
+echo "Verificando proyecto..."
+
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "")"
+if [[ -z "$REPO_ROOT" ]]; then
+    fail "No se encontró repositorio git. Ejecutar desde dentro del repositorio."
+    exit 1
+fi
+
+if [[ ! -f "$REPO_ROOT/project.yaml" ]]; then
+    warn "project.yaml no encontrado en $REPO_ROOT"
+    warn "Ejecutar primero: python3 scripts/forge-wizard.py"
+    warn "Continuando de todas formas — AGENTS.md puede quedar incompleto."
+else
+    ok "project.yaml encontrado"
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 3 — Encontrar el directorio de forge
+# ---------------------------------------------------------------------------
+echo "Localizando forge..."
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FORGE_DIR="$(dirname "$SCRIPT_DIR")"
+
+if [[ ! -d "$FORGE_DIR/core" ]]; then
+    # Intentar inicializar submódulo si hay .gitmodules
+    if [[ -f "$REPO_ROOT/.gitmodules" ]] && grep -q "forge\|agentic" "$REPO_ROOT/.gitmodules" 2>/dev/null; then
+        warn "Directorio core/ no encontrado — intentando inicializar submódulo..."
+        if git -C "$REPO_ROOT" submodule update --init --recursive 2>/dev/null; then
+            ok "Submódulo inicializado"
+        else
+            fail "No se pudo inicializar el submódulo. Verificar .gitmodules."
+            exit 1
+        fi
+    else
+        fail "No se encontró el directorio core/ en $FORGE_DIR"
+        fail "Asegurarse de que forge está instalado como submódulo o en el PATH correcto."
+        exit 1
+    fi
+else
+    ok "forge encontrado en $FORGE_DIR"
+fi
+
+CODEX_ADAPTER_DIR="$FORGE_DIR/adapters/codex"
+if [[ ! -d "$CODEX_ADAPTER_DIR" ]]; then
+    fail "No se encontró $CODEX_ADAPTER_DIR"
+    exit 1
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 4 — Crear .codex/ y copiar codex.yaml desde plantilla
+# ---------------------------------------------------------------------------
+echo "Configurando .codex/..."
+
+DOTCODEX_DIR="$REPO_ROOT/.codex"
+mkdir -p "$DOTCODEX_DIR"
+ok "Directorio .codex/ listo"
+
+YAML_TPL="$CODEX_ADAPTER_DIR/hooks/codex.yaml.tpl"
+YAML_DST="$DOTCODEX_DIR/codex.yaml"
+
+if [[ -f "$YAML_DST" ]]; then
+    warn "codex.yaml ya existe — no sobreescribiendo. Revisar manualmente si hay cambios en la plantilla."
+else
+    if [[ -f "$YAML_TPL" ]]; then
+        cp "$YAML_TPL" "$YAML_DST"
+        ok "codex.yaml copiado desde plantilla"
+    else
+        fail "Plantilla no encontrada: $YAML_TPL"
+        exit 1
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Step 5 — Copiar scripts de hooks a .codex/
+# ---------------------------------------------------------------------------
+echo ""
+echo "Instalando hooks..."
+
+HOOKS_SRC="$CODEX_ADAPTER_DIR/hooks"
+
+for hook_script in forge-codex-start.sh forge-codex-finish.sh; do
+    SRC="$HOOKS_SRC/$hook_script"
+    DST="$DOTCODEX_DIR/$hook_script"
+    if [[ ! -f "$SRC" ]]; then
+        fail "Script de hook no encontrado: $SRC"
+        exit 1
+    fi
+    cp "$SRC" "$DST"
+    chmod +x "$DST"
+    ok "$hook_script instalado en .codex/"
+done
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 6 — Generar AGENTS.md
+# ---------------------------------------------------------------------------
+echo "Generando AGENTS.md..."
+
+GENERATOR="$CODEX_ADAPTER_DIR/generate-codex-config.py"
+if [[ ! -f "$GENERATOR" ]]; then
+    fail "generate-codex-config.py no encontrado en $CODEX_ADAPTER_DIR"
+    exit 1
+fi
+
+if python3 "$GENERATOR"; then
+    ok "AGENTS.md generado"
+else
+    fail "Error al generar AGENTS.md"
+    exit 1
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 7 — Diff summary
+# ---------------------------------------------------------------------------
+echo "Resumen de cambios:"
+echo ""
+
+AGENTS_MD="$REPO_ROOT/AGENTS.md"
+if git -C "$REPO_ROOT" diff --name-only HEAD -- AGENTS.md 2>/dev/null | grep -q "AGENTS.md"; then
+    LINES=$(wc -l < "$AGENTS_MD" | tr -d ' ')
+    ok "AGENTS.md actualizado ($LINES líneas)"
+elif [[ -f "$AGENTS_MD" ]]; then
+    LINES=$(wc -l < "$AGENTS_MD" | tr -d ' ')
+    ok "AGENTS.md generado ($LINES líneas) — sin cambios vs HEAD"
+fi
+
+echo ""
+echo "Archivos instalados en .codex/:"
+for f in "$DOTCODEX_DIR"/*; do
+    printf "  - .codex/%s\n" "$(basename "$f")"
+done
+
+echo ""
+echo "================================"
+ok "Setup completado. Codex CLI está listo para usar con Forge v2."
+echo ""
+echo "Próximos pasos:"
+echo "  1. Revisar .codex/codex.yaml y ajustar el modelo si es necesario."
+echo "  2. Commitear los archivos generados:"
+echo "     git add AGENTS.md .codex/"
+echo "     git commit -m 'chore(codex): initialize Forge v2 Codex adapter'"
+echo "  3. Consultar adapters/codex/commands/ para los prompt templates de cada comando."
+echo ""

package/assets/scripts/team-install.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+# team-install.sh — Automates forge setup for a new developer joining a project.
+#
+# Usage:
+#   bash .agentic/scripts/team-install.sh
+#   bash scripts/team-install.sh        (if running from repo root and forge is at .agentic/)
+#
+# What it does:
+#   1. Checks git is available
+#   2. Ensures the forge submodule is initialized
+#   3. Installs Python dependencies (pyyaml)
+#   4. Runs forge-init in non-interactive mode
+#   5. Prints next steps
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Colors
+# ---------------------------------------------------------------------------
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+info()    { echo -e "${BOLD}[forge]${RESET} $*"; }
+success() { echo -e "${GREEN}[forge]${RESET} $*"; }
+warn()    { echo -e "${YELLOW}[forge] WARNING:${RESET} $*"; }
+error()   { echo -e "${RED}[forge] ERROR:${RESET} $*" >&2; }
+
+# ---------------------------------------------------------------------------
+# 1. Check git
+# ---------------------------------------------------------------------------
+info "Checking requirements..."
+
+if ! command -v git &>/dev/null; then
+  error "git is not installed or not in PATH."
+  error "Install git from https://git-scm.com and retry."
+  exit 1
+fi
+
+if ! command -v python3 &>/dev/null; then
+  error "python3 is not installed or not in PATH."
+  error "Install Python 3.9+ from https://www.python.org/downloads/ and retry."
+  exit 1
+fi
+
+PYTHON_VERSION=$(python3 -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')
+PYTHON_MAJOR=$(echo "$PYTHON_VERSION" | cut -d. -f1)
+PYTHON_MINOR=$(echo "$PYTHON_VERSION" | cut -d. -f2)
+
+if [ "$PYTHON_MAJOR" -lt 3 ] || { [ "$PYTHON_MAJOR" -eq 3 ] && [ "$PYTHON_MINOR" -lt 9 ]; }; then
+  error "Python 3.9+ is required. Found: $PYTHON_VERSION"
+  exit 1
+fi
+
+success "git and python3 ($PYTHON_VERSION) are available."
+
+# ---------------------------------------------------------------------------
+# 2. Locate repo root
+# ---------------------------------------------------------------------------
+if ! ROOT=$(git rev-parse --show-toplevel 2>/dev/null); then
+  error "Not inside a git repository. Run this script from within the project directory."
+  exit 1
+fi
+
+info "Repository root: $ROOT"
+
+# ---------------------------------------------------------------------------
+# 3. Initialize submodule if needed
+# ---------------------------------------------------------------------------
+FORGE_PY=""
+
+for candidate in "$ROOT/.agentic" "$ROOT/forge" "$ROOT/.forge"; do
+  if [ -f "$candidate/forge.py" ]; then
+    FORGE_PY="$candidate/forge.py"
+    FORGE_DIR="$candidate"
+    break
+  fi
+done
+
+if [ -z "$FORGE_PY" ]; then
+  info "forge not found — initializing git submodules..."
+  git -C "$ROOT" submodule update --init --recursive
+
+  # Try again after submodule init
+  for candidate in "$ROOT/.agentic" "$ROOT/forge" "$ROOT/.forge"; do
+    if [ -f "$candidate/forge.py" ]; then
+      FORGE_PY="$candidate/forge.py"
+      FORGE_DIR="$candidate"
+      break
+    fi
+  done
+fi
+
+if [ -z "$FORGE_PY" ]; then
+  error "forge.py not found after submodule initialization."
+  error "Checked: .agentic/, forge/, .forge/"
+  error "Ask a team lead for the correct forge submodule path."
+  exit 1
+fi
+
+success "forge found at: $FORGE_DIR"
+
+# ---------------------------------------------------------------------------
+# 4. Install Python dependencies
+# ---------------------------------------------------------------------------
+REQUIREMENTS="$FORGE_DIR/requirements.txt"
+
+if [ -f "$REQUIREMENTS" ]; then
+  info "Installing Python dependencies..."
+  python3 -m pip install -r "$REQUIREMENTS" --quiet
+  success "Dependencies installed."
+else
+  warn "requirements.txt not found at $REQUIREMENTS — skipping pip install."
+  warn "If forge fails, run: pip3 install pyyaml"
+fi
+
+# ---------------------------------------------------------------------------
+# 5. Run forge-init (non-interactive)
+# ---------------------------------------------------------------------------
+INIT_SCRIPT="$FORGE_DIR/scripts/forge-init.py"
+
+if [ -f "$INIT_SCRIPT" ]; then
+  info "Running forge-init (non-interactive)..."
+  python3 "$INIT_SCRIPT" --tool claude-code
+else
+  warn "forge-init.py not found at $INIT_SCRIPT"
+  warn "Run the interactive CLI manually: python3 $FORGE_PY"
+  warn "Then select 'Inicializar agentes' from the menu."
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# 6. Done
+# ---------------------------------------------------------------------------
+echo ""
+success "forge is ready."
+echo ""
+echo -e "  ${BOLD}Next steps:${RESET}"
+echo -e "  1. Open Claude Code in this project directory"
+echo -e "  2. Run ${BOLD}/session-start${RESET} to begin your first session"
+echo -e "  3. The orchestrator will brief you on the current sprint"
+echo ""
+echo -e "  ${BOLD}Agents installed:${RESET} $(ls "$ROOT/.claude/agents/" 2>/dev/null | wc -l | tr -d ' ') agents in .claude/agents/"
+echo -e "  ${BOLD}Commands installed:${RESET} $(ls "$ROOT/.claude/commands/" 2>/dev/null | wc -l | tr -d ' ') commands in .claude/commands/"
+echo ""

package/assets/scripts/token-stats.py

@@ -0,0 +1,201 @@
+#!/usr/bin/env python3
+"""
+Token usage stats per agent/team — forge framework.
+
+Usage:
+  python3 scripts/token-stats.py                      # tabla en terminal
+  python3 scripts/token-stats.py --json               # JSON para embeber en progress.html
+  python3 scripts/token-stats.py --patch-html PATH    # actualiza el HTML directamente
+  python3 scripts/token-stats.py --project-dir PATH   # usar directorio de sesiones específico
+
+PROJECT_DIR se detecta automáticamente desde el directorio de trabajo actual,
+o se puede pasar explícitamente con --project-dir.
+
+Identifica agentes lanzados con el protocolo teammate-message.
+Las sesiones sin ese marcador se agrupan como "orquestador".
+"""
+import json, glob, os, re, sys
+from collections import defaultdict
+from datetime import datetime, timezone
+
+
+def detect_project_dir() -> str:
+    """Detecta el directorio de sesiones Claude Code para el proyecto actual.
+
+    Claude Code usa el path completo con cada '/' reemplazado por '-',
+    manteniendo el '-' inicial (e.g. /Users/foo/proj → -Users-foo-proj).
+    """
+    cwd = os.getcwd()
+    project_slug = cwd.replace("/", "-")   # /Users/foo → -Users-foo (mantiene el '-' inicial)
+    return os.path.expanduser(f"~/.claude/projects/{project_slug}")
+
+
+# Respetar --project-dir si se pasa, sino detectar automáticamente
+if "--project-dir" in sys.argv:
+    idx = sys.argv.index("--project-dir")
+    PROJECT_DIR = sys.argv[idx + 1] if idx + 1 < len(sys.argv) else detect_project_dir()
+else:
+    PROJECT_DIR = detect_project_dir()
+
+# NOTA: precios actualizados a 2026-05. Verificar en https://www.anthropic.com/pricing
+# si los precios cambiaron antes de confiar en estos reportes.
+_PRICING_DATE = "2026-05"
+
+# Precios por millón de tokens (USD) — actualizar si cambian
+PRICING = {
+    "claude-sonnet-4-6": {"input": 3.00,  "output": 15.00, "cache_write": 3.75,  "cache_read": 0.30},
+    "claude-opus-4-7":   {"input": 15.00, "output": 75.00, "cache_write": 18.75, "cache_read": 1.50},
+    "claude-haiku-4-5":  {"input": 0.80,  "output": 4.00,  "cache_write": 1.00,  "cache_read": 0.08},
+}
+DEFAULT_PRICE = PRICING["claude-sonnet-4-6"]
+
+
+def parse_sessions():
+    files = sorted(glob.glob(f"{PROJECT_DIR}/*.jsonl"))
+    results = []
+
+    for f in files:
+        session_id = os.path.basename(f).replace(".jsonl", "")[:8]
+        agent_name = None
+        team_name = None
+        per_model = defaultdict(lambda: {"input": 0, "output": 0, "cache_read": 0, "cache_write": 0, "msgs": 0})
+        first_msgs = 0
+
+        with open(f) as fh:
+            for line in fh:
+                try:
+                    obj = json.loads(line)
+                except Exception:
+                    continue
+
+                # Detect agent identity from first teammate-messages
+                if first_msgs < 15 and obj.get("type") == "user":
+                    content = obj.get("message", {}).get("content", "")
+                    if isinstance(content, list):
+                        for block in content:
+                            if isinstance(block, dict) and block.get("type") == "text":
+                                content = block.get("text", "")
+                                break
+                    if isinstance(content, str):
+                        m = re.search(r'Eres el teammate "([^"]+)" en el equipo "([^"]+)"', content)
+                        if m and agent_name is None:
+                            agent_name = m.group(1)
+                            team_name = m.group(2)
+                    first_msgs += 1
+
+                if obj.get("type") == "assistant":
+                    msg = obj.get("message", {})
+                    usage = msg.get("usage")
+                    model = msg.get("model", "claude-sonnet-4-6")
+                    if usage:
+                        pm = per_model[model]
+                        pm["input"]       += usage.get("input_tokens", 0)
+                        pm["output"]      += usage.get("output_tokens", 0)
+                        pm["cache_read"]  += usage.get("cache_read_input_tokens", 0)
+                        pm["cache_write"] += usage.get("cache_creation_input_tokens", 0)
+                        pm["msgs"]        += 1
+
+        total_cost = 0.0
+        totals = {"input": 0, "output": 0, "cache_read": 0, "cache_write": 0, "msgs": 0}
+        models_used = sorted(per_model.keys())
+
+        for model, v in per_model.items():
+            p = PRICING.get(model, DEFAULT_PRICE)
+            cost = (
+                v["input"]       * p["input"]       +
+                v["output"]      * p["output"]       +
+                v["cache_write"] * p["cache_write"]  +
+                v["cache_read"]  * p["cache_read"]
+            ) / 1_000_000
+            total_cost += cost
+            for k in totals:
+                totals[k] += v[k]
+
+        label = f"{agent_name} [{team_name}]" if agent_name else f"orquestador/{session_id}"
+        results.append({
+            "label":      label,
+            "session_id": session_id,
+            "agent":      agent_name,
+            "team":       team_name,
+            "models":     models_used,
+            "msgs":       totals["msgs"],
+            "input":      totals["input"],
+            "output":     totals["output"],
+            "cache_read": totals["cache_read"],
+            "cache_write":totals["cache_write"],
+            "cost_usd":   round(total_cost, 2),
+        })
+
+    results.sort(key=lambda x: x["cost_usd"], reverse=True)
+    return results
+
+
+def fmt(n):
+    return f"{n:,}"
+
+
+def main():
+    rows = parse_sessions()
+
+    grand = {"input": 0, "output": 0, "cache_read": 0, "cache_write": 0, "msgs": 0, "cost_usd": 0.0}
+    for r in rows:
+        for k in grand:
+            grand[k] += r[k]
+    grand["cost_usd"] = round(grand["cost_usd"], 2)
+
+    output = {
+        "rows": rows,
+        "totals": grand,
+        "generated_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "pricing_note": "USD estimates: Sonnet $3/$15 · Opus $15/$75 per M input/output tokens",
+    }
+
+    if "--json" in sys.argv:
+        print(json.dumps(output, indent=2))
+        return
+
+    if "--patch-html" in sys.argv:
+        idx = sys.argv.index("--patch-html")
+        html_path = sys.argv[idx + 1] if idx + 1 < len(sys.argv) else "docs/progress.html"
+        patch_html(html_path, output)
+        return
+
+    # Terminal table
+    print(f"\n{'Agente':<32} {'Modelo(s)':<22} {'Output':>9} {'CacheR':>12} {'CacheW':>10} {'Msgs':>5} {'USD est.':>9}")
+    print("─" * 105)
+    for r in rows:
+        m = ", ".join(r["models"])
+        print(f"{r['label']:<32} {m:<22} {fmt(r['output']):>9} {fmt(r['cache_read']):>12} {fmt(r['cache_write']):>10} {r['msgs']:>5,} ${r['cost_usd']:>8.2f}")
+
+    print("─" * 105)
+    print(f"{'TOTAL':<56} {fmt(grand['output']):>9} {fmt(grand['cache_read']):>12} {fmt(grand['cache_write']):>10} {grand['msgs']:>5,} ${grand['cost_usd']:>8.2f}")
+    print(f"\nGenerado: {output['generated_at']}")
+    print(f"Nota: {output['pricing_note']}")
+    print(f"Nota: precios al {_PRICING_DATE} — verificar anthropic.com/pricing si el reporte parece incorrecto.")
+
+
+def patch_html(html_path: str, data: dict) -> None:
+    """Inject fresh JSON data into the <script id="token-data"> block in the HTML file."""
+    import re as _re
+    try:
+        with open(html_path, "r") as f:
+            html = f.read()
+    except FileNotFoundError:
+        print(f"[token-stats] HTML not found: {html_path}", file=sys.stderr)
+        return
+
+    new_json = json.dumps(data, separators=(",", ":"))
+    pattern = r'(<script id="token-data" type="application/json">\n)([^\n]+)(\n</script>)'
+    new_html, n = _re.subn(pattern, lambda m: m.group(1) + new_json + m.group(3), html)
+
+    if n == 0:
+        print("[token-stats] token-data script block not found in HTML", file=sys.stderr)
+        return
+
+    with open(html_path, "w") as f:
+        f.write(new_html)
+    print(f"[token-stats] Patched {html_path} ({data['generated_at']})")
+
+
+if __name__ == "__main__":
+    main()

package/assets/templates/modes/enterprise.yaml.tpl

@@ -0,0 +1,114 @@
+# project.yaml — Modo enterprise (9+ personas)
+# Roster completo, compliance activo, fases de sprint con specs, CI habilitado.
+# Renombrar a project.yaml en la raíz del repositorio.
+#
+# CI: ejecutar forge-audit con --json para integrar en pipelines:
+#   python3 .agentic/scripts/forge-audit.py --json | jq '.summary'
+# Retorna código de salida 1 si hay errores de severidad "error" o "critical".
+
+project:
+  name: "Mi Proyecto Enterprise"
+  slug: "mi-proyecto-enterprise"
+  description: "Descripción del sistema"
+  language: "typescript"           # typescript | python | ruby | go | php | mixed
+  status: "active"
+  mode: "enterprise"               # Activa validaciones estrictas de compliance y auditoría
+
+team:
+  name: "Equipo Principal"
+  members:
+    - name: "Tech Lead"
+      role: "lead"
+      email: "lead@empresa.com"
+    - name: "Backend Senior"
+      role: "backend"
+      email: "backend@empresa.com"
+    - name: "Frontend Senior"
+      role: "frontend"
+      email: "frontend@empresa.com"
+    - name: "QA Engineer"
+      role: "qa"
+      email: "qa@empresa.com"
+    - name: "Security Engineer"
+      role: "backend"
+      email: "security@empresa.com"
+
+stack:
+  backend: null                    # "hono" | "fastapi" | "rails" | "express" | "laravel" | null
+  frontend: null                   # "nextjs" | "nuxt" | "remix" | "rails-views" | null
+  database: null                   # "postgresql" | "mysql" | "sqlite" | null
+  cache: null                      # "redis" | "memcached" | null
+  testing: ["vitest", "playwright"]
+
+agents:
+  active:
+    - orchestrator
+    - backend-engineer
+    - frontend-engineer
+    - test-engineer
+    - docs-writer
+  # Compliance y seguridad obligatorios en enterprise
+  compliance:
+    - compliance-reviewer           # GDPR, LGPD, Ley 21.719, CCPA
+    - security-auditor              # Auditoría de vulnerabilidades — obligatorio pre-merge
+  profiles: []                     # Ejemplo: [hono-drizzle, nextjs-admin]
+
+sprint:
+  current: 1
+  length_days: 14
+  phases:
+    - id: "A"
+      name: "Core"
+      specs:
+        - "docs/specs/A1-autenticacion.md"
+        - "docs/specs/A2-modelo-datos.md"
+    - id: "B"
+      name: "Features"
+      specs:
+        - "docs/specs/B1-feature-principal.md"
+        - "docs/specs/B2-integraciones.md"
+    - id: "C"
+      name: "Compliance & Security"
+      specs:
+        - "docs/specs/C1-audit-trail.md"
+        - "docs/specs/C2-dsar-flow.md"
+
+skills:
+  active:
+    - security-audit
+    - db-migrate
+    - local2prod
+    - new-feature
+  integrations: []
+
+deploy:
+  provider: null                   # "vercel" | "railway" | "fly" | "github-actions" | "custom"
+  branch: "main"
+
+# Compliance enterprise: múltiples marcos regulatorios
+# forge-audit verifica automáticamente los frameworks listados aquí.
+# Usar --json en CI: python3 .agentic/scripts/forge-audit.py --json
+compliance:
+  frameworks:
+    - gdpr                         # Unión Europea
+    - lgpd                         # Brasil
+    - ley-21719                    # Chile
+    - ccpa                         # California, EE.UU.
+  pii_handling: true               # El sistema procesa datos personales
+  audit_logs: true                 # Logs inmutables requeridos (append-only, sin UPDATE/DELETE)
+
+paths:
+  specs: "docs/specs"
+  progress: "docs/progress.html"
+  migrations: null                 # "packages/api/migrations" | "db/migrate" | null
+  tests: null                      # "tests/" | "__tests__/" | null
+
+integrations:
+  obsidian:
+    vault_path: null
+    map:
+      api: null
+      database: null
+      frontend: null
+      deploy: null
+      decisions: null