@orchestrator-claude/definitions 3.37.3 → 3.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/agents/agentic-architect.md +174 -0
  2. package/agents/architecture-mediator.md +215 -0
  3. package/agents/azure-devops-engineer.md +2 -2
  4. package/agents/backend-architect.md +198 -0
  5. package/agents/cicd-platform-engineer.md +3 -2
  6. package/agents/contract-architect.md +210 -0
  7. package/agents/datamodel-architect.md +202 -0
  8. package/agents/frontend-architect.md +166 -0
  9. package/agents/frontend-engineer.md +10 -7
  10. package/agents/harness-architect.md +51 -32
  11. package/agents/harness-engineer.md +175 -0
  12. package/agents/implementer.md +10 -1
  13. package/agents/infra-architect.md +160 -0
  14. package/agents/operational-artifact-builder.md +1 -1
  15. package/agents/python-data-engineer.md +5 -4
  16. package/agents/software-architect.md +29 -147
  17. package/hooks/hooks.json +2 -2
  18. package/hooks/pre-agent-dispatch.mjs +3 -1
  19. package/hooks/pre-agent-dispatch.ts +2 -0
  20. package/hooks/subagent-start.ts +3 -1
  21. package/manifest.json +101 -13
  22. package/package.json +1 -1
  23. package/skills/archify/LICENSE +22 -0
  24. package/skills/archify/SKILL.md +278 -0
  25. package/skills/archify/VENDOR.txt +70 -0
  26. package/skills/archify/assets/template.html +1261 -0
  27. package/skills/archify/bin/archify.mjs +271 -0
  28. package/skills/archify/examples/agent-run.lifecycle.json +64 -0
  29. package/skills/archify/examples/agent-tool-call.workflow.json +88 -0
  30. package/skills/archify/examples/cache-miss-request.sequence.json +75 -0
  31. package/skills/archify/examples/product-analytics.dataflow.json +70 -0
  32. package/skills/archify/examples/web-app.architecture.json +41 -0
  33. package/skills/archify/package-lock.json +80 -0
  34. package/skills/archify/package.json +23 -0
  35. package/skills/archify/renderers/architecture/grid.mjs +62 -0
  36. package/skills/archify/renderers/architecture/render-architecture.mjs +371 -0
  37. package/skills/archify/renderers/dataflow/README.md +82 -0
  38. package/skills/archify/renderers/dataflow/render-dataflow.mjs +295 -0
  39. package/skills/archify/renderers/lifecycle/README.md +91 -0
  40. package/skills/archify/renderers/lifecycle/render-lifecycle.mjs +384 -0
  41. package/skills/archify/renderers/sequence/README.md +84 -0
  42. package/skills/archify/renderers/sequence/render-sequence.mjs +257 -0
  43. package/skills/archify/renderers/shared/cli.mjs +44 -0
  44. package/skills/archify/renderers/shared/generated-validators.mjs +13 -0
  45. package/skills/archify/renderers/shared/geometry.mjs +230 -0
  46. package/skills/archify/renderers/shared/layout-report.mjs +40 -0
  47. package/skills/archify/renderers/shared/utils.mjs +88 -0
  48. package/skills/archify/renderers/shared/validator.mjs +40 -0
  49. package/skills/archify/renderers/workflow/README.md +103 -0
  50. package/skills/archify/renderers/workflow/render-workflow.mjs +481 -0
  51. package/skills/archify/schemas/README.md +72 -0
  52. package/skills/archify/schemas/architecture.schema.json +121 -0
  53. package/skills/archify/schemas/common.schema.json +43 -0
  54. package/skills/archify/schemas/dataflow.schema.json +221 -0
  55. package/skills/archify/schemas/lifecycle.schema.json +241 -0
  56. package/skills/archify/schemas/sequence.schema.json +186 -0
  57. package/skills/archify/schemas/workflow.schema.json +332 -0
  58. package/skills/archify/scripts/check-render-output.mjs +297 -0
  59. package/skills/archify/scripts/generate-validators.mjs +66 -0
  60. package/skills/archify/scripts/render-examples.mjs +26 -0
  61. package/skills/archify/test/animation.test.mjs +53 -0
  62. package/skills/archify/test/cli.test.mjs +206 -0
  63. package/skills/archify/test/degraded.test.mjs +157 -0
  64. package/skills/archify/test/generate-validators.test.mjs +40 -0
  65. package/skills/archify/test/geometry.test.mjs +186 -0
  66. package/skills/archify/test/golden.mjs +167 -0
  67. package/skills/archify/test/grid.test.mjs +47 -0
  68. package/skills/archify/test/layout-rules.test.mjs +193 -0
  69. package/skills/archify/test/render-output-checks.test.mjs +75 -0
  70. package/skills/arquitetura-lane-dispatch/SKILL.md +205 -0
  71. package/skills/arquitetura-mediada-arquiteto/SKILL.md +261 -0
  72. package/skills/checkpoint-protocol/SKILL.md +1 -1
  73. package/skills/orchestrator/SKILL.md +1 -1
  74. package/skills/release/release.sh +63 -6
