convez.ai
AgenteAutomaçãoAvançado
Alexry375

Agentic Workspace

Alexry375/agentic-workspace

Framework de contrato selado para delegação auditada a agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Template minimalista de workspace para delegar tarefas longas a agentes autônomos (Claude Code, Codex CLI). Define um contrato executável via `prompt.md` e validações, com auditoria mecânica antes de revisão humana do código gerado.

Instalação

$npx convez-ai Alexry375/agentic-workspace

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Orquestração de tarefas complexas com agents Claude
  • Validação e auditoria de saídas de código gerado
  • Criação de workspaces self-contained e auditáveis

Veredito

Abordagem engenhosa de garantia de qualidade via contrato + auditoria mecânica, mas com curva de aprendizado alta e dependências específicas (skills genius). Ideal para quem busca confiabilidade em delegação a agents, não para iniciantes.

README

A tradução para o português deste README ainda está na fila.

agentic-workspace

Méthodologie minimaliste de délégation de tâches longues à des agents autonomes (Codex CLI, Claude Code, tout harness lisant AGENTS.md/CLAUDE.md). v2 « contrat scellé » : la spec est un contrat exécutable (prompt.md squelette + inputs/checks/*.sh), gelée par hash (aw seal), et la livraison est auditée mécaniquement (aw audit : ré-exécution des checks + checks hold-out cachés + détection de tampering) avant lecture humaine du code.

main :   aw new <name> → remplit prompt.md + checks/ → aw seal <name>
humain : cd workspaces/<name> && codex   (ou claude)
agent :  aw start → travaille (aw check en boucle) → aw end
main :   aw audit <name> --mode code → lit le code → aw report <name> ok "<note>"

Les workspaces sont self-contained (procédure inlinée dans CLAUDE.md et AGENTS.md au moment du aw new) : déplacer ou supprimer ce repo ne casse aucun workspace existant.

Install

git clone https://github.com/Alexry375/agentic-workspace.git
ln -sf "$PWD/agentic-workspace/bin/aw" ~/.local/bin/aw   # ou ajoute bin/ au PATH

Prérequis : bash, jq, sha256sum. Prérequis user-level (hors repo) : skill genius — ~/.claude/skills/genius/ (Claude, avec hook) et ~/.agents/skills/genius/ (Codex, auto-découvert ; source : Alexry375/codex-config).

État per-machine : ~/.agentic-workspace/reports.jsonl (telemetry, override $AW_REPORTS) et ~/.agentic-workspace/holdout/<name>/ (checks cachés).

Aller plus loin

  • aw context (= shared/main-brief.md) — le brief complet de la session main : flow, gates, hold-out, méthode. C'est la doc de référence.
  • shared/procedure-core.md + tails — ce que lit l'agent dans son workspace.
  • reports/ — incidents et décisions datés, dont 2026-06-11-v2-redesign-contract-sealed.md (architecture v2 et ses raisons).
  • analysis/ — post-mortems des workspaces livrés, moteur d'évolution de la procédure.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados