From 5fb8ae5ca721dd6c4e0f04a7ef542c27c65a6f4c Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 24 Jun 2026 04:19:41 +0000 Subject: [PATCH 1/2] docs: add partial harness PM/PD/UX gap analysis Maps ECC fork resources against the harness PM/PD/UX v2 model. Marked as a dated, partial snapshot: the author's most complete repo has additional resources, so a mandatory re-analysis checklist must be run against the latest repository before treating it as complete. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01DKWzDusA9rRZmXeCtxJcUt --- gap-analysis.md | 102 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 gap-analysis.md diff --git a/gap-analysis.md b/gap-analysis.md new file mode 100644 index 0000000000..9835d3b838 --- /dev/null +++ b/gap-analysis.md @@ -0,0 +1,102 @@ +# Gap Analysis — Harness PM/PD/UX (v2) × Fork ECC + +> **Documento parcial e datado.** Gerado em 2026-06-24 a partir de **dois insumos apenas**: +> (1) este fork ECC, no estado lido nesta sessão; (2) os drafts `briefing-para-claude-code.md` +> e `harness-pm-pd-ux-v2.md`. **NÃO É UMA ANÁLISE COMPLETA.** + +--- + +## ⚠️ Aviso de completude (ler antes de usar) + +1. **O repositório de referência do autor é mais completo do que o descrito nos `.md`.** + Os drafts anexados foram implementados em outra conta e mencionam recursos + (memória de decisões DDD/SDD, pipeline de atualização Confluence/Jira, etc.) que + **podem já existir, em versão diferente ou mais avançada, na repo mais atualizada**. + Este gap-analysis foi montado contra o *snapshot* do fork ECC visível nesta sessão, + que pode estar **defasado** em relação a essa repo. + +2. **Pré-condição de aceite.** Este arquivo só pode ser tratado como completo **depois** + de o modelo executar a checklist de re-análise da seção 5 contra a versão mais + atualizada do repositório. Até lá, todas as linhas marcadas `[CHECAR]` e `[FALTA]` + são provisórias. + +3. **Marcas NEXUS.** `[FONTE-REPO]` = verificado por leitura de arquivo neste fork (caminho citado) · + `[FONTE]` = citação do modelo v2 · `[INFERIDO]` = derivado, premissa explícita · + `[HIPÓTESE]` = sem base verificável · `[CHECAR]` = não verificado nesta sessão · + `[FALTA]` = variável necessária ausente. + +--- + +## 1. Gap analysis — Componentes do harness × Fork ECC + +| Componente (v2) | Status no fork ECC | Alinhado ao v2? | Gap / O que falta | Ação recomendada | +|---|---|---|---|---| +| **1. Instruções / Rule Files** | **Sim.** `CLAUDE.md`, `SOUL.md`, `RULES.md`, `rules/` (23 linguagens), `skills/rules-distill`, `hookify` `[FONTE-REPO]` | Sim, e excede: o v2 só descreve o artefato; o ECC operacionaliza regra→hook | Coluna PM ("princípios inegociáveis") não está formalizada como artefato separado da config técnica | Derivar bloco "princípios inegociáveis do produto" no `CLAUDE.md` a partir da coluna PM | +| **2. Tools & MCP** | **Sim.** `skills/agent-harness-construction` (action space, schema-first, least-privilege), `mcp-server-patterns`, `api-connector-builder` `[FONTE-REPO]` | Sim. *Action receipt* `[FONTE][4]` mapeado em `status/summary/next_actions/artifacts` | *Idempotency keys* citadas como conceito, não como artefato verificado no fork | Confirmar `[CHECAR]` se há padrão de idempotência explícito nas skills MCP | +| **3. Orquestração** | **Sim.** `skills/orch-*`, `commands/multi-*`, `team-agent-orchestration`, `loop-operator` `[FONTE-REPO]` | Sim. "who has the ball / handoff" `[FONTE][26]` presente nos contratos `orch-*` | Visualização do controle atual (UX) é implícita, não um artefato de 1ª classe | Avaliar artefato de handoff visível derivado da coluna PD/UX | +| **4. Guardrails & Hooks** | **Sim.** `skills/safety-guard`, `gateguard`, `hooks/` (PreToolUse), `security-review`, `the-security-guide.md` `[FONTE-REPO]` | Parcial. Bloqueio: forte. UX do bloqueio: fraca | **Gap real:** estados de erro que expliquem motivo + recuperação + preservem agência `[FONTE][19]` não são recurso dedicado | Herdar padrão de error-state/recovery (candidato vindo do outro projeto) | +| **5. Memória / Sessão** | **Sim.** `hooks/memory-persistence`, `skills/knowledge-ops`, `save/resume-session`, `checkpoint`, `continuous-learning-v2` `[FONTE-REPO]` | Sim, e excede com instintos por escopo de projeto | UX "o que lembro / por quê / editar / apagar" `[FONTE][4]` parcial | Mapear a superfície de consentimento/edição de memória | +| **6. Avaliação / Teste** | **Sim.** `skills/eval-harness` (EDD, pass@k, golden dataset), `agent-eval`, `agent-self-evaluation`, `commands/learn-eval`, `agents/agent-evaluator` `[FONTE-REPO]` | Parcial — núcleo PM coberto; rubricas de UX não | **`[FALTA]` 01 (prioridade máx.):** rubricas qualitativas de UX (incerteza / carga cognitiva / clareza de handoff) no pipeline. `agent-self-evaluation` cobre 5 eixos genéricos, não os 3 de UX | Estender `agent-self-evaluation` com os 3 critérios de UX → promover `[FALTA]`→`[INFERIDO]` com premissa | +| **7. Observabilidade** | **Sim.** `skills/cost-tracking`, `hook stop:cost-tracker`, `commands/cost-report`, `ecc_dashboard.py`, `dashboard-builder` `[FONTE-REPO]` | Parcial. Custo/trace: sim. Timeline UX: parcial | "Linha do tempo de atividades colapsável" `[FONTE][4][25]` existe como dashboard, não como artefato UX legível | Desenhar timeline colapsável com severidade + passo atual | +| **8. Deployment / Service / HITL** | **Sim.** `skills/deployment-patterns`, `commands/quality-gate`/`promote`/`epic-*`/`pr` `[FONTE-REPO]` | Sim | Métricas `escalation/approval rate` permanecem `[HIPÓTESE]` (sem fonte no fork) | Manter `[HIPÓTESE]` até medir na repo atual | + +--- + +## 2. Linhas candidatas a NOVO pilar (pendências 04/05 do briefing) + +| Pilar candidato | Recursos no fork ECC | Veredito | +|---|---|---| +| **DDD / bounded context** (pend. 04) | `skills/hexagonal-architecture`, `architecture-decision-records`, `agent-architecture-audit` (12-layer) `[FONTE-REPO]` | **Promover a linha própria.** Base existe para modelar o particionamento da base federada | +| **Docs-para-agentes** (pend. 05) | `skills/knowledge-ops`, `documentation-lookup`, `update-docs`/`update-codemaps`, `doc-updater`, `rules-distill` `[FONTE-REPO]` | **Promover a linha própria.** É o núcleo do produto; curadoria contínua + KB versionada já presentes | +| **Memória de decisões** (novo, do outro projeto) | `skills/recursive-decision-ledger` (ledger JSONL append-only, marks accept/watch/reject, promotion gate), `architecture-decision-records` `[FONTE-REPO]` | **Incorporar.** Operacionaliza o "log de decisões" da §2 da v2 — nenhum draft tem isso implementado | + +--- + +## 3. Comparação com o projeto de terceiro (outra conta / drafts) + +> **Limitação:** o "projeto de terceiro" só é conhecido através dos dois `.md`. Recursos +> mencionados de passagem (Confluence pipeline, memória DDD/SDD) **não têm artefato +> inspecionável nesta sessão** → marcados `[CHECAR]`/`[FALTA]`. + +| Componente | Nossa posição (v2/ECC) | Abordagem do terceiro | Conv./Diverg. | Incorporar? | +|---|---|---|---|---| +| Avaliação/UX rubrics | `agent-self-evaluation` (5 eixos) | Rubricas qualitativas de UX no pipeline `[FALTA]` corpus | **Convergente em forma, divergente em conteúdo** | Sim, se o terceiro tiver as rubricas com citação | +| Memória de decisões | `recursive-decision-ledger` + ADR | DDD/SDD decision memory `[CHECAR]` | Provável convergência | Reconciliar quando a repo atual for lida | +| Pipeline Jira | `skills/jira-integration` + `commands/jira` (MCP atlassian) `[FONTE-REPO]` | Jira pipeline `[CHECAR]` | Convergente | Já coberto | +| Pipeline Confluence | **Ausente** no fork `[FONTE-REPO]` | Confluence pipeline `[CHECAR]` | **Divergente (gap do ECC)** | Sim — estender padrão MCP atlassian | +| Estados de erro (UX) | Bloqueio forte, UX fraca | `[FONTE][19]` Design for AI Error States | Divergente | Sim | + +--- + +## 4. Pendências do briefing — status nesta análise parcial + +| Pendência | Status | Observação | +|---|---|---| +| 01 — `[FALTA]` rubricas UX no eval | **Parcialmente desbloqueada** | `agent-self-evaluation` é a base mais próxima; falta estender p/ 3 critérios de UX | +| 02 — `[CHECAR]` métricas numéricas | **Não resolvida** | Sem fonte no fork; manter `[HIPÓTESE]` | +| 03 — `[CHECAR]` fonte [5] | **Não resolvida** | Não localizada neste fork | +| 04 — DDD como linha própria | **Desbloqueada** | Base arquitetural presente | +| 05 — docs-para-agentes como linha | **Desbloqueada** | Núcleo do produto presente | + +--- + +## 5. Checklist de re-análise OBRIGATÓRIA antes de aceitar como completo + +Executar contra a **repo mais atualizada do autor** (não apenas este fork): + +``` +[ ] 1. Listar agents/ skills/ commands/ hooks/ rules/ da repo ATUAL e comparar + com o inventário desta sessão — registrar deltas. +[ ] 2. Procurar recursos que os .md mencionam mas não detalham: + - memória de decisões DDD/SDD -> existe? em que forma? + - pipeline Confluence -> confirmar ausência/presença + - pipeline Jira -> confirmar paridade +[ ] 3. Reavaliar cada [CHECAR] e [FALTA] deste documento contra a repo atual. +[ ] 4. Reconciliar métricas [HIPÓTESE] (escalation/approval/semantic similarity) + com qualquer dado real medido na repo atual. +[ ] 5. Confirmar se os pilares candidatos (DDD, docs-para-agentes) JÁ são linhas + formais na repo atual antes de propô-los como "novos". +[ ] 6. Só então remover este aviso e marcar o documento como completo. +``` + +**Enquanto a seção 5 não for executada, este documento é um rascunho de trabalho, não um gap-analysis final.** From 5de7f58e2397a640dbb325a26ff5e01254e805c4 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 24 Jun 2026 09:48:41 +0000 Subject: [PATCH 2/2] docs: add worktree map and harness gap analysis - worktree-map.md: 3-level annotated map of the ECC fork derived from existing documentation (README, SOUL, AGENTS, WORKING-CONTEXT, skill placement policy) - gap-analysis.md: snapshot gap analysis of harness-pm-pd-ux-v2 vs fork ECC, with NEXUS epistemic marks and mandatory re-analysis checklist before treating as complete Co-Authored-By: Claude Sonnet 4.6 Claude-Session: https://claude.ai/code/session_01DKWzDusA9rRZmXeCtxJcUt --- worktree-map.md | 244 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 244 insertions(+) create mode 100644 worktree-map.md diff --git a/worktree-map.md b/worktree-map.md new file mode 100644 index 0000000000..ae29b6337e --- /dev/null +++ b/worktree-map.md @@ -0,0 +1,244 @@ +# Worktree Map — Everything Claude Code (ECC) + +> Mapeamento até 3 níveis de profundidade. Descricões derivadas da documentação do repositório +> (`README.md`, `SOUL.md`, `AGENTS.md`, `WORKING-CONTEXT.md`, `docs/SKILL-PLACEMENT-POLICY.md`). +> Gerado em 2026-06-24 contra o fork ECC (snapshot; pode divergir da repo de referência do autor). + +--- + +## Raiz + +| Item | Descrição | +|---|---| +| `CLAUDE.md` | Instruções inegociáveis para o agente; ponto de entrada do harness | +| `SOUL.md` | Identidade e princípios do produto (Agent-First, Test-Driven, Security-First) | +| `AGENTS.md` | Catálogo de agentes disponíveis e quando usar cada um | +| `RULES.md` | Referência rápida ao sistema de regras | +| `README.md` | Documentação pública; instalação, guias, multi-harness | +| `WORKING-CONTEXT.md` | Estado operacional atual do repo (branch, release, roadmap ECC 2.0) | +| `CONTRIBUTING.md` | Convenções de formato para agentes, skills, commands e hooks | +| `CHANGELOG.md` | Histórico de versões | +| `COMMANDS-QUICK-REF.md` | Referência rápida de todos os slash commands | +| `TROUBLESHOOTING.md` | Diagnóstico de problemas comuns | +| `SECURITY.md` | Política de segurança e disclosure responsável | +| `SPONSORING.md` / `SPONSORS.md` | Programa de sponsors do OSS | +| `the-longform-guide.md` | Guia extenso de uso do ECC | +| `the-shortform-guide.md` | Guia rápido de onboarding | +| `the-security-guide.md` | Guia de segurança aprofundado | +| `VERSION` | Versão corrente do pacote | +| `ecc_dashboard.py` | Dashboard Python de observabilidade (custo, sessões, métricas) | +| `agent.yaml` | Manifest de identidade cross-harness do agente ECC | +| `package.json` / `package-lock.json` / `yarn.lock` | Dependências Node.js | +| `pyproject.toml` | Configuração Python (testes, src/llm) | +| `eslint.config.js` / `commitlint.config.js` | Configuração de linting e commits | +| `install.sh` / `install.ps1` | Scripts de instalação (Linux/macOS e Windows) | +| `greptile.json` | Configuração de indexação de código (Greptile) | +| `.env.example` | Variáveis de ambiente documentadas | +| `gap-analysis.md` | *(gerado nesta sessão)* Análise de gap harness v2 × fork ECC | + +--- + +## `.claude/` — Configuração nativa Claude Code + +| Item | Descrição | +|---|---| +| `commands/` | Slash commands locais do projeto (`add-language-rules`, `database-migration`, `feature-development`) | +| `rules/` | Regras do projeto carregadas automaticamente (`node.md`, `everything-claude-code-guardrails.md`) | +| `skills/` | Skills locais ativas para esta sessão (`everything-claude-code`) | +| `enterprise/controls.md` | Controles de governança enterprise | +| `homunculus/instincts/` | Instintos aprendidos (continuous-learning-v2) — escopo de projeto | +| `research/` | Playbook de pesquisa do ECC | +| `team/` | Configuração de time (team-config.json) | +| `identity.json` | Identidade do agente para cross-harness | +| `ecc-tools.json` | Configuração de ferramentas ECC | +| `package-manager.json` | Detecção de gerenciador de pacotes (npm/yarn/pnpm/bun) | + +--- + +## `agents/` — Agentes especializados (~67) + +Agentes de delegação com frontmatter YAML (`name`, `description`, `tools`, `model`). +Cada agente é invocado proativamente quando o tipo de trabalho casa com seu domínio. + +| Subgrupo | Exemplos | Função | +|---|---|---| +| **Revisores de linguagem** | `python-reviewer`, `rust-reviewer`, `go-reviewer`, `typescript-reviewer`, `kotlin-reviewer`, `swift-reviewer`, `java-reviewer`, `php-reviewer`, `cpp-reviewer`, `vue-reviewer`, `react-reviewer`, `django-reviewer`, `fastapi-reviewer`, `flutter-reviewer`, `fsharp-reviewer`, `csharp-reviewer` | Revisão de qualidade por ecossistema | +| **Resolvedores de build** | `build-error-resolver`, `react-build-resolver`, `rust-build-resolver`, `go-build-resolver`, `kotlin-build-resolver`, `java-build-resolver`, `cpp-build-resolver`, `swift-build-resolver`, `dart-build-resolver`, `pytorch-build-resolver`, `django-build-resolver`, `harmonyos-app-resolver` | Diagnóstico e correção de falhas de build | +| **Arquitetura** | `architect`, `code-architect`, `network-architect`, `homelab-architect` | Decisões de design de sistema | +| **Qualidade / Segurança** | `code-reviewer`, `security-reviewer`, `performance-optimizer`, `refactor-cleaner`, `code-simplifier`, `silent-failure-hunter` | Auditoria, simplificação e segurança | +| **Planejamento / Orquestração** | `planner`, `chief-of-staff`, `loop-operator`, `tdd-guide` | Estratégia, coordenação e TDD | +| **Domínios especializados** | `harness-optimizer`, `mle-reviewer`, `healthcare-reviewer`, `database-reviewer`, `network-config-reviewer`, `network-troubleshooter`, `type-design-analyzer`, `comment-analyzer`, `conversation-analyzer`, `a11y-architect`, `seo-specialist`, `marketing-agent` | Domínios verticais | +| **Eval / IA** | `agent-evaluator`, `gan-evaluator`, `gan-generator`, `gan-planner`, `pr-test-analyzer`, `spec-miner` | Avaliação de agentes e modelos | +| **Docs / Código** | `doc-updater`, `docs-lookup`, `code-explorer`, `e2e-runner` | Documentação e exploração | +| **Open Source** | `opensource-forker`, `opensource-packager`, `opensource-sanitizer` | Pipeline de OSS | + +--- + +## `skills/` — Biblioteca de skills (~271) + +Skills curadas — `SKILL.md` por pasta. Distribuídas via manifests. Não confundir com skills geradas/importadas, que ficam em `~/.claude/skills/`. + +| Subgrupo | Exemplos | Função | +|---|---|---| +| **Harness / Agentes** | `agent-harness-construction`, `autonomous-agent-harness`, `agent-architecture-audit`, `eval-harness`, `agent-eval`, `agent-self-evaluation`, `agentic-engineering`, `agentic-os`, `continuous-agent-loop` | Construção, auditoria e avaliação do harness | +| **Conhecimento / Memória** | `knowledge-ops`, `recursive-decision-ledger`, `architecture-decision-records`, `continuous-learning-v2`, `context-budget`, `token-budget-advisor` | Gestão de KB, decisões e memória | +| **PM / Produto** | `product-capability`, `product-lens`, `intent-driven-development`, `plan-orchestrate`, `blueprint` | Especificação, AC e planejamento de produto | +| **Orquestração** | `team-agent-orchestration`, `team-builder`, `orch-*` (add-feature, build-mvp, change-feature, fix-defect, pipeline, refine-code) | Workflows multi-agente | +| **Avaliação / Qualidade** | `eval-harness`, `agent-eval`, `benchmark`, `benchmark-optimization-loop`, `verification-loop`, `ai-regression-testing` | Métricas, regressão e golden datasets | +| **Segurança** | `safety-guard`, `gateguard`, `security-review`, `security-scan`, `security-bounty-hunter`, `django-security`, `laravel-security`, `springboot-security`, `hipaa-compliance` | Guardrails, scanning e compliance | +| **Observabilidade / Custo** | `cost-tracking`, `cost-aware-llm-pipeline`, `dashboard-builder`, `canary-watch`, `automation-audit-ops` | Rastreamento de custo, dashboards e alertas | +| **Deployment / CI** | `deployment-patterns`, `git-workflow`, `github-ops`, `docker-patterns`, `kubernetes-patterns` | Pipeline de deploy e infra | +| **Padrões por linguagem** | `python-patterns`, `rust-patterns`, `golang-patterns`, `kotlin-patterns`, `react-patterns`, `vue-patterns`, `nodejs-*`, `django-patterns`, `fastapi-patterns`, `springboot-patterns`, `swift-*`, `java-coding-standards`, `cpp-coding-standards` | Convenções e padrões por ecossistema | +| **TDD / Testes** | `tdd-workflow`, `e2e-testing`, `django-tdd`, `laravel-tdd`, `springboot-tdd`, `quarkus-tdd`, `react-testing`, `python-testing`, `rust-testing`, `golang-testing`, `kotlin-testing` | Workflows de teste por stack | +| **Docs para agentes** | `documentation-lookup`, `rules-distill`, `skill-comply`, `skill-scout`, `skill-stocktake`, `ecc-guide`, `codebase-onboarding`, `code-tour` | Curadoria, validação e lookup de docs | +| **Pesquisa / IA** | `deep-research`, `search-first`, `prompt-optimizer`, `llm-trading-agent-security`, `recsys-pipeline-architect`, `scientific-thinking-*` | Pesquisa, otimização de prompts e IA aplicada | +| **Integração externa** | `jira-integration`, `google-workspace-ops`, `messages-ops`, `email-ops`, `unified-notifications-ops`, `x-api`, `exa-search`, `fal-ai-media`, `videodb` | Integrações com ferramentas externas | +| **Verticais** | `healthcare-*`, `homelab-*`, `defi-amm-security`, `customs-trade-compliance`, `energy-procurement`, `carrier-relationship-management` | Domínios de negócio específicos | +| **UX / Frontend** | `make-interfaces-feel-better`, `frontend-patterns`, `frontend-a11y`, `design-system`, `motion-*`, `liquid-glass-design`, `ui-demo`, `react-performance` | Design e performance de UI | + +--- + +## `commands/` — Slash commands (~92) + +Comandos invocáveis pelo usuário via `/nome`. Frontmatter `description:` obrigatório. + +| Subgrupo | Exemplos | Função | +|---|---|---| +| **Qualidade / Revisão** | `code-review`, `security-scan`, `quality-gate`, `refactor-clean`, `test-coverage` | Auditorias e gates de qualidade | +| **Planejamento** | `plan`, `plan-prd`, `feature-dev`, `prp-plan`, `prp-prd`, `prp-implement`, `prp-commit`, `prp-pr` | Do PRD ao commit | +| **Orquestração multi-agente** | `multi-plan`, `multi-execute`, `multi-frontend`, `multi-backend`, `multi-workflow`, `orch-*` | Workflows paralelos / hierárquicos | +| **Epic / Backlog** | `epic-claim`, `epic-decompose`, `epic-publish`, `epic-review`, `epic-sync`, `epic-unblock`, `epic-validate` | Gestão de epics e backlog | +| **Sessão / Memória** | `save-session`, `resume-session`, `checkpoint`, `instinct-status`, `instinct-export`, `instinct-import`, `sessions` | Persistência e recuperação de contexto | +| **Harness / Diagnóstico** | `harness-audit`, `hookify`, `hookify-configure`, `hookify-list`, `hookify-help`, `model-route` | Auditoria e configuração do harness | +| **Aprendizado** | `learn`, `learn-eval`, `skill-create`, `skill-health`, `evolve`, `promote` | Extração de padrões e evolução de skills | +| **Por linguagem** | `go-build/review/test`, `kotlin-build/review/test`, `rust-build/review/test`, `react-build/review/test`, `flutter-build/review/test`, `cpp-build/review/test`, `python-review`, `fastapi-review`, `vue-review` | Build, revisão e teste por stack | +| **Infra / Deploy** | `pm2`, `setup-pm`, `auto-update`, `update-codemaps`, `update-docs`, `project-init` | Infraestrutura e inicialização | +| **Loops / GAN** | `loop-start`, `loop-status`, `santa-loop`, `gan-build`, `gan-design` | Execução contínua e pipelines GAN | +| **Integrações** | `jira`, `pr`, `review-pr`, `cost-report`, `marketing-campaign` | Jira, GitHub e relatórios | +| **Utilitários** | `aside`, `prune`, `projects`, `ecc-guide` | Atalhos e navegação | + +--- + +## `hooks/` — Automações por gatilho + +| Item | Descrição | +|---|---| +| `hooks.json` | Definição dos hooks ativos (matchers + comandos) | +| `README.md` | Documentação do sistema de hooks | +| `memory-persistence/` | Hook de persistência de memória entre sessões | + +Os hooks do projeto executam via `scripts/hooks/run-with-flags.js` com suporte a `ECC_HOOK_PROFILE` e `ECC_DISABLED_HOOKS`. Tipos: `PreToolUse`, `PostToolUse`, `Stop`, `SessionStart`. + +--- + +## `rules/` — Regras por linguagem / domínio + +Diretrizes always-follow (segurança, estilo, testes). Organizadas por ecossistema. + +| Pasta | Conteúdo | +|---|---| +| `common/` | Regras transversais (segurança, git, performance, agentes) | +| `python/`, `golang/`, `rust/`, `typescript/`, `kotlin/`, `swift/`, `java/`, `cpp/`, `csharp/`, `dart/`, `fsharp/`, `php/`, `perl/`, `ruby/` | Estilo, padrões, segurança e testes por linguagem | +| `react/`, `vue/`, `angular/`, `nuxt/`, `web/` | Regras de frontend por framework | + +--- + +## `scripts/` — Utilitários Node.js + +| Item | Descrição | +|---|---| +| `lib/` | Helpers compartilhados (package-manager, utils, install-*, session-*, mcp-*) | +| `hooks/` | Scripts de hook (run-with-flags.js, cost-tracker, gateguard, etc.) | +| `ci/` | Utilitários de CI (supply-chain, security scan) | +| `ecc.js` | CLI principal do ECC | +| `harness-audit.js` | Motor de auditoria determinística do harness | +| `catalog.js` | Geração do catálogo de agentes/skills/commands | +| `install-apply.js` / `install-plan.js` | Motor de instalação seletiva | +| `repair.js` | Auto-reparo de configuração | +| `doctor.js` | Diagnóstico do ambiente | +| `orchestrate-worktrees.js` | Orquestração de worktrees paralelas | +| `release.sh` / `release-approval-gate.js` | Pipeline de release | +| `skill-create-output.js` / `skills-health.js` | Geração e saúde de skills | +| `dashboard-web.js` / `ecc_dashboard.py` | Dashboards de observabilidade | +| `auto-update.js` | Auto-atualização do plugin | + +--- + +## `tests/` — Suite de testes + +Mirror de `scripts/`. Runner: `node tests/run-all.js`. + +| Pasta | Descrição | +|---|---| +| `lib/` | Testes unitários dos helpers (`utils`, `package-manager`, `session-*`, `install-*`, `mcp-*`) | +| `hooks/` | Testes de integração de hooks (cost-tracker, gateguard, quality-gate, memory, etc.) | +| `commands/` | Testes de frontmatter e comportamento de commands | +| `ci/` | Testes de validação de CI (supply-chain, segurança, catálogo) | +| `docs/` | Testes de cobertura de documentação | +| `scripts/` | Testes de scripts utilitários | +| `integration/` | Testes de integração ponta-a-ponta | +| `run-all.js` | Orquestrador do suite completo | +| `test_*.py` | Testes Python para `src/llm` (providers, executor, resolver) | + +--- + +## `docs/` — Documentação estendida + +| Item | Descrição | +|---|---| +| `architecture/` | Arquitetura cross-harness, ECC 2.0 reference | +| `releases/` | Release notes por versão | +| `design/` | Decisões de design | +| `business/` | Materiais de negócio | +| `security/` | Guias de segurança | +| `fixes/` / `drafts/` | Correções pendentes e rascunhos | +| `HERMES-SETUP.md` | Guia de setup do operador Hermes (ECC 2.0) | +| `SKILL-PLACEMENT-POLICY.md` | Política de onde skills curadas vs. geradas vivem | +| `SKILL-DEVELOPMENT-GUIDE.md` | Guia de criação de skills | +| `SELECTIVE-INSTALL-*.md` | Arquitetura de instalação seletiva | +| `ECC-2.0-*.md` | Roadmap e arquitetura de referência do ECC 2.0 | +| `MCP-CONNECTOR-POLICY.md` | Política de conectores MCP | +| `pt-BR/`, `zh-CN/`, `ja-JP/`, `ko-KR/`, `de-DE/`, `es/`, `ru/`, `tr/`, `vi-VN/`, `th/`, `zh-TW/`, `ur/` | Traduções do README | + +--- + +## Harnesses alternativos (cross-harness portability) + +| Pasta | Harness | Conteúdo | +|---|---|---| +| `.agents/` | Genérico / marketplace | `plugins/marketplace.json` + subset de skills portadas | +| `.claude/` | Claude Code | Commands, rules, skills, enterprise controls | +| `.claude-plugin/` | Claude plugin marketplace | `plugin.json`, `marketplace.json` | +| `.codex/` | OpenAI Codex | `AGENTS.md`, `config.toml`, agentes `.toml` | +| `.codex-plugin/` | Codex plugin | `plugin.json` | +| `.cursor/` | Cursor | `hooks/`, `rules/` (por linguagem), `skills/` | +| `.codebuddy/` | CodeBuddy | Scripts de install/uninstall | +| `.gemini/` | Gemini CLI | `GEMINI.md` | +| `.kiro/` | Kiro | Agentes `.json`+`.md`, hooks `.kiro.hook`, skills, scripts, settings | +| `.opencode/` | OpenCode | Config, hooks, skills | +| `.qwen/` | Qwen | Config | +| `.trae/` | Trae | Config | +| `.zed/` | Zed | Config | +| `.vscode/` | VS Code | Config de workspace | + +--- + +## Demais pastas + +| Pasta | Descrição | +|---|---| +| `mcp-configs/` | Configurações de MCP servers (`mcp-servers.json`) | +| `manifests/` | Manifestos de instalação seletiva (`install-modules.json`) | +| `schemas/` | JSON schemas de validação | +| `contexts/` | Contextos de sessão (`dev.md`, `research.md`, `review.md`) | +| `integrations/` | Integrações externas (`aura/`) | +| `config/` | Mapeamentos de projeto e coordenação GitHub | +| `scaffolds/` | Templates de scaffolding (`cursor/`) | +| `research/` | Estudos e análises internas | +| `examples/` | Exemplos de uso | +| `plugins/` | Plugins ECC | +| `assets/` | Imagens e assets de documentação | +| `ecc2/` | ECC 2.0 alpha (Rust) — `Cargo.toml`, `src/` | +| `src/llm/` | Provider Python (`cli/`, `core/`, `prompt/`, `providers/`, `tools/`) | +| `legacy-command-shims/` | Shims de compatibilidade com comandos legados | +| `.github/` | CI/CD (`workflows/`), templates de PR/issue, Copilot instructions, prompts |