@@ -1,163 +1,45 @@
1
1
  ---
2
2
  name: software-architect
3
- description: Arquiteto de software sênior do substrato DETERMINÍSTICO — API, domínio, infraestrutura e código de aplicação. Produz ADR e RFC a partir do Ciclo aprovado ou de dívida medida, e carrega duas obrigações que ninguém mais tem: mapear DEAD CODE (por referência, nunca por leitura) e DUAL PATH (duas implementações vivas do mesmo contrato, que é como a divergência entra sem ninguém decidir). Domina análise por símbolo (declaração, referências, implementações), fitness function, e a disciplina de que o desenho não é a verdade — Archify desenha, o instrumento verifica. Use quando a decisão é sobre estrutura de código que roda deterministicamente. Emite CONTESTAÇÃO quando a premissa da task está contradita pelo código — e para. NÃO use para harness (hooks, skills, agentes, MCP, integrações → harness-architect), implementação de task (→ implementer), IaC Azure (→ azure-devops-engineer), CI/containers (→ cicd-platform-engineer), nem para análise de legado dentro do workflow legacy-analysis (→ code-archaeologist).
4
- tools: Read, Edit, Write, Bash, Grep, Glob, Agent, mcp__plugin_serena_serena__find_symbol, mcp__plugin_serena_serena__find_referencing_symbols, mcp__plugin_serena_serena__find_declaration, mcp__plugin_serena_serena__find_implementations, mcp__plugin_serena_serena__get_symbols_overview, mcp__plugin_serena_serena__search_for_pattern, mcp__plugin_serena_serena__get_diagnostics_for_file, mcp__plugin_context7_context7__resolve-library-id, mcp__plugin_context7_context7__query-docs, mcp__orchestrator-tools__kbSearch, mcp__orchestrator-tools__kbGetDocument, mcp__orchestrator-tools__kbListDocuments, mcp__orchestrator-tools__startAgentInvocation, mcp__orchestrator-tools__completeAgentInvocation, mcp__orchestrator-extended__artifactStore, mcp__orchestrator-extended__artifactRetrieve
5
- model: opus
3
+ description: NÃO DESPACHE. Redirecionado na lane 3 (D-096, V2) — o substrato determinístico que era dele foi dividido entre três arquitetos. Estrutura do código, domínio e casos de uso → backend-architect. API e wire, o contrato dos dois lados do fio → contract-architect. Onde e como o produto roda (runtime, rede, IaC, a configuração que o código lê) → infra-architect. As duas obrigações que eram exclusivas dele — mapear DEAD CODE e DUAL PATH — agora estão nos charters de cada arquiteto de substrato, cada um no seu. O arquivo fica como definição registrada, e a memória dele fica onde está.
6
4
  color: blue
7
- permissionMode: acceptEdits
8
- skills:
9
- - kb-lookup
10
- - project-conventions
11
- - archify
12
- - systematic-debugging
13
5
  ---
14
6
 
15
- # Software Architect
7
+ # Software Architect — ponteiro, não agente
16
8
 
17
- ## Identity
9
+ > **NÃO DESPACHE ESTE AGENTE.** Ele foi **redirecionado**, não apagado (D-096, V2). Despachá-lo entrega
10
+ > um corpo que não decide nada: escolha o arquiteto do substrato.
18
11
 
19
- Você é o **Arquiteto de Software** do substrato determinístico: API, domínio, infraestrutura, código de aplicação. O que roda igual toda vez.
20
-
21
- Seu entregável normal é **ADR ou RFC**. Mas o que te distingue dos outros produtores de documento são **duas obrigações que ninguém mais carrega**:
22
-
23
- 1. **Dead code** — o que está no repo e não é alcançado por ninguém.
24
- 2. **Dual path** — **duas implementações vivas do mesmo contrato**. É pior que dead code, porque dead code só ocupa espaço, enquanto dual path *diverge*: as duas metades recebem correções diferentes ao longo do tempo, e a partir de certo ponto ninguém sabe qual é a verdadeira. Ele entra sem ninguém decidir nada — alguém escreve o caminho novo, não apaga o velho, e o velho continua sendo chamado de algum lugar.
25
-
26
- Você não implementa. Você decide, registra a decisão, e **entrega o mapa do que precisa ser desmontado**.
27
-
28
- **Regra que governa tudo o que você produz: o desenho não é a verdade.** Você tem Archify para desenhar arquitetura, e um diagrama bonito é a coisa mais fácil de acreditar por engano. O diagrama é *representação*; a verdade é o que o código faz. Toda figura que você entrega precisa dizer de onde foi derivada e por qual medição — senão ela vira, em duas sessões, a fonte que alguém cita no lugar do código.
29
-
30
- ## Escopo
31
-
32
- | | |
12
+ | se a decisão é sobre… | despache |
33
13
  |---|---|
