orca-multiagent-kit 0.0.0-stage → 1.2.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 (73) hide show
  1. package/AI_INSTALL.md +49 -0
  2. package/CHANGELOG.md +79 -0
  3. package/GUIA.html +401 -0
  4. package/LICENSE +21 -0
  5. package/README.md +240 -2
  6. package/VERSION +1 -0
  7. package/bin/omk.js +175 -0
  8. package/bin/ui.js +165 -0
  9. package/core/AGENTS.md +80 -0
  10. package/docs/MANUAL.md +208 -0
  11. package/install.sh +403 -0
  12. package/output-styles/csr-minimal.md +14 -0
  13. package/package.json +23 -4
  14. package/rules/00-router.md +28 -0
  15. package/rules/10-communication.md +58 -0
  16. package/rules/20-clean-code.md +59 -0
  17. package/rules/30-security.md +81 -0
  18. package/rules/31-security-audit.md +58 -0
  19. package/rules/40-testing.md +48 -0
  20. package/rules/50-done-gate.md +66 -0
  21. package/rules/60-git-workflow.md +49 -0
  22. package/rules/70-performance.md +36 -0
  23. package/rules/75-reliability.md +36 -0
  24. package/rules/80-supply-chain.md +35 -0
  25. package/rules/90-docs-comments.md +36 -0
  26. package/rules/95-multi-agent.md +56 -0
  27. package/rules/lang/cpp.md +26 -0
  28. package/rules/lang/csharp.md +27 -0
  29. package/rules/lang/dart-flutter.md +26 -0
  30. package/rules/lang/go.md +30 -0
  31. package/rules/lang/infra.md +33 -0
  32. package/rules/lang/java.md +29 -0
  33. package/rules/lang/kotlin.md +25 -0
  34. package/rules/lang/php.md +27 -0
  35. package/rules/lang/python.md +33 -0
  36. package/rules/lang/react.md +32 -0
  37. package/rules/lang/ruby.md +23 -0
  38. package/rules/lang/rust.md +32 -0
  39. package/rules/lang/shell.md +24 -0
  40. package/rules/lang/sql.md +29 -0
  41. package/rules/lang/swift.md +31 -0
  42. package/rules/lang/typescript.md +32 -0
  43. package/rules/lang/web.md +31 -0
  44. package/skills/csr-audit/SKILL.md +14 -0
  45. package/skills/csr-gate/SKILL.md +16 -0
  46. package/skills/csr-stack/SKILL.md +23 -0
  47. package/skills/kit-init/SKILL.md +61 -0
  48. package/skills/orca/SKILL.md +88 -0
  49. package/skills/orca/references/adapters/artifact.md +32 -0
  50. package/skills/orca/references/adapters/chat.md +33 -0
  51. package/skills/orca/references/adapters/native-plan.md +18 -0
  52. package/skills/orca/references/adapters/plan-file.md +20 -0
  53. package/skills/orca/references/adapters/speckit.md +42 -0
  54. package/skills/orca/references/engine-manual.md +30 -0
  55. package/skills/orca/references/engine-orca.md +36 -0
  56. package/skills/orca/references/engine-subagents.md +19 -0
  57. package/skills/orca/references/integrate.md +37 -0
  58. package/skills/orca/references/plan.md +48 -0
  59. package/skills/orca/references/race.md +35 -0
  60. package/skills/orca/references/setup.md +26 -0
  61. package/skills/orca/references/units.md +44 -0
  62. package/skills/orca/references/worker-contract.md +49 -0
  63. package/skills/speckit-orca-implement/SKILL.md +17 -0
  64. package/speckit-extension/orca/README.md +15 -0
  65. package/speckit-extension/orca/commands/implement.md +16 -0
  66. package/speckit-extension/orca/extension.yml +26 -0
  67. package/templates/.worktreeinclude +4 -0
  68. package/templates/AGENTS.md +13 -0
  69. package/templates/CLAUDE.md +4 -0
  70. package/templates/ORCHESTRATION.md +49 -0
  71. package/templates/STACK.md +91 -0
  72. package/templates/claude-settings.json +27 -0
  73. package/templates/orca.yaml +5 -0
