izanagi-ai 2.3.5 → 2.3.7

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.
package/.manifest CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "izanagi-ai",
3
- "version": "2.3.5",
3
+ "version": "2.3.7",
4
4
  "description": "Izanagi AI - Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering",
5
5
  "author": "Pedro Henrique Sanches Leal",
6
6
  "license": "MIT",
7
7
  "homepage": "https://github.com/pedrohenriquesanchesleal4-debug/izanagi-ai#readme",
8
- "generatedAt": "2026-08-04T15:04:31.097Z",
8
+ "generatedAt": "2026-08-04T15:39:31.673Z",
9
9
  "agents": [
10
10
  {
11
11
  "id": "animation",
@@ -14,7 +14,7 @@ Você é o **Discovery**, o investigador de pré-produção do Izanagi. Sua miss
14
14
  - Visão → Público-alvo → Objetivo/CTA principal → Funcionalidades (priorizadas) → Conteúdo → Tecnologia → Animação/movimento → Estilo visual → Orçamento de tempo/recursos.
15
15
  - Nunca um questionário de 10 itens: uma pergunta por mensagem, com opções concretas quando a resposta for vaga.
16
16
  3. **Pesquise referências** (se o usuário não tiver): use a web (Awwwards, Godly, Land-book, uiprompt, Lapa, GitHub) para achar sites campeões do nicho. **Nunca invente referências/URLs.** Extraia princípios reais: *por que* cada referência funciona.
17
- 4. **Direção criativa**: 2-3 caminhos conceituais com trade-offs explícitos + sua recomendação (STAR: Shape, Time, Audience, Resources, Then design).
17
+ 4. **Direção criativa & Curação de Estilo Visual**: analise e sugira modelos visuais de alto craft (ex: Bento Box Grid, Glassmorphism, Motion-Driven, Cyberpunk UI, Spatial UI, Minimalist Swiss, Aurora UI, Neo-Brutalism, Retro-Futurism) que melhor combinam com o projeto, apresentando 2-3 caminhos conceituais com trade-offs explícitos e sua recomendação.
18
18
  5. **Preview "como ficaria"**: wireframe ASCII das seções, paleta hex, tipografia, componentes-chave, sensação de movimento — tudo em texto, sem código.
19
19
  6. **Confirme o norte** com o usuário (1 pergunta).
20
20
  7. **Gere o prompt rico final**: documento completo, estruturado e copiável para o agente de implementação:
package/AGENTS.md CHANGED
@@ -1,13 +1,13 @@
1
1
  # AGENTS.md — Izanagi AI Framework Reference
2
2
 
3
- > Version 2.3.4
3
+ > Version 2.3.5
4
4
  > Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering
5
5
 
6
6
  ---
7
7
 
8
8
  ## 1. Visão Geral do Framework
9
9
 
10
- Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes: arquitetura em camadas (Decision → Context → Skill → Quality → Reflection → Memory), biblioteca de skills especializadas, 12 agentes pré-definidos e uma **CLI executável (`izanagi`)** publicada no npm (`izanagi-ai`). Este repositório É o framework (não um app que o usa).
10
+ Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes: arquitetura em camadas (Decision → Context → Skill → Quality → Reflection → Memory), biblioteca de skills especializadas, 12 agentes pré-definidos, **Checkpoint & Self-Healing Swarm Engine**, e uma **CLI executável (`izanagi`)** publicada no npm (`izanagi-ai`). Este repositório É o framework (não um app que o usa).
11
11
 
12
12
  ---
13
13
 
@@ -17,8 +17,8 @@ Izanagi AI é um **framework meta** para engenharia de software autônoma orient
17
17
 
18
18
  | Comando | Arquivo | Papel |
19
19
  |---|---|---|
20
- | `/agents` | `.opencode/agent/agents.md` | Orquestrador Multi-Agente (single/multi/auto/swarm) |
21
- | `/discovery` | `agents/discovery-agent.json` | Pré-produção: entrevista, pesquisa web, preview, prompt rico ⭐ começo de projeto novo |
20
+ | `/agents` | `.opencode/agent/agents.md` | Orquestrador Multi-Agente (Concorrente / Swarm / Paralelo) |
21
+ | `/discovery` | `agents/discovery-agent.json` | Pré-produção: entrevista, pesquisa web, preview, prompt rico ⭐ |
22
22
  | `/animation` | `agents/animation-agent.json` | Scrollytelling, 3D WebGL, motion signature |
23
23
  | `/architect` | `agents/architect-agent.json` | System design, Clean Arch, DDD, CQRS, ADRs |
24
24
  | `/senior-engineer` | `agents/senior-engineer-agent.json` | Full-stack, refactoring, código limpo/testável |
@@ -36,7 +36,7 @@ Izanagi AI é um **framework meta** para engenharia de software autônoma orient
36
36
  ## 3. Comandos de Desenvolvimento (ordem importa)
37
37
 
38
38
  ```
39
- npm install # instala deps (self-dependency: package.json depende de "izanagi-ai": "^2.2.7" — não remover)
39
+ npm install # instala deps (self-dependency: package.json depende de "izanagi-ai")
40
40
  npm run build # tsc && node dist/scripts/generate-manifest.js
41
41
  npm run verify # build + teste de instalação em sandbox (passa todos os pack IDs)
42
42
  npm run doctor # node bin/izanagi.js doctor — auditoria de integridade
@@ -46,62 +46,41 @@ npm publish # prepublishOnly roda build; depois: git push
46
46
 
47
47
  **Gotchas críticos:**
48
48
  - `dist/` é gitignored e `bin/izanagi.js` importa de `../dist/cli/index.js` — **rode `npm run build` antes de qualquer comando CLI local**, senão roda código obsoleto ou quebra.
49
- - `doctor` valida: SYSTEM.md/RULES.md, JSONs de agentes e aliases do resolver → targets. Não valida chains dos agentes nem o conteúdo de `.manifest`.
49
+ - `doctor` valida: SYSTEM.md/RULES.md, JSONs de agentes e aliases do resolver → targets.
50
50
  - Não há test runner (sem `npm test`). Verificação = `npm run build` + `npm run verify` + `npm run doctor`.
51
- - CI (`.github/workflows/publish.yml`): roda `build` + `verify` em push/PR; publica no npm em tags `v*`/release (precisa do secret `NPM_TOKEN`).
52
51
  - Padrão de commit do repo: `chore: bump to vX.Y.Z` para bumps e `feat:`/`fix:`/`docs:` descritivos em PT-BR para mudanças.
53
52
 
54
53
  ---
55
54
 
56
55
  ## 4. Estrutura do Framework
57
56
 
58
- - `core/` — 8 engines (.md) + **`skill-resolver.json`** (mapa alias → target; NÃO editar à mão sem validar targets)
57
+ - `core/` — 9 engines (.md, incluindo `checkpoint-healing-engine.md`) + **`skill-resolver.json`** (mapa alias → target)
59
58
  - `agents/` — 12 definições de agentes em JSON (fonte da verdade para o `/agents`)
60
59
  - `skills/` — 79+ skills em `skills/<name>/SKILL.md` (+ `references.md` opcional)
61
- - `architecture/ coding/ database/ devops/ memory/ optimization/ security/ teaching/ testing/` — skills legadas em arquivo único `.md`
62
60
  - `.opencode/agent/` — comandos slash do Opencode
63
- - `src/` — CLI TypeScript (entrypoint: `src/cli/index.ts` → `runCLI`); scripts de release em `src/scripts/`
64
- - `SYSTEM.md` & `RULES.md` — fundação e regras operacionais (carregados via `opencode.json` instructions)
61
+ - `src/` — CLI TypeScript (entrypoint: `src/cli/index.ts` → `runCLI`)
62
+ - `SYSTEM.md` & `RULES.md` — fundação e regras operacionais (Anti-Generic High-Craft & Cinematic UI)
65
63
 
66
64
  ---
67
65
 
68
- ## 5. Skill Resolver como aliases resolvem
66
+ ## 5. Regras de Execução & Autonomia
69
67
 
70
- `core/skill-resolver.json` `aliases: { alias: "categoria/nome" }` (204 aliases). A resolução de um target tenta, em ordem:
71
- 1. arquivo direto (`skills/foo`)
72
- 2. `skills/foo.md`
73
- 3. `skills/foo/SKILL.md`
74
-
75
- **Ao adicionar/remover skill:** edite o resolver (ou rode `node dist/scripts/update-resolver.js` para regenerar aliases de `skills/*`), depois valide com `npm run doctor` — ele acusa alias → target inexistente como warning.
76
-
77
- ---
78
-
79
- ## 6. Gotcha `.agents/` (mascarador de bugs)
80
-
81
- Este repo tem uma pasta `.agents/` (gitignored) que é a instalação local do framework — o CLI (doctor/list/run) **prioriza `.agents/` do cwd** sobre a raiz do repo (`resolveFrameworkRoot`). Consequência prática:
82
- - Se `.agents/` ficar desatualizado em relação à raiz, o `doctor` valida contra o espelho velho e **mascara bugs reais** (ex.: aliases quebrados resolviam só porque o `.agents` tinha arquivos antigos).
83
- - **Sincronize manualmente** mudanças de `skills/`, `core/`, `agents/`, `SYSTEM.md`/`RULES.md` para `.agents/` (não há script de sync — apenas copie os arquivos alterados). Manter raiz e `.agents` idênticos (compare com: `Get-ChildItem -Recurse` e `Compare-Object`).
84
- - `my-project/` na raiz é lixo de teste do instalador (snapshot antigo) — ignorar, não editar.
85
-
86
- ---
87
-
88
- ## 7. `.manifest` (catálogo gerado)
89
-
90
- `.manifest` é **gerado no build** por `src/scripts/generate-manifest.ts` (versão do package.json + 12 agents + 188 skills do resolver, com validação de paths — 0 quebrados ou o build falha). **Não editar à mão**; rodar `npm run build` para regenerar. Incluído no pacote npm como catálogo de consulta.
68
+ - **Execução Paralela Concorrente:** Ative múltiplos agentes especializados simultaneamente para frentes distintas (ex: Database + Senior Engineer + Security + Animation em paralelo).
69
+ - **Pré-instalação de Dependências:** Baixe e instale pacotes necessários (`npm install`) **antes** de criar ou alterar arquivos de código. Nunca espere o usuário fazer.
70
+ - **Ponta a Ponta Autónomo:** Execute tarefas até a conclusão total (planejamento → instalação de deps → código → build/teste) sem pausas desnecessárias.
91
71
 
92
72
  ---
93
73
 
94
- ## 8. Padrão Anti-Generic / High-Craft (Regra de Ouro)
74
+ ## 6. Padrão Anti-Generic / High-Craft & Cinematic UI
95
75
 
96
- Proibido entregar código/design genérico "cara de IA" (templates óbvios, gradientes repetitivos sem propósito, boilerplate), **a menos que o usuário peça explicitamente**.
97
- - Padrão obrigatório: inovação, sofisticação técnica, código limpo, arquitetura refinada.
98
- - Design padrão (quando aplicável): estilo Apple-like futurista, glassmorphism sutil, tipografia precisa, 60fps, micro-interações intencionais.
76
+ Proibido entregar código/design genérico "cara de IA" (templates óbvios, fundos cinzas chapados, cards repetitivos, sem animação).
77
+ - **Obrigatório:** Estética Apple-like / Awwwards-grade (`bg-zinc-950`, glassmorphism, bento grids, tipografia precisa, scrollytelling e micro-interações).
99
78
 
100
79
  ---
101
80
 
102
- ## 9. Release Flow (resumo)
81
+ ## 7. Release Flow (resumo)
103
82
 
104
- 1. `npm run bump:patch` (ou minor/major) — bumpa `package.json`/`package-lock.json` sem tag
105
- 2. `npm run build` — recompila + regenera `.manifest` com a nova versão
106
- 3. Commit (`chore: bump to vX.Y.Z`) + `npm publish` (build roda de novo via prepublishOnly)
107
- 4. `git push` (CI roda build+verify; publish automático via tag/release se configurado)
83
+ 1. `npm run bump:patch` (ou minor/major) — bumpa `package.json`/`package-lock.json`
84
+ 2. `npm run build` — recompila + regenera `.manifest`
85
+ 3. Commit (`chore: bump to vX.Y.Z`) + `npm publish` (build roda via prepublishOnly)
86
+ 4. `git push`
@@ -60,10 +60,10 @@
60
60
  "1. Contexto BRUTO: pergunte 'o que você quer construir?' em 1 linha + contexto atual (projeto existente? stack? prazo?)",
61
61
  "2. Entrevista em camadas — UMA pergunta por vez: visão → público-alvo → objetivo/CTA → funcionalidades (priorizadas) → referências (se não tiver, você pesquisa) → tecnologia → animação/movimento → estilo visual → orçamento de tempo",
62
62
  "3. PESQUISA de referências se necessário: busque sites campeões do nicho (Awwwards, Godly, Land-book, uiprompt, GitHub examples) e extraia princípios reais com URLs — nunca invente",
63
- "4. Direção criativa: 2-3 caminhos conceitais com trade-offs explícitos e uma recomendação",
64
- "5. PREVIEW 'como ficaria': wireframe ASCII das seções, paleta (hex), typografia, componentes-chave, sensação de movimento — em texto, sem código",
63
+ "4. Direção criativa & Curação de Estilo Visual: analise e sugira modelos visuais de alto craft (ex: Bento Box Grid, Glassmorphism, Motion-Driven, Cyberpunk UI, Spatial UI, Minimalist Swiss, Aurora UI, Neo-Brutalism, Retro-Futurism) que melhor combinam com o projeto, apresentando 2-3 caminhos conceituais com trade-offs explícitos e uma recomendação",
64
+ "5. PREVIEW 'como ficaria': wireframe ASCII das seções, paleta (hex), tipografia, componentes-chave, sensação de movimento — em texto, sem código",
65
65
  "6. Confirmação final com o usuário (1 pergunta: 'esse é o norte?')",
66
- "7. GERAR O PROMPT RICO: documento completo e copiável para passar ao agente de implementação (tema, objetivo, público, estrutura, refs com URLs, stack, funcionalidades priorizadas, decisões, critérios de aceite)"
66
+ "7. GERAR O PROMPT RICO: documento completo e copiável para passar ao agente de implementação (tema, objetivo, público, estilo visual escolhido, estrutura, refs com URLs, stack, funcionalidades priorizadas, decisões, critérios de aceite)"
67
67
  ],
68
68
  "always": [
69
69
  "Uma pergunta por vez — entrevista de pré-produção, nunca questionário-descarga",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "izanagi-ai",
3
- "version": "2.3.5",
3
+ "version": "2.3.7",
4
4
  "description": "Izanagi AI - Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.js",