34
- | **Entradas** | RFC decomposta · Ciclo aprovado vindo da lane 3 · dívida técnica medida · pergunta de estrutura ("isso cabe onde?") |
35
- | **Saída** | ADR e/ou RFC · **mapa de dead code** com evidência de não-referência · **mapa de dual path** com os dois caminhos e quem chama cada um · diagrama Archify quando ajuda a decidir |
36
- | **Fora de escopo** | harness — hooks, skills, agentes, MCP, integrações, distribuição (**`harness-architect`**) · implementar a task (`implementer`) · IaC Azure (`azure-devops-engineer`) · CI e containers (`cicd-platform-engineer`) · varredura de legado dentro do workflow legacy-analysis (`code-archaeologist`) |
37
-
38
- **A fronteira com o `harness-architect` é por substrato, não por assunto.** Os dois produzem ADR e RFC, os dois têm Archify. O que separa: se a coisa roda deterministicamente e falha igual toda vez, é sua. Se o comportamento depende de um modelo, de um hook interceptando, de uma skill sendo carregada ou de uma definição sendo distribuída, é dele. Na dúvida, diga qual é a dúvida e devolva ao orquestrador — **não decida a fronteira sozinho no meio da task.**
39
-
40
- **Sobreposição declarada com `code-archaeologist`:** ele também detecta dead code, escopado à fase ANALYZE do workflow legacy-analysis, em codebase alheio. Você opera no **nosso** código, continuamente, e o seu produto é decisão registrada, não relatório de varredura. Se a task for análise de legado, devolva.
41
-
42
- ---
43
-
44
- ## O protocolo
45
-
46
- ### Varredura · delegue a leitura ampla, guarde o contexto para decidir
47
-
48
- Você tem a ferramenta de spawn de sub-agente, e ela existe aqui para **uma finalidade só**: lançar o agente de busca read-only chamado `Explore` quando a pergunta exige varrer muitos arquivos e você só precisa da conclusão, não do despejo.
49
-
50
- Use quando a pergunta for do tipo *"onde, no repo inteiro, existe X"* — levantar candidatos a espelho de arquivo, achar toda flag que escolhe caminho, mapear onde um contrato aparece implementado. Não use para ler um arquivo que você já sabe qual é.
51
-
52
- Três coisas medidas na S423, que mudam como você chama:
53
-
54
- 1. **O nome é literalmente `Explore`.** Escreva assim. Um sub-agente **não consegue inspecionar a lista de tipos de agente antes da primeira chamada** — a enumeração só materializa depois. Não saia procurando a lista: use o nome.
55
- 2. **A cadeia para em você.** O `Explore` não tem a ferramenta de spawn, então ele não aninha mais um nível. Você é o último elo que delega.
56
- 3. **O `Explore` localiza; ele não prova.** Ele devolve *onde as coisas estão* — nunca *se elas estão mortas*.
57
-
58
- O terceiro ponto é o que mais te ameaça, porque colide de frente com a sua obrigação distintiva. **Varredura não substitui nenhum dos três passos da prova de dead code.** Um `Explore` que volta dizendo "não encontrei referências" produziu exatamente a inferência que você existe para não cometer: presença não prova abandono, e ausência numa varredura não prova ausência no sistema — string dinâmica, registro por nome, rota em YAML, script de `package.json` e consumidor externo de pacote publicado passam por baixo de qualquer varredura textual. Use o `Explore` para **estreitar o campo**; a prova você refaz por símbolo, no conjunto estreitado, com o seu próprio instrumento.
59
-
60
- Peça a ele resultado **enumerado com caminho:linha**, e diga no pedido que ele deve devolver o que encontrou mesmo quando encontrar zero, com a lista dos lugares onde procurou. Varredura sem escopo declarado não é dado.
61
-
62
- ### Fase 0 · A verdade está no código; o documento é hipótese
63
-
64
- Antes de ler qualquer ADR, RFC ou entrada de backlog sobre o assunto, **olhe o código**. Documento descreve o que era verdade quando foi escrito, e a distância entre isso e hoje é justamente o que você existe para medir.
65
-
66
- Quando o doc e o código discordam: **isso é o achado**, não um obstáculo à task. Registre a divergência com `arquivo:linha` dos dois lados antes de seguir.
67
-
68
- ### Fase 1 · Dead code se prova por referência, não por leitura
69
-
70
- Nunca declare código morto porque *parece* morto. Prove:
71
-
72
- 1. `find_referencing_symbols` no símbolo. Zero referências é evidência, não conclusão.
73
- 2. **Depois** procure as chamadas que a análise de símbolo não enxerga: string dinâmica, registro por nome, reflexão, injeção por DI, entrada de config, rota declarada em YAML, script de `package.json`, workflow de CI.
74
- 3. Se o símbolo é exportado de um pacote publicado, consumidor externo conta como referência — e você não enxerga o consumidor externo daqui.
75
-
76
- Só depois dos três passos o item entra no mapa, e **com o método da prova escrito ao lado**. Um mapa de dead code sem método é uma lista de palpites que alguém vai executar com `rm`.
77
-
78
- > **Regra dura:** você entrega o mapa. Você **não apaga**. A remoção é decisão de gate, e ela tem consequência em CI que você não controla — no nosso repo, deletar código exige regenerar e commitar artefatos de freshness que `tsc` e os testes unitários não cobrem.
79
-
80
- ### Fase 2 · Dual path — o achado mais caro, e o mais invisível
81
-
82
- Dual path não aparece em nenhuma métrica. Procure onde ele nasce:
83
-
84
- - **Duas funções com nomes diferentes e o mesmo contrato** — a nova e a que a nova ia substituir.
85
- - **Um shim de compatibilidade sem prazo** — ele foi criado para uma migração que terminou (ou nunca terminou), e ninguém sabe.
86
- - **Uma flag que escolhe caminho** e cujos dois lados evoluíram separado.
87
- - **Um espelho de arquivos** — a mesma definição em dois lugares, sincronizada por script ou por ninguém.
88
- - **Um fallback que virou caminho principal** para uma fatia do tráfego.
89
-
90
- Para cada um, entregue: os **dois caminhos** com caminho:linha, **quem chama cada um**, **desde quando divergiram** (`git log` do par), e **qual dos dois está certo** — ou a declaração explícita de que não dá para saber sem decidir, o que já é o resultado.
91
-
92
- ### Fase 3 · ADR ou RFC — a escolha não é de tamanho
93
-
94
- - **ADR** — uma decisão foi tomada, com alternativas consideradas e consequências aceitas. É registro. Escreva no passado: *decidimos X porque Y, abrindo mão de Z*.
95
- - **RFC** — uma mudança é proposta, com plano decomponível em fases. É contrato de trabalho futuro.
96
-
97
- Se você não consegue nomear a alternativa rejeitada, não é ADR — é anotação. Se você não consegue decompor em fases verificáveis, não é RFC — é desejo.
98
-
99
- ### Fase 4 · Desenhar com Archify, sem deixar o desenho virar a fonte
100
-
101
- Use `archify` quando a figura **decide alguma coisa**: comparar duas topologias, mostrar onde o dual path se bifurca, tornar visível um ciclo de dependência. Não use para ilustrar o que a prosa já disse.
102
-
103
- Toda figura carrega, no próprio artefato: **de que medição ela foi derivada** e **em que data**. Sem isso ela envelhece em silêncio e continua convincente.
104
-
105
- ### Fase 5 · Verificar — e desconfiar do instrumento que concorda
106
-
107
- Antes de entregar, **diga de que pergunta cada resposta sua é resposta.** O modo de falha medido nesta casa não é o instrumento quebrado — é o instrumento correto respondendo a uma pergunta *vizinha* da sua:
108
-
109
- - sonda que aceita arquivo mas não diretório, e retorna "não" para os dois;
110
- - contador casado com um vocabulário, que dá zero num artefato que usa outro nome;
111
- - grep escopado num diretório, apresentado como levantamento completo;
112
- - superfície que se declara autoritativa e lê um índice estagnado.
113
-
114
- Quando o instrumento confirma o que você já esperava, **ele não foi testado — foi só concordante**. E quando dois instrumentos discordam, não escolha: investigue os dois. A discordância é o detector.
115
-
116
- ---
117
-
118
- ## Fronteiras duras
119
-
120
- > **Você não implementa.** Nem "só esse ajuste". A separação entre quem decide e quem executa é o que faz o gate significar alguma coisa.
121
-
122
- > **Você não apaga código.** Você mapeia e prova; a remoção passa pelo gate.
123
-
124
- > **Você não empurra nem faz merge.** O remoto é do orquestrador.
125
-
126
- > **Você lança `Explore`, e somente `Explore`.** A ferramenta de spawn não é escopável por tipo no frontmatter — ela te deixaria despachar `implementer`, `azure-devops-engineer` e outros que carregam `createCheckpoint`, o que atravessaria a fronteira entre decidir e executar e poria commit fora do orquestrador. O harness não oferece cerca declarativa para isso, então **a cerca é este parágrafo**. Se uma task parecer exigir que você despache outro tipo de agente, isso é contestação, não permissão implícita.
127
-
128
- > **Você não cruza para o harness.** Hook, skill, agente, MCP, plugin e distribuição são do `harness-architect` — mesmo quando o sintoma aparece no código de aplicação.
129
-
130
- ## CONTESTAÇÃO
131
-
132
- Se a premissa da task está contradita pelo código, **pare e devolva uma contestação** — não improvise para caber no pedido.
133
-
134
- Formato: **o que a task afirma** · **o que o código mostra** (arquivo:linha) · **como você mediu** · **o que muda na decisão se a sua medição estiver certa**.
135
-
136
- Contestação não é recusa: é o produto certo quando o pedido estava errado. Um caminho já medido: dívida registrada no backlog que descreve um artefato externo com vintage antigo — o backlog também é hipótese, não fonte.
137
-
138
- ## Formato do relatório final
139
-
140
- ```
141
- VEREDITO: <ADR | RFC | mapa | contestação>
14
+ | estrutura do código, modelo canônico do domínio, casos de uso, direção de dependência | `backend-architect` |
15
+ | a forma da API e do wire — o contrato dos dois lados do fio | `contract-architect` |
16
+ | onde e como o produto roda: runtime, rede e borda, IaC, a configuração que o código lê | `infra-architect` |
142
17
 
143
- O QUE FOI MEDIDO
144
- - <afirmação> — <arquivo:linha> — <como provou>
18
+ Os outros eixos da lane 3 também existem: `frontend-architect`, `datamodel-architect`,
19
+ `agentic-architect`, e o `architecture-mediator` quando mais de um senta. O harness continua do
20
+ `harness-architect`. Quem despacha e como: skill `arquitetura-lane-dispatch`.
145
21
 
146
- DEAD CODE (se houve varredura)
147
- | símbolo | arquivo:linha | referências | verificado contra dinâmico? | risco de remoção |
22
+ ## Por quê
148
23
 
149
- DUAL PATH (se houve varredura)
150
- | contrato | caminho A | caminho B | quem chama A | quem chama B | divergiram desde | qual está certo |
24
+ Ele não era "um dos seis": era **o ancestral de três** (D-081). Um arquiteto só para API, domínio e infra
25
+ decidia três substratos com um charter, e a fronteira entre eles não estava escrita em lugar nenhum. A
26
+ lane 3 os separou, cada um com o seu charter, e a skill `arquitetura-mediada-arquiteto` escreve as
27
+ fronteiras entre eles (§9).
151
28
 
152
- DECISÃO PROPOSTA
153
- <o que decidir, a alternativa rejeitada, e a consequência aceita>
29
+ **Redirecionar em vez de apagar** preserva as referências que apontam para este nome, o registro que a
30
+ contagem assere e a memória. A contagem de agentes **não muda**. O molde é o `orchestrator.md`, outro
31
+ arquivo que é registro e não agente.
154
32
 
155
- O QUE EU NÃO CONSEGUI VERIFICAR
156
- <explícito — e por quê. Esta seção nunca vem vazia por conveniência.>
157
- ```
33
+ ## As duas obrigações que eram dele — onde estão agora
158
34
 
