convez.ai
AgenteAutomaçãoAvançado
contact715

Jidoka — Framework de Engenharia Agnóstica para Claude Code

contact715/jidoka

Multi-agente engineering pipeline: quality-first judge + 8 gates + TLA+ verification

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework multi-agente que transforma Claude Code em um pipeline de engenharia de software com 8 gates de verificação, judge best-of-N quality-first, andon halt com TLA+ formal e self-improvement em três níveis. Implementa princípios Toyota (Jidoka/Kaizen) para garantir qualidade integrada: defeitos não avançam, linha para em problemas críticos.

Instalação

$npx convez-ai contact715/jidoka

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á 3 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar pipelines de code review com 47 agentes especializados
  • Implementar verificação formal de sistemas críticos com TLA+
  • Estabelecer protocolos de automelhorias contínuas em agentes de IA
  • Criar ambientes de desenvolvimento agnóstico com gates de qualidade customizáveis

Veredito

Framework robusto e bem-documentado para times que precisam de engenharia agnóstica production-grade com agentes Claude. Curva de aprendizado alta (requer TLA+, filosofia Toyota, 47 agentes), mas retorno significativo em qualidade e confiabilidade. Ideal para contextos mission-critical.

README

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

Jidoka

Agentic engineering framework для Claude Code. Превращает Claude Code из одиночного ассистента в многоагентный инженерный конвейер: code review, качественные гейты, формальная верификация, самоулучшение.

Имя — от принципа Toyota Jidoka (自働化), «встроенное качество»: дефект не передаётся дальше по линии, а при проблеме линия останавливается (andon). Фреймворк делает то же с кодом — заставляет Claude Code писать дисциплинированно, как команда senior-инженеров, а не «сгенерировал и закоммитил».

С чего начать читать

Хочешь сразу собрать что-то (English): QUICKSTART.md — первая сборка за минуты через команды /jidoka-*, философию отложи на потом.

Глубже (RU):

  1. FRAMEWORK_DEEP_DIVE.md — подробный разбор: что это, как работает поток задачи от запроса до merge, что даёт, почему уровень топовых лабораторий. Начни отсюда.
  2. docs/ENGINEERING_SYSTEM_ASSESSMENT.md — структурированная оценка с маппингом каждого механизма на работы Anthropic / OpenAI / DeepMind.
  3. docs/CONSTITUTION.md — конституция среды (включая §8 Quality-First).
  4. docs/TOYOTA_WAY.md — две философии Toyota (Jidoka + Kaizen), заложенные в процесс.
  5. .claude/agents/best-of-N-judge.md — как из N реализаций выбирается лучшая по качеству, а не по «прошло и покороче».
  6. docs/AUTONOMOUS_PIPELINE.md + docs/MULTI_LEVEL_VERIFICATION.md — как устроен конвейер и гейты.

Структура

.claude/
  agents/            47 агентов-ролей + _TEMPLATE (вкл. project-steward, spec-custodian, prompt-evolver, red-team — непрерывная самоатака) (полная продуктовая студия: продукт/архитектура/build/дизайн/данные/запуск/качество) (chief-architect, reflexion-critic,
                     best-of-N-judge, debate-*, security-scanner, ...)
  skills/            32 навыка + _INDEX/_TEMPLATE (переиспользуемые паттерны)
  AGENT_PLAYBOOK.md  главный плейбук агентства
  settings.local.json

scripts/             184 скрипта-движка (.mjs движок + .sh обвязка; счёт = instantiation-audit):
                     andon-halt (stop-the-line), run-tla (формальная проверка),
                     compute-dora/slos/cost/carbon (observability),
                     detect-injection/drift/hallucinations (защита),
                     chaos-inject, run-fuzz (тестирование)

docs/
  CONSTITUTION.md            конституция + процесс поправок
  TOYOTA_WAY.md              философия качества
  AUTONOMOUS_PIPELINE.md     конвейер
  MULTI_LEVEL_VERIFICATION.md гейты L0.95–L0.99
  HIERARCHICAL_SPEC_SYSTEM.md 5 уровней спеков
  SELF_IMPROVEMENT_PROTOCOL.md петли самоулучшения
  archive/imported-product/   архив доков продукта-прародителя (read-only)
  CODING_STANDARDS / TESTING / SECURITY / DEBUGGING / DEVOPS
  formal/AndonHalt.tla       TLA+ верификация andon-механизма
  decisions/_TEMPLATE.md     формат ADR
  retros/_TEMPLATE.md        формат ретроспективы
  metrics/_TEMPLATE.md       формат метрик волны

package.json         100 npm-команд автоматизации
CLAUDE.md            пример project-instructions (generic-шаблон)

Как применить у себя

  1. Скопируй .claude/agents/ + .claude/skills/ + .claude/AGENT_PLAYBOOK.md в свой проект — роли и навыки универсальны.
  2. Возьми scripts/ — движок (andon, гейты, метрики, детекторы). Часть скриптов требует своих baseline-файлов, они генерируются на первом прогоне.
  3. docs/CONSTITUTION.md + docs/MISSION.md — замени контент на свой продукт, структуру (Mission Compass, разделы) оставь.
  4. Процессные доки (AUTONOMOUS_PIPELINE, MULTI_LEVEL_VERIFICATION, HIERARCHICAL_SPEC_SYSTEM, SELF_IMPROVEMENT_PROTOCOL, TOYOTA_WAY) переносятся как есть.
  5. Из package.json возьми нужные команды из секции scripts.

Что НЕ включено (специально)

  • Продуктовый код (app/, lib/, components/) — это не фреймворк.
  • Продуктовые доки (миссия продукта, воронки, бэкенд-ТЗ, питч) — кроме MISSION.md, оставленного как образец Mission Compass.
  • Реальные спеки и ретро конкретного проекта — оставлены только _TEMPLATE форматы. Цифры по накопленному корпусу (146 спеков, 101 ретро) приведены в ASSESSMENT как доказательство, что фреймворк обкатан на боевом проекте.
  • Тестовые fixtures и сгенерированные baseline.

Важно

CLAUDE.md и часть агентов/доков содержат примеры из нашего продукта (на котором фреймворк обкатан). При переносе они заменяются своими — это образцы формата, не жёсткая привязка.

Снимок на 2026-05-29.

Ver o original no GitHub

Bom para

Relacionados