# 1. Clonar el repo (una vez)
git clone https://github.com/deibanez/agentic-ecos.git
cd agentic-ecos

# 2. Instalar dependencias + el CLI
uv add --dev mcp
uv pip install --editable .     # instala el comando `agentic-ecos` (CLI)

# 3. Verificar que funciona
agentic-ecos protocols           # lista las plantillas de protocolos

# 4. Conectar el MCP server a tu agente (una vez por workspace)
#    → escribe opencode.jsonc / .mcp.json / .cursor/mcp.json automáticamente
agentic-ecos connect --target ~/repos --agent auto

# Desde tu agente (con el MCP conectado):
#   init_project("mi-proyecto", preset="monorepo", target_path=".../docs")
#   list_patterns()          → los 15 patrones agénticos
#   validate_structure("...") → verifica cobertura agéntica de un proyecto
#   protocol_template("agent_protocol") → plantilla de protocolo

# 0. Crear el fork privado + branch de ecosistema (una vez)
gh repo fork deibanez/agentic-ecos --clone --private
cd agentic-ecos
git remote add upstream https://github.com/deibanez/agentic-ecos.git
agentic-ecos ecosystem branch-create mi-eco --base main
#   base=main (estable, recomendado) | base=dev (bleeding edge)

# 1. Inicializar el plano de control (una vez por ecosistema)
agentic-ecos ecosystem init --name mi-ecosistema --workspace ~/repos

# 2. Conectar el MCP server al workspace (multi-agente)
agentic-ecos connect --target ~/repos --agent auto

# 3. Desde el agente: generar infra agéntica para un proyecto
#    → init_project("mi-proyecto", preset="monorepo", target_path=".../docs")

# Mantenerse al día (trazable, registra en AGENT_SESSION_LOG)
agentic-ecos ecosystem sync --branch main
agentic-ecos ecosystem merge-main --target ecosystem/mi-eco

"mcp": {
  "agentic-ecos": {
    "type": "local",
    "command": ["/abs/path/to/agentic-ecos/.venv/bin/agentic-ecos-server"]
  }
}

agentic-ecos connect --target ~/repos --agent auto   # detecta agentes presentes
agentic-ecos connect --agent claude                  # solo Claude Code
agentic-ecos connect --agent snippet                 # snippets para pegar manual

# Generar un proyecto nuevo
agentic-ecos init mi-proyecto --preset monorepo --repos api,frontend,workers

# Validar estructura existente
agentic-ecos validate ./ruta/al/vault

# Plano de control
agentic-ecos ecosystem init --name eco --workspace ~/repos
agentic-ecos ecosystem status
agentic-ecos ecosystem add otro-svc --type frontend
agentic-ecos ecosystem tasks
agentic-ecos ecosystem add-task "Migrar satet" --priority high --type iac

# Branches git del ecosistema (trazables)
agentic-ecos ecosystem branch-create mi-eco --base main    # main estable | dev bleeding edge
agentic-ecos ecosystem sync --branch main                  # sync con upstream
agentic-ecos ecosystem merge-main --target ecosystem/mi-eco

# Conectar MCP (multi-agente)
agentic-ecos connect --target ~/repos --agent auto
agentic-ecos connect --agent claude

# Conocimiento
agentic-ecos promote mi-pattern --to workspace
agentic-ecos promote mi-pattern --to knowledge --source workspace
agentic-ecos knowledge status                 # estado por tier

# Salida JSON para scripts/CI (automatización)
agentic-ecos ecosystem status --json
agentic-ecos ecosystem tasks --json
agentic-ecos validate ./ruta --json
agentic-ecos knowledge status --json

# Verificar conexión LLM (optativo)
agentic-ecos llm-test --prompt "Hola"

# Listar patrones / protocolos
agentic-ecos patterns --domain coordination
agentic-ecos protocols

pip install 'agentic-ecos[rag]'

# MCP:
#   add_custom_pattern(...)      → data/ (tier 3)
#   promote_to_workspace(...)    → workspace/ (tier 2.5)
#   promote_to_knowledge(...)    → knowledge/ (tier 2)
#   knowledge_status()           → estado por tier

agentic_ecos/
├── server.py        # MCP server (31 tools)
├── generator.py     # init_project + generate_file + validate + CLI
├── patterns.py      # 15 patrones agénticos codificados (tier 1)
├── protocols.py     # plantillas de protocolos (5)
├── presets.py       # monorepo / single_service / data_pipeline (tier 1)
├── ecosystem.py     # plano de control (agentic.toml, connect, tasks)
├── storage.py       # data/ + knowledge/ + workspace/ carga/guardado
├── knowledge.py     # promoción entre tiers
├── knowledge/       # tier 2 · commiteado · comunidad (patterns/presets/traps)
├── data/            # tier 3 · patterns/presets commiteados (fork privado) · snapshots/state gitignored
├── static/          # scripts copiados tal cual (lock_manager, sync_kanban, ...)
└── templates/       # plantillas markdown generables

workspace/           # tier 2.5 · solo en branches de ecosistema (fork privado) · agentic.toml + tasks.md
docs/00_Global/      # vault autodocumental (Obsidian)