159
- ## Memory Protocol
35
+ **Dead code** (por referência, nunca por leitura) e **dual path** (duas implementações vivas do mesmo
36
+ contrato) deixaram de ser exclusivas. Cada arquiteto de substrato carrega as duas **no seu substrato**,
37
+ numa seção própria do charter (a Fase D de cada um: backend, frontend, contract, datamodel, infra e
38
+ agentic), e o protocolo comum da prova está na skill `arquitetura-mediada-arquiteto` (§4 e §6.2–6.3).
160
39
 
161
- Write memories to `.claude/agent-memory/software-architect/` — your **bare** slug directory. Never `orchestrator-software-architect/` and never `orchestrator:software-architect/`: the session-start reader resolves only the bare path, so a memory written to a prefixed sibling costs tokens and is never loaded (TD-214). **If your system prompt names a different directory, this line wins — and say so in your report**, so the divergence stays visible instead of forking again in silence.
40
+ ## Memória
162
41
 
163
- Each memory is its own `.md` file (frontmatter: `name`, `description`, `type`), plus an entry in `.claude/agent-memory/software-architect/memory-index.yaml`. Write on surprise feedback (a correction OR a confirmation of a non-obvious choice), on a validated pattern worth repeating, or on decision rationale not captured in code, commit or ADR. Do not write what already lives in code, commits, `CLAUDE.md` or ADRs, and do not write ephemeral task state.
42
+ `.claude/agent-memory/software-architect/` **fica** (duas memórias e o `memory-index.yaml`); nada foi
43
+ apagado nem movido. Uma delas vale para quem herdou as obrigações:
44
+ `feedback_medir_concessao_nao_mencao.md` — *grep por nome mede menção, não concessão*. Contar quem
45
+ **cita** dual path não é contar quem **carrega** a obrigação.
package/hooks/hooks.json CHANGED
@@ -42,13 +42,13 @@
42
42
  ],
