@orchestrator-claude/definitions 3.5.0

package/manifest.json

@@ -0,0 +1,314 @@
+{
+  "schema": "orchestrator-definitions/v1",
+  "namespace": "orchestrator",
+  "version": "3.5.0",
+  "generatedAt": "2026-03-01T18:06:43.074Z",
+  "definitions": {
+    "agents": [
+      {
+        "slug": "api-extractor",
+        "file": "agents/api-extractor.md",
+        "version": "1.0.0",
+        "checksum": "sha256:a01d90808f6470956705edde3906265b54f4a0da80e8802927144238e2af4a2a",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "business-rule-miner",
+        "file": "agents/business-rule-miner.md",
+        "version": "1.0.0",
+        "checksum": "sha256:a08ac6097faa7b6dcdc9afd89f51db7529dd8acde385f946ab715d2c1a11c271",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "code-archaeologist",
+        "file": "agents/code-archaeologist.md",
+        "version": "1.0.0",
+        "checksum": "sha256:06221b1d6323c4a0355f48ec5604ceb6682179782d6412223058fe30514b2db0",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "docs-guardian",
+        "file": "agents/docs-guardian.md",
+        "version": "1.0.0",
+        "checksum": "sha256:7caac803e5dd74b854650fc93ee6504acbed46ebb64d68e2ade3eedbfad9007b",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "implementer",
+        "file": "agents/implementer.md",
+        "version": "1.0.0",
+        "checksum": "sha256:f1818ad825dd7c73d90fea0a2dd8ca98476588ec58cac42324c1c6b23cca2403",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "legacy-discoverer",
+        "file": "agents/legacy-discoverer.md",
+        "version": "1.0.0",
+        "checksum": "sha256:45118f44a07258d133c9324b4336ecf1713c29cb3554628132589098fb1d26e6",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "legacy-synthesizer",
+        "file": "agents/legacy-synthesizer.md",
+        "version": "1.0.0",
+        "checksum": "sha256:0599d2c9d5533d195db0435c8743919fb61cee8290df9cd8ccd71edbdb91f403",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "orchestrator",
+        "file": "agents/orchestrator.md",
+        "version": "1.0.0",
+        "checksum": "sha256:9b4c0d847e1294d3a18322b7dd16633b17104611038796fbcedb3a98fa2514da",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "planner",
+        "file": "agents/planner.md",
+        "version": "1.0.0",
+        "checksum": "sha256:8392b6eaff11d67040ff6d4fd5d76fc093caf424387e663e0af7052ae5af9b9d",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "researcher",
+        "file": "agents/researcher.md",
+        "version": "1.0.0",
+        "checksum": "sha256:25df14a3cc339caf2aca2940d4475584f97d2dc685c99e84dbbff55e367ded0f",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "reviewer",
+        "file": "agents/reviewer.md",
+        "version": "1.0.0",
+        "checksum": "sha256:ef83d8decdd13e1d21cad350c94bc09b4b9c2051c66e19c47c395c1d2e4412ff",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "schema-extractor",
+        "file": "agents/schema-extractor.md",
+        "version": "1.0.0",
+        "checksum": "sha256:3a2f6d1f081a8ad636eeede99a1a4f66af66b519f790a25005fdeabf960160f1",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "specifier",
+        "file": "agents/specifier.md",
+        "version": "1.0.0",
+        "checksum": "sha256:68d524f0a8f680e0712373be10b92fe5a2699fa8174c1be4e94e62568f53d7a6",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "task-generator",
+        "file": "agents/task-generator.md",
+        "version": "1.0.0",
+        "checksum": "sha256:ec84955c201052be7b92276946246595121c4771256231e06ca0f7b43a0954c6",
+        "supersedes": null,
+        "metadata": {}
+      }
+    ],
+    "skills": [
+      {
+        "slug": "artifact-validator",
+        "file": "skills/artifact-validator/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:aa97e6e8b8745f4e79aeaf0e33c19b59d3c1297e25c7f8842656c2fe206c8c56",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "docs-guardian",
+        "file": "skills/docs-guardian/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:30801b7922bb531df87e59e1a23e2d17d7b1747fd4d656fb98f25787024c09b4",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "kb-lookup",
+        "file": "skills/kb-lookup/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:12dc74260da5e9cc0d84bd88400ff6d5d7fcc0d3fc2e4a13ee607f86b4ab3336",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "phase-gate-evaluator",
+        "file": "skills/phase-gate-evaluator/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:2772309ff9f761034198aebb7b367b069095045d88f1545f21927fe3f38a11c9",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "release",
+        "file": "skills/release/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:0349d3efe718dfb6adb0c42d27acb290da1720f556e4e9298bd0135de497a96d",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "smoke-test",
+        "file": "skills/smoke-test/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:3bc41314a7c3b71d50574ffef15bc525cf2870a7c8945481a68cbf00e8e26fda",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "workflow-status",
+        "file": "skills/workflow-status/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:5cfbb02830cea582f23a4435f4b3fd5675724ae099c817f81b536f9ec6e64ece",
+        "supersedes": null,
+        "metadata": {}
+      }
+    ],
+    "hooks": [
+      {
+        "slug": "post-agent-artifact-relay",
+        "file": "hooks/post-agent-artifact-relay.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:05add5f54cd1bf9197697314ea71a3bd31698cd00b195a257356b81ce400884e",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "post-artifact-generate",
+        "file": "hooks/post-artifact-generate.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:891d4be3bf636f482d93473de0e221215a76373f45d6c832f19128864045665b",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "post-implement-validate",
+        "file": "hooks/post-implement-validate.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:1793ad8b9e11a9855bf727d2628a9ab420c7866c511e8027b56bb3f3afe89a25",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "post-phase-checkpoint",
+        "file": "hooks/post-phase-checkpoint.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:26c7d47fbf0692b7724e4fc90140074388b11f26d08d383e598bc2cdbefbfdd9",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "pre-agent-invoke",
+        "file": "hooks/pre-agent-invoke.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:059c2fa044f9cd03fdc15aaee49281eadec4651415f00855ebe5782b44e114ed",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "pre-phase-advance",
+        "file": "hooks/pre-phase-advance.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:ac9d7e98111776f578c613619d875b9d853817448448c64eab3cfcb3f85ba321",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "track-agent-invocation",
+        "file": "hooks/track-agent-invocation.sh",
+        "version": "1.0.0",
+        "checksum": "sha256:35fb736c5f5d2201c7059116e9985c0d7b835b533f0e21969e6fff767ce1847c",
+        "supersedes": null,
+        "metadata": {}
+      }
+    ],
+    "workflows": [
+      {
+        "slug": "bug-fix",
+        "file": "workflows/bug-fix.json",
+        "version": "1.0.0",
+        "checksum": "sha256:787fad52ecfb0c910387706ecb191bed43ef1179e6ef388672d14fefcc9e86d6",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "feature-development",
+        "file": "workflows/feature-development.json",
+        "version": "1.0.0",
+        "checksum": "sha256:6995d95b8e58a4a1c393a6e68d36d68cc75c7dfddbb56ed2c5e3e6ec2767a4fc",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "legacy-analysis",
+        "file": "workflows/legacy-analysis.json",
+        "version": "1.0.0",
+        "checksum": "sha256:603585476d2e4c5db0ad2b3fb8e43797bac4a137d1c9b624b794966b907f22ec",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "refactoring",
+        "file": "workflows/refactoring.json",
+        "version": "1.0.0",
+        "checksum": "sha256:8df38b1039e00cb3ed753acec555cc158e7b3172d8c1261b45b30e0832e274f5",
+        "supersedes": null,
+        "metadata": {}
+      }
+    ],
+    "kb": [
+      {
+        "slug": "auth-strategies",
+        "file": "kb/auth-strategies.md",
+        "version": "1.0.0",
+        "checksum": "sha256:2b9d3e192092a54a5aa7db6984c8538c028c94172d81060281d838f4ebdd37f0",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "docs-constitution",
+        "file": "kb/docs-constitution.md",
+        "version": "1.0.0",
+        "checksum": "sha256:be5c9a1e81a55daf1e82bc37510fdbe5a53a93d35e19c760430ee5b27d5928e4",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "error-handling",
+        "file": "kb/error-handling.md",
+        "version": "1.0.0",
+        "checksum": "sha256:d304b9f6ae7a8c15802d2c484a25125f4efce62bca2077bfc1a5b4fc8d394413",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "rest-conventions",
+        "file": "kb/rest-conventions.md",
+        "version": "1.0.0",
+        "checksum": "sha256:a2b55c48d31f34192b089244b609157bc3d6886ab0e0ca4bbae597b5a923b13f",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "validation-patterns",
+        "file": "kb/validation-patterns.md",
+        "version": "1.0.0",
+        "checksum": "sha256:e94fe67b477a77d9eb78088848c3965a9274115ca7210b358bcedf23384ace69",
+        "supersedes": null,
+        "metadata": {}
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@orchestrator-claude/definitions",
+  "version": "3.5.0",
+  "description": "Built-in definitions (agents, skills, hooks, workflows, KB seeds) for the Orchestrator ecosystem",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest.json": "./manifest.json"
+  },
+  "bin": {
+    "orch-defs": "bin/orch-defs.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "agents",
+    "skills",
+    "hooks",
+    "workflows",
+    "kb",
+    "manifest.json"
+  ],
+  "scripts": {
+    "build": "tsc && npm run generate-manifest",
+    "generate-manifest": "npx tsx src/scripts/generate-manifest.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "chalk": "^5.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "tsx": "^4.21.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "orchestrator",
+    "definitions",
+    "agents",
+    "claude-code",
+    "anthropic"
+  ],
+  "author": "Orchestrator Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orchestratorAII/orchestrator_claude.git",
+    "directory": "packages/definitions"
+  }
+}

package/skills/artifact-validator/SKILL.md

@@ -0,0 +1,226 @@
+---
+name: artifact-validator
+description: Valida artefatos do Orchestrator contra JSON schemas e regras de negocio da CONSTITUTION. Use apos geracao de artefatos (spec, plan, tasks) ou antes de avancar fase.
+allowed-tools: Read, Grep, Glob
+---
+
+# Artifact Validator Skill
+
+## Descricao
+
+Esta skill valida artefatos do sistema de orquestracao contra:
+1. **JSON Schemas**: Estrutura e tipos obrigatorios
+2. **Regras de Negocio**: Definidas na CONSTITUTION.md
+3. **Consistencia**: Referencias internas e dependencias
+
+## Quando Usar
+
+Use esta skill quando:
+- Apos geracao de qualquer artefato (spec, plan, tasks, implementation)
+- Antes de avancar para proxima fase do workflow
+- Quando solicitado revisao de artefato existente
+- Para verificar integridade de artefatos apos edicao
+
+## Invocacao
+
+Exemplos de como invocar esta skill:
+
+```
+"Valide o artefato specification em .orchestrator/artifacts/specify/spec.md"
+
+"Verifique se o plano esta conforme o schema de plan"
+
+"Valide tasks.md contra regras de negocio da CONSTITUTION"
+
+"Faca validacao completa do artefato de implementacao"
+```
+
+## Parametros
+
+| Parametro | Tipo | Obrigatorio | Descricao |
+|-----------|------|-------------|-----------|
+| `artifact_path` | string | Sim | Caminho do artefato a validar |
+| `artifact_type` | enum | Sim | specification, plan, tasks, implementation, research |
+| `validation_level` | enum | Nao | schema (apenas estrutura), business (apenas regras), full (ambos) |
+
+### Valores de validation_level
+
+- **schema**: Valida apenas estrutura JSON/Markdown e campos obrigatorios
+- **business**: Valida apenas regras de negocio da CONSTITUTION
+- **full** (default): Executa ambas validacoes
+
+## Output
+
+A skill retorna resultado estruturado:
+
+```json
+{
+  "isValid": true | false,
+  "validationLevel": "schema" | "business" | "full",
+  "artifactType": "specification",
+  "artifactPath": ".orchestrator/artifacts/specify/spec.md",
+  "timestamp": "2025-12-09T10:30:00Z",
+
+  "schemaValidation": {
+    "passed": true,
+    "errors": [],
+    "warnings": []
+  },
+
+  "businessValidation": {
+    "passed": true,
+    "errors": [],
+    "warnings": [],
+    "rulesChecked": [
+      "CONSTITUTION.rule.001",
+      "CONSTITUTION.rule.002"
+    ]
+  },
+
+  "errors": [
+    {
+      "code": "SCHEMA_001",
+      "field": "requisitos.RF-001.criterio_aceite",
+      "message": "Campo obrigatorio ausente",
+      "severity": "error",
+      "suggestion": "Adicione criterios de aceite verificaveis para RF-001"
+    }
+  ],
+
+  "warnings": [
+    {
+      "code": "BUSINESS_W001",
+      "field": "escopo.out_scope",
+      "message": "Out of scope sem justificativa",
+      "severity": "warning",
+      "suggestion": "Adicione justificativa para cada item out of scope"
+    }
+  ],
+
+  "suggestions": [
+    "Considere adicionar metricas de performance em RNF",
+    "Referencie o research-context se disponivel"
+  ],
+
+  "summary": {
+    "totalErrors": 1,
+    "totalWarnings": 1,
+    "canProceed": false
+  }
+}
+```
+
+## Regras de Validacao
+
+### Schema Validation
+
+#### Specification (spec.md)
+- Campos obrigatorios: metadata, sumario, escopo, requisitos_funcionais
+- Cada RF deve ter: id, descricao, ator, criterio_aceite
+- Cada RNF deve ter: id, metrica, target
+
+#### Plan (plan.md)
+- Campos obrigatorios: metadata, arquitetura, fases, dependencias
+- Cada fase deve ter: id, descricao, entregaveis, estimativa
+- Dependencias devem referenciar fases existentes
+
+#### Tasks (tasks.md)
+- Campos obrigatorios: metadata, backlog, dependencias
+- Cada task deve ter: id, titulo, descricao, criterio_aceite, estimativa
+- Dependencias devem formar DAG (sem ciclos)
+
+#### Implementation
+- Campos obrigatorios: metadata, task_id, arquivos_modificados
+- Cada arquivo deve ter: path, tipo_mudanca, descricao_mudanca
+- task_id deve existir em tasks.md
+
+### Business Validation
+
+Regras extraidas de CONSTITUTION.md:
+
+1. **CONST-001**: Todo requisito deve ter criterio de aceite mensuravel
+2. **CONST-002**: Out of scope deve ter justificativa explicita
+3. **CONST-003**: Estimativas devem estar em unidades padrao (horas/dias)
+4. **CONST-004**: Referencias a outros artefatos devem ser validas
+5. **CONST-005**: Nomes de arquivos devem seguir convencao do projeto
+
+## Integracao com TypeScript
+
+Esta skill invoca o handler TypeScript:
+
+```typescript
+// src/presentation/skills/ArtifactValidatorSkillHandler.ts
+
+export class ArtifactValidatorSkillHandler {
+  async handle(params: ValidationParams): Promise<ValidationResult> {
+    // 1. Carrega artefato do path
+    // 2. Executa SchemaValidator (infrastructure)
+    // 3. Executa ConstitutionValidator (domain)
+    // 4. Combina resultados
+    // 5. Retorna ValidationResult
+  }
+}
+```
+
+## Exemplos de Uso
+
+### Validacao Schema Only
+```
+User: "Valide a estrutura do spec.md"
+Skill: artifact-validator com validation_level=schema
+```
+
+### Validacao Business Only
+```
+User: "Verifique se o plano atende as regras da CONSTITUTION"
+Skill: artifact-validator com validation_level=business
+```
+
+### Validacao Completa (Default)
+```
+User: "Valide completamente o artefato tasks.md"
+Skill: artifact-validator com validation_level=full
+```
+
+## Comportamento em Caso de Erro
+
+### Artefato Nao Encontrado
+```json
+{
+  "isValid": false,
+  "errors": [{
+    "code": "ARTIFACT_NOT_FOUND",
+    "message": "Artefato nao encontrado: {path}"
+  }]
+}
+```
+
+### Tipo Desconhecido
+```json
+{
+  "isValid": false,
+  "errors": [{
+    "code": "UNKNOWN_TYPE",
+    "message": "Tipo de artefato desconhecido: {type}"
+  }]
+}
+```
+
+### Erro de Parse
+```json
+{
+  "isValid": false,
+  "errors": [{
+    "code": "PARSE_ERROR",
+    "message": "Erro ao parsear artefato: {details}"
+  }]
+}
+```
+
+## Notas Importantes
+
+1. Esta skill **NAO** modifica artefatos, apenas valida
+2. Validacao **full** e sempre recomendada antes de avancar fase
+3. Warnings **NAO** impedem avanco, mas devem ser revisados
+4. Errors **IMPEDEM** avanco e devem ser corrigidos
+5. Sugestoes sao opcionais mas melhoram qualidade