diff --git a/README.en.md b/README.en.md index 3fc7a20..0e855a1 100644 --- a/README.en.md +++ b/README.en.md @@ -2,10 +2,26 @@ *[Versão em português](README.md)* +[![CI](https://github.com/lucianoon/forgehand/actions/workflows/ci.yml/badge.svg)](https://github.com/lucianoon/forgehand/actions/workflows/ci.yml) +[![Benchmark](https://github.com/lucianoon/forgehand/actions/workflows/benchmark.yml/badge.svg)](https://github.com/lucianoon/forgehand/actions/workflows/benchmark.yml) +[![Python 3.12+](https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/) +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) + A multi-agent system for software delivery: an orchestrator, executors specialized by capability, a judge with objective veto power, persistent project memory, parallel execution and a human gate on critical decisions. +## Evidence at a glance + +| Capability | Verifiable implementation | +|---|---| +| Parallelism | Independent task fan-out and deterministic merge by ID | +| Quality gate | Incremental judge combined with `pytest`, `ruff` and `mypy` | +| Human control | Approval, retry, partial acceptance and abort at critical decisions | +| Operational limits | Token, cost, time and attempt circuit breakers | +| Durable execution | PostgreSQL checkpoints and restart recovery | +| Observability | OTel/Langfuse spans per job and LLM call | + ## What it does You POST a request in natural language. A planner decomposes it into tasks diff --git a/README.md b/README.md index c00e73d..0b4d811 100644 --- a/README.md +++ b/README.md @@ -2,11 +2,27 @@ *[English version](README.en.md)* +[![CI](https://github.com/lucianoon/forgehand/actions/workflows/ci.yml/badge.svg)](https://github.com/lucianoon/forgehand/actions/workflows/ci.yml) +[![Benchmark](https://github.com/lucianoon/forgehand/actions/workflows/benchmark.yml/badge.svg)](https://github.com/lucianoon/forgehand/actions/workflows/benchmark.yml) +[![Python 3.12+](https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/) +[![Licença: MIT](https://img.shields.io/badge/licen%C3%A7a-MIT-green.svg)](LICENSE) + Sistema multiagente para desenvolvimento de software: orquestrador, executores especializados por capacidade, judge com veto objetivo, memória persistente, execução paralela e gate humano em decisões críticas. -## Subir +## Evidências rápidas + +| Capacidade | Implementação verificável | +|---|---| +| Paralelismo | Fan-out de tarefas independentes e merge determinístico por ID | +| Quality gate | Judge incremental combinado com `pytest`, `ruff` e `mypy` | +| Controle humano | Aprovação, retry, aceite parcial e abort em decisões críticas | +| Limites operacionais | Circuit breakers de tokens, custo, tempo e tentativas | +| Execução durável | Checkpoints em PostgreSQL e retomada após interrupção | +| Observabilidade | Spans OTel/Langfuse por job e chamada de LLM | + +## Início rápido ```bash cp .env.example .env