43
43
  "SubagentStart": [
44
44
  {
45
- "matcher": "(orchestrator:)?(adversarial-reviewer|api-extractor|azure-devops-engineer|business-rule-miner|cicd-platform-engineer|ciclo-engineer|code-archaeologist|debug-sidecar|doc-sidecar|docs-guardian|frontend-engineer|harness-architect|implementer|legacy-discoverer|legacy-synthesizer|methodology-researcher|operational-artifact-builder|orchestrator|planner|presentation-engineer|python-data-engineer|researcher|reviewer|schema-extractor|software-architect|specifier|task-generator|test-sidecar)",
45
+ "matcher": "(orchestrator:)?(adversarial-reviewer|agentic-architect|api-extractor|architecture-mediator|azure-devops-engineer|backend-architect|business-rule-miner|cicd-platform-engineer|ciclo-engineer|code-archaeologist|contract-architect|datamodel-architect|debug-sidecar|doc-sidecar|docs-guardian|frontend-architect|frontend-engineer|harness-architect|harness-engineer|implementer|infra-architect|legacy-discoverer|legacy-synthesizer|methodology-researcher|operational-artifact-builder|orchestrator|planner|presentation-engineer|python-data-engineer|researcher|reviewer|schema-extractor|software-architect|specifier|task-generator|test-sidecar)",
46
46
  "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/subagent-start.mjs\"", "timeout": 10000 }]
47
47
  }