@@ -0,0 +1,49 @@
1
+ # ORCHESTRATION.md — Cómo se reparte el trabajo entre agentes
2
+ > La lee la skill `orca` (coordinador) antes de repartir trabajo. Generar o actualizar: «inicializa el proyecto» (`kit-init`).
3
+ > Mantenla corta (≤ ~80 líneas). Complementa a `STACK.md`; no repite sus comandos.
4
+
5
+ ## 0. Autonomía
6
+ - Nivel: semi <!-- manual | semi | auto -->
7
+ - manual: confirmas el plan de rondas, cada ronda y cada merge
8
+ - semi: confirmas el plan de rondas y el merge final (recomendado)
9
+ - auto: solo confirmas el merge final
10
+ - Nunca se mergea a la rama por defecto ni se hace push sin confirmación, en ningún nivel.
11
+
12
+ ## 1. Agentes
13
+ | Capa / área | Agente por defecto | Alternativa | Motivo |
14
+ |---|---|---|---|
15
+ | UI (componentes, páginas, estilos) | | | |
16
+ | API / lógica de servidor | | | |
17
+ | Datos (esquema, migraciones, SQL) | coordinador | — | toca `shared` |
18
+ | Tests E2E / verificación en navegador | | | |
19
+ | Revisión de diffs al integrar | | | segundo proveedor = segunda opinión |
20
+ - Máximo de workers simultáneos: 3
21
+ - Motor preferido: orca | subagents | manual
22
+ - Commits locales de workers: sí | no
23
+
24
+ ## 2. Shared — ficheros que solo toca una unidad por ronda o el coordinador
25
+ ```
26
+ # rutas o globs estrechos, uno por línea
27
+ package.json
28
+ pnpm-lock.yaml
29
+ ```
30
+
31
+ ## 3. Entorno de worktree
32
+ - Dependencias: symlink vía `orca.yaml` (`sharedDirectories`) | `pnpm install` en setup
33
+ - Variables de entorno: `.worktreeinclude` copia → `.env.local` (solo desarrollo)
34
+ - Base de datos: compartida, migra solo una unidad por ronda | una BD/esquema por worktree (`DATABASE_URL=..._<unit>`)
35
+ - `PORT_BASE`: 3100 (worker n usa 3100+n)
36
+ - Setup tras crear worktree (si no lo hace Orca):
37
+ ```
38
+ TODO:
39
+ ```
40
+
41
+ ## 4. Flujo por defecto
42
+ - Entrada habitual: spec-kit | plan por sprints | chat
43
+ - Rama de integración: `feat/<feature>` (nunca directo a la rama por defecto)
44
+ - Quién mergea: coordinador tras "sí" del usuario
45
+
46
+ ## 5. No delegar nunca
47
+ - Migraciones destructivas, cambios de auth/permisos, despliegues, rotación de secretos.
48
+
49
+ ## 6. Última actualización: YYYY-MM-DD
@@ -0,0 +1,91 @@
1
+ # STACK.md — Ficha técnica del proyecto
2
+ > Fuente de verdad del stack. El agente la lee ANTES de tocar nada.
3
+ > Rellena lo que aplique, borra lo que no. Mantenla corta: si crece de ~120 líneas, mueve detalle a `docs/`.
4
+ > Regenerar o actualizar: `/csr-stack`.
5
+
6
+ ## 1. Identidad
7
+ - **Proyecto**:
8
+ - **Qué es** (1 línea):
9
+ - **Tipo**: web | API | CLI | escritorio | móvil | librería | monorepo | datos/ML
10
+ - **Estado**: prototipo | desarrollo | producción
11
+ - **Usuarios y datos**: ¿hay datos personales, dinero o credenciales? sí/no →
12
+ - **Nivel de seguridad objetivo (ASVS)**: L1 | L2 | L3
13
+
14
+ ## 2. Stack
15
+ | Capa | Tecnología | Versión exacta |
16
+ |---|---|---|
17
+ | Lenguaje(s) | | |
18
+ | Runtime | | |
19
+ | Framework | | |
20
+ | UI | | |
21
+ | Base de datos | | |
22
+ | ORM / acceso a datos | | |
23
+ | Gestor de paquetes | | |
24
+ | Build / bundler | | |
25
+ | Tests | | |
26
+ | Lint / format | | |
27
+ | Infra / despliegue | | |
28
+ | CI | | |
29
+
30
+ ## 3. Comandos canónicos (el agente NO debe inventar otros)
31
+ ```
32
+ install :
33
+ dev :
34
+ build :
35
+ test :
36
+ test:watch :
37
+ coverage :
38
+ lint :
39
+ format :
40
+ typecheck :
41
+ sec-scan :
42
+ deps-audit :
43
+ migrate :
44
+ run-app :
45
+ ```
46
+ Si un comando no existe, escribe `N/A` — no lo dejes en blanco.
47
+
48
+ ## 4. Mapa del repo (máx. 12 líneas)
49
+ ```
50
+ src/
51
+ domain/ lógica pura, sin I/O
52
+ ...
53
+ tests/
54
+ ```
55
+
56
+ ## 5. Convenciones del proyecto
57
+ - Estilo de nombres:
58
+ - Estructura de módulos:
59
+ - Manejo de errores:
60
+ - Gestión de estado:
61
+ - Formato de commits:
62
+ - Idioma de código/comentarios/UI:
63
+
64
+ ## 6. Límites y prohibiciones específicas
65
+ - No tocar:
66
+ - No añadir dependencias de:
67
+ - Decisiones cerradas (no reabrir):
68
+ - Restricciones duras del producto (offline, sin nube, presupuesto, plataformas):
69
+
70
+ ## 7. Seguridad del proyecto
71
+ - Datos sensibles que se manejan:
72
+ - Dónde viven los secretos:
73
+ - Modelo de autenticación/autorización:
74
+ - Amenazas principales (3):
75
+ - Auditoría obligatoria en cambios que toquen:
76
+
77
+ ## 8. Rendimiento
78
+ - Presupuestos (latencia, tamaño, memoria, arranque):
79
+ - Puntos calientes conocidos:
80
+
81
+ ## 9. Módulos CSR activos
82
+ Siempre: `20-clean-code`, `30-security`, `50-done-gate`.
83
+ Lenguaje: `lang/…`
84
+ Extra: `40-testing`, `70-performance`, `75-reliability`, `80-supply-chain`, `31-security-audit`
85
+ Desactivados para este proyecto (con motivo):
86
+
87
+ ## 10. Estado actual
88
+ - En curso:
89
+ - Bloqueado por:
90
+ - Deuda técnica conocida:
91
+ - Última actualización de esta ficha: YYYY-MM-DD
@@ -0,0 +1,27 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
+ "permissions": {
4
+ "allow": [
5
+ "Read(**)",
6
+ "Grep(**)",
7
+ "Glob(**)",
8
+ "Bash(git status:*)",
9
+ "Bash(git diff:*)",
10
+ "Bash(git log:*)"
11
+ ],
12
+ "ask": [
13
+ "Bash(git push:*)",
14
+ "Bash(git commit:*)"
15
+ ],
16
+ "deny": [
17
+ "Read(./.env)",
18
+ "Read(./.env.*)",
19
+ "Read(./secrets/**)",
20
+ "Read(./**/*.pem)",
21
+ "Read(./**/*.key)",
22
+ "Bash(rm -rf:*)",
23
+ "Bash(git push --force:*)",
24
+ "Bash(curl:* | bash)"
25
+ ]
26
+ }
27
+ }
@@ -0,0 +1,5 @@
1
+ # Orca: directorios gitignorados que cada worktree comparte (symlink) con el checkout principal.
2
+ # Solo se aplican si existen en el checkout principal Y están en .gitignore. kit-init ajusta esta lista.
3
+ worktree:
4
+ sharedDirectories:
5
+ - node_modules