Documentación

🏗️
Nuevo · Referencia
Arquitecturas de Referencia
10 arquitecturas reales donde architect encaja en sistemas de producción. Diagramas, configs YAML y código listo para CI/CD, Security, AIOps, MLOps y DevOps.
10 arquitecturas 7 dominios 30+ diagramas
→

Introducción

Índice de la documentación técnica del proyecto Architect v1.0.0.

Guía Rápida

Instalación, configuración mínima, comandos más útiles y referencia de flags.

Uso del CLI

Guía práctica de uso: flags, logging, configs, CI/CD, scripts, agentes custom.

Arquitectura

Visión general, diagrama de componentes y flujo completo de ejecución.

Core Loop

El AgentLoop: safety nets, StopReason, graceful close, hooks lifecycle.

Tools y Ejecución

Sistema de tools: filesystem, edición, búsqueda, MCP, ExecutionEngine.

Agentes y Modos

Sistema de agentes, registry, modos de ejecución, skills y memoria.

Referencia de Configuración

Schema completo de configuración, precedencia y variables de entorno.

Guía para IA

Invariantes críticos, patrones, dónde añadir cosas, trampas.

Modelos de Datos

Todos los modelos de datos: Pydantic, dataclasses y jerarquía de errores.

Sistema de Logging

3 pipelines, nivel HUMAN, iconos, HumanFormatter, structlog.

Testing

Mapa de tests: ~817+ tests en 30+ archivos, cobertura por módulo.

Modelo de Seguridad

19+ capas defensivas, modelo de amenazas, path traversal, command security, hardening.

Crear un MCP Server

Servidor MCP que exponga architect como herramienta remota (server.py + tools.py).

Contenedores

Containerfiles, Kubernetes Deployments, Docker, configuración para CI/CD.

Buenas Prácticas

Prompts, agentes, edición, costes, hooks lifecycle, guardrails, skills, memoria, CI/CD.

Sessions

Persistencia y resume de sesiones: guardar, listar, reanudar y limpiar entre ejecuciones.

Reports

Reportes de ejecución en JSON, Markdown y GitHub PR comment para CI/CD.

Dry Run

Simulación de ejecución: DryRunTracker, WRITE_TOOLS/READ_TOOLS, plan de acciones.

Ralph Loop

Iteración automática con checks: RalphConfig, RalphLoop, contexto limpio, worktrees.

Pipelines

Workflows YAML multi-step: variables, condiciones, output_var, checkpoints, dry-run.

Ejecución Paralela

Múltiples agentes en worktrees: ParallelRunner, workers, round-robin de modelos.

Checkpoints

Puntos de restauración git: CheckpointManager, rollback, integración con pipelines.

Auto-Review

Revisión post-build con contexto limpio: AutoReviewer, ReviewResult, fix-pass.

Sub-Agentes

Delegación de sub-tareas (explore/test/review) con contexto aislado y tools limitadas.

Code Health Delta

Análisis de métricas de calidad antes/después: complejidad, duplicados, funciones largas.

Evaluación Competitiva

Comparación multi-modelo con ranking por calidad, eficiencia y coste.

OpenTelemetry Traces

Spans de sesión, LLM y tools: exporters OTLP, console, JSON file.

Presets

Inicialización de proyectos con configuraciones predefinidas (python, node-react, ci, paranoid, yolo).

Extensibilidad

Crear tools custom, agentes, hooks lifecycle, skills, guardrails — con ejemplos.

Prompt Engineering

Escribir prompts efectivos, .architect.md, skills, anti-patrones, recetas.

Integración CI/CD

Recetas para GitHub Actions, GitLab CI, Jenkins: review bots, auto-fix, pipelines.

Gestión de Costes

CostTracker, precios por modelo, budgets, prompt caching, cache local, optimización.

Troubleshooting

Diagnóstico por síntomas: errores LLM, loops, tools, hooks, guardrails, exit codes.

No se encontraron resultados.