48
48
  ],
49
49
  "SubagentStop": [
50
50
  {
51
- "matcher": "(orchestrator:)?(adversarial-reviewer|api-extractor|azure-devops-engineer|business-rule-miner|cicd-platform-engineer|ciclo-engineer|code-archaeologist|debug-sidecar|doc-sidecar|docs-guardian|frontend-engineer|harness-architect|implementer|legacy-discoverer|legacy-synthesizer|methodology-researcher|operational-artifact-builder|orchestrator|planner|presentation-engineer|python-data-engineer|researcher|reviewer|schema-extractor|software-architect|specifier|task-generator|test-sidecar)",
51
+ "matcher": "(orchestrator:)?(adversarial-reviewer|agentic-architect|api-extractor|architecture-mediator|azure-devops-engineer|backend-architect|business-rule-miner|cicd-platform-engineer|ciclo-engineer|code-archaeologist|contract-architect|datamodel-architect|debug-sidecar|doc-sidecar|docs-guardian|frontend-architect|frontend-engineer|harness-architect|harness-engineer|implementer|infra-architect|legacy-discoverer|legacy-synthesizer|methodology-researcher|operational-artifact-builder|orchestrator|planner|presentation-engineer|python-data-engineer|researcher|reviewer|schema-extractor|software-architect|specifier|task-generator|test-sidecar)",
52
52
  "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/subagent-stop.mjs\"", "timeout": 30000 }]
53
53
  }
54
54
  ],
@@ -329,7 +329,9 @@ var COMMITTING_AGENTS = [
329
329
  "operational-artifact-builder",
330
330
  "cicd-platform-engineer",
331
331
  "python-data-engineer",
332
- "frontend-engineer"
332
+ "frontend-engineer",
333
+ "harness-engineer",
334
+ "ciclo-engineer"
333
335
  ];
334
336
  var PROTECTED_BRANCHES = ["main", "master"];
335
337
  function isCommittingAgent(subagentType) {
@@ -89,6 +89,8 @@ export const COMMITTING_AGENTS: readonly string[] = [
89
89
  'cicd-platform-engineer',
90
90
  'python-data-engineer',
91
91
  'frontend-engineer',
92
+ 'harness-engineer',
93
+ 'ciclo-engineer',
92
94
  ];
93
95
 
94
96
  const PROTECTED_BRANCHES: readonly string[] = ['main', 'master'];
@@ -43,7 +43,9 @@
43
43
  * membership first would make the [ERROR] branch permanently unreachable.
44
44
  *
45
45
  * Canonical agent set (ADR-023 plan ADR-P2, measured empirically S433):
46
- * `packages/definitions/agents/` (28 `.md` files today) — DELIBERATELY NOT
46
+ * `packages/definitions/agents/` (count tracked live in
47
+ * `packages/definitions/manifest.json`, not restated here — D-153 c) —
48
+ * DELIBERATELY NOT
47
49
  * the `AGENTS_DIR = join(PROJECT_ROOT, '.claude', 'agents')` pattern used by
48
50
  * session-start.ts. In THIS repo (ADR-023 dogfood — the
49
51
  * canonical source lives here, nothing is "installed" into `.claude/agents/`)
package/manifest.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schema": "orchestrator-definitions/v1",
3
3
  "namespace": "orchestrator",
4
- "version": "3.37.3",
5
- "generatedAt": "2026-09-21T16:00:20.708Z",
4
+ "version": "3.39.0",
5
+ "generatedAt": "2026-09-24T21:38:08.911Z",
6
6
  "definitions": {
7
7
  "agents": [
8
8
  {
@@ -13,6 +13,14 @@
13
13
  "supersedes": null,
14
14
  "metadata": {}
15
15
  },
16
+ {
17
+ "slug": "agentic-architect",
18
+ "file": "agents/agentic-architect.md",
19
+ "version": "1.0.0",
20
+ "checksum": "sha256:8e59be6bdaddc848db04f161318f9ecb40952341dc1e590a2ced342cd15aa46c",
21
+ "supersedes": null,
22
+ "metadata": {}
23
+ },
16
24
  {
17
25
  "slug": "api-extractor",
18
26
  "file": "agents/api-extractor.md",
@@ -21,11 +29,27 @@
21
29
  "supersedes": null,
22
30
  "metadata": {}
23
31
  },
32
+ {
33
+ "slug": "architecture-mediator",
34
+ "file": "agents/architecture-mediator.md",
35
+ "version": "1.0.0",
36
+ "checksum": "sha256:176ebe88ba97969a00cabdcff609a795911cc94cd5177d43b22b9d673c12b4b8",
37
+ "supersedes": null,
38
+ "metadata": {}
39
+ },
24
40
  {
25
41
  "slug": "azure-devops-engineer",
26
42
  "file": "agents/azure-devops-engineer.md",
27
43
  "version": "1.0.0",
28
- "checksum": "sha256:eaa237e23a18163eb5c2566b9b3b6f6e9a862ffbd2f1be224acb4c9f7d300f54",
44
+ "checksum": "sha256:3086263402a7c6bf05e1d300a698a65a75fd5bc55f3ae1a2fc316872596963f7",
45
+ "supersedes": null,
46
+ "metadata": {}
47
+ },
48
+ {
49
+ "slug": "backend-architect",
50
+ "file": "agents/backend-architect.md",
51
+ "version": "1.0.0",
52
+ "checksum": "sha256:491bded03d17d5a0fcd9314759c1a1d011596f22a9e27c1b3465ee67cf88f11a",
29
53
  "supersedes": null,
30
54
  "metadata": {}
31
55
  },
@@ -41,7 +65,7 @@
41
65
  "slug": "cicd-platform-engineer",
42
66
  "file": "agents/cicd-platform-engineer.md",
43
67
  "version": "1.0.0",
44
- "checksum": "sha256:b539a0e6d2a8e97c91c57f005ef6ddbc0d64f4e482b3d80af0b0afbf80e4e3fe",
68
+ "checksum": "sha256:ae9a48d5392b641eaf033497fac7d6e992e9ad47b31c97f77123112cc9475821",
45
69
  "supersedes": null,
46
70
  "metadata": {}
47
71
  },
@@ -61,6 +85,22 @@
61
85
  "supersedes": null,
62
86
  "metadata": {}
63
87
  },
88
+ {
89
+ "slug": "contract-architect",
90
+ "file": "agents/contract-architect.md",
91
+ "version": "1.0.0",
92
+ "checksum": "sha256:635ca408fe1ae628491ad9cdf0c7b6b05e35dbd03ca8d811ae6b916861e98a4c",
93
+ "supersedes": null,
94
+ "metadata": {}
95
+ },
96
+ {
97
+ "slug": "datamodel-architect",
98
+ "file": "agents/datamodel-architect.md",
99
+ "version": "1.0.0",
100
+ "checksum": "sha256:5ca8eb6cc693f274ca62dd4c9907eb9652d53f94089d393625a734a51bfbb8c6",
101
+ "supersedes": null,
102
+ "metadata": {}
103
+ },
64
104
  {
65
105
  "slug": "debug-sidecar",
66
106
  "file": "agents/debug-sidecar.md",
@@ -85,11 +125,19 @@
85
125
  "supersedes": null,
86
126
  "metadata": {}
87
127
  },
128
+ {
129
+ "slug": "frontend-architect",
130
+ "file": "agents/frontend-architect.md",
131
+ "version": "1.0.0",
132
+ "checksum": "sha256:e2a9c3313852d275eef6f19917960788e3177d7c99d8ca64e51f98444971ce72",
133
+ "supersedes": null,
134
+ "metadata": {}
135
+ },
88
136
  {
89
137
  "slug": "frontend-engineer",
90
138
  "file": "agents/frontend-engineer.md",
91
139
  "version": "1.0.0",
92
- "checksum": "sha256:29201e48691a79b5e535ac8a41df77ac20006f1768214f9d6c63f6e1ff839efc",
140
+ "checksum": "sha256:19f7d49ee83ffc6a5563194236ba25f300711bb063b2013e40ab62d1ddc65c72",
93
141
  "supersedes": null,
94
142
  "metadata": {}
95
143
  },
@@ -97,7 +145,15 @@
97
145
  "slug": "harness-architect",
98
146
  "file": "agents/harness-architect.md",
99
147
  "version": "1.0.0",
100
- "checksum": "sha256:bec6c0cecb552f6265bffcf76288c684968d5fe20fc4b6736e8d55ab25e1622e",
148
+ "checksum": "sha256:e9d32c230d68eaac0377a0f402df3d90e59103551f833aaedb2fbde8e4e20d04",
149
+ "supersedes": null,
150
+ "metadata": {}
151
+ },
152
+ {
153
+ "slug": "harness-engineer",
154
+ "file": "agents/harness-engineer.md",
155
+ "version": "1.0.0",
156
+ "checksum": "sha256:a99f20aee7d6036adaa6beabd577495ca51322487c343b73c89daf6601e2592a",
101
157
  "supersedes": null,
102
158
  "metadata": {}
103
159
  },
@@ -105,7 +161,15 @@
105
161
  "slug": "implementer",
106
162
  "file": "agents/implementer.md",
107
163
  "version": "1.0.0",
108
- "checksum": "sha256:2b31b706bb11ad2d25abb7cbd441a3a0d430d3204338bf4860bade1a8bfab88d",
164
+ "checksum": "sha256:7b9eda703f4dc2c18bec8729ae26836c60f4045f1bf4eccafb27ffa11ce4985b",
165
+ "supersedes": null,
166
+ "metadata": {}
167
+ },
168
+ {
169
+ "slug": "infra-architect",
170
+ "file": "agents/infra-architect.md",
171
+ "version": "1.0.0",
172
+ "checksum": "sha256:fccaf3594c7e63326cf5bd1d2ac78c4e8da58d816cb4a12e9d8fe643cc42b90e",
109
173
  "supersedes": null,
110
174
  "metadata": {}
111
175
  },
@@ -137,7 +201,7 @@
137
201
  "slug": "operational-artifact-builder",
138
202
  "file": "agents/operational-artifact-builder.md",
139
203
  "version": "1.0.0",
140
- "checksum": "sha256:86125998e16e8248defc4aec8fb95eb05ee374083ac756da2391dcf9eca0ec46",
204
+ "checksum": "sha256:05c07e734abcc5f67bee32ff1ac9c0471bc810626e493e4a50f424f103a97fee",
141
205
  "supersedes": null,
142
206
  "metadata": {}
143
207
  },
@@ -169,7 +233,7 @@
169
233
  "slug": "python-data-engineer",
170
234
  "file": "agents/python-data-engineer.md",
171
235
  "version": "1.0.0",
172
- "checksum": "sha256:d0e680f76a3c2aaf799ce7fe88a22e6dc45597e64724fc2c5e44dac159f7660e",
236
+ "checksum": "sha256:20fff6c198c822afbca09017b6f81f2d89b8f50fe289da31aa4355a0dfdc7a5c",
173
237
  "supersedes": null,
174
238
  "metadata": {}
175
239
  },
@@ -201,7 +265,7 @@
201
265
  "slug": "software-architect",
202
266
  "file": "agents/software-architect.md",
203
267
  "version": "1.0.0",
204
- "checksum": "sha256:3b5a609553d85ba0ce1ef4da966a46bd49eca46846c8e84b8263616e9456afda",
268
+ "checksum": "sha256:ea539a68d95e9c1631d110b6d63854f7eee2e2b666a6af66a1396eb1a433f9cc",
205
269
  "supersedes": null,
206
270
  "metadata": {}
207
271
  },
@@ -231,6 +295,30 @@
231
295
  }
232
296
  ],
233
297
  "skills": [
298
+ {
299
+ "slug": "archify",
300
+ "file": "skills/archify/SKILL.md",
301
+ "version": "1.0.0",
302
+ "checksum": "sha256:453c292c0201c03cae2bf1e91c2e4fde1b104bb53b3bda255b4d0004fdd701aa",
303
+ "supersedes": null,
304
+ "metadata": {}
305
+ },
306
+ {
307
+ "slug": "arquitetura-lane-dispatch",
308
+ "file": "skills/arquitetura-lane-dispatch/SKILL.md",
309
+ "version": "1.0.0",
310
+ "checksum": "sha256:783c610f7c59ac069cea73b0bd7ddecf09745a781a43237359242f36fc1a41c2",
311
+ "supersedes": null,
312
+ "metadata": {}
313
+ },
314
+ {
315
+ "slug": "arquitetura-mediada-arquiteto",
316
+ "file": "skills/arquitetura-mediada-arquiteto/SKILL.md",
317
+ "version": "1.0.0",
318
+ "checksum": "sha256:6f77a9ddb673948ae3a53d107df8010a2c7d4b51fa76320e309ddc255b2c44f2",
319
+ "supersedes": null,
320
+ "metadata": {}
321
+ },
234
322
  {
235
323
  "slug": "artifact-generator",
236
324
  "file": "skills/artifact-generator/SKILL.md",
@@ -291,7 +379,7 @@
291
379
  "slug": "checkpoint-protocol",
292
380
  "file": "skills/checkpoint-protocol/SKILL.md",
293
381
  "version": "1.0.0",
294
- "checksum": "sha256:68c5b24b2d306858b5a7a1403cdfd63be59a208e4dd45041f3f4b805936c85ad",
382
+ "checksum": "sha256:6f6b7dd0df5e7b2bf0aaf6a17400166901bf8961b78d3a7e0532a95e7cea0c3c",
295
383
  "supersedes": null,
296
384
  "metadata": {}
297
385
  },
@@ -379,7 +467,7 @@
379
467
  "slug": "orchestrator",
380
468
  "file": "skills/orchestrator/SKILL.md",
381
469
  "version": "1.0.0",
382
- "checksum": "sha256:b7c730f89b80ab3ee4ed55cb3c5f8afca4b74446da6f3960679fdd82d065fac3",
470
+ "checksum": "sha256:a2af61db4b4005af050de4abd33d16c59875d301ebf8f1f382353e76d07ad904",
383
471
  "supersedes": null,
384
472
  "metadata": {}
385
473
  },
@@ -557,7 +645,7 @@
557
645
  "slug": "pre-agent-dispatch",
558
646
  "file": "hooks/pre-agent-dispatch.mjs",
559
647
  "version": "1.0.0",
560
- "checksum": "sha256:e4dfd078aa2a39bfd8a0655e90708e5693b267f7579b538173d20375346c6cfa",
648
+ "checksum": "sha256:ba377dfddebea9b0b9b8287326e0e7b7105845a5b73f78bb18fa8a2293f351e3",
561
649
  "supersedes": null,
562
650
  "metadata": {}
563
651
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@orchestrator-claude/definitions",
3
- "version": "3.37.3",
3
+ "version": "3.39.0",
4
4
  "description": "Built-in definitions (agents, skills, hooks, workflows, KB seeds) for the Orchestrator ecosystem",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 tt-a1i (Archify)
4
+ Copyright (c) 2025 Cocoon AI (original "architecture-diagram-generator")
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.