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.
- package/AI_INSTALL.md +49 -0
- package/CHANGELOG.md +79 -0
- package/GUIA.html +401 -0
- package/LICENSE +21 -0
- package/README.md +240 -2
- package/VERSION +1 -0
- package/bin/omk.js +175 -0
- package/bin/ui.js +165 -0
- package/core/AGENTS.md +80 -0
- package/docs/MANUAL.md +208 -0
- package/install.sh +403 -0
- package/output-styles/csr-minimal.md +14 -0
- package/package.json +23 -4
- package/rules/00-router.md +28 -0
- package/rules/10-communication.md +58 -0
- package/rules/20-clean-code.md +59 -0
- package/rules/30-security.md +81 -0
- package/rules/31-security-audit.md +58 -0
- package/rules/40-testing.md +48 -0
- package/rules/50-done-gate.md +66 -0
- package/rules/60-git-workflow.md +49 -0
- package/rules/70-performance.md +36 -0
- package/rules/75-reliability.md +36 -0
- package/rules/80-supply-chain.md +35 -0
- package/rules/90-docs-comments.md +36 -0
- package/rules/95-multi-agent.md +56 -0
- package/rules/lang/cpp.md +26 -0
- package/rules/lang/csharp.md +27 -0
- package/rules/lang/dart-flutter.md +26 -0
- package/rules/lang/go.md +30 -0
- package/rules/lang/infra.md +33 -0
- package/rules/lang/java.md +29 -0
- package/rules/lang/kotlin.md +25 -0
- package/rules/lang/php.md +27 -0
- package/rules/lang/python.md +33 -0
- package/rules/lang/react.md +32 -0
- package/rules/lang/ruby.md +23 -0
- package/rules/lang/rust.md +32 -0
- package/rules/lang/shell.md +24 -0
- package/rules/lang/sql.md +29 -0
- package/rules/lang/swift.md +31 -0
- package/rules/lang/typescript.md +32 -0
- package/rules/lang/web.md +31 -0
- package/skills/csr-audit/SKILL.md +14 -0
- package/skills/csr-gate/SKILL.md +16 -0
- package/skills/csr-stack/SKILL.md +23 -0
- package/skills/kit-init/SKILL.md +61 -0
- package/skills/orca/SKILL.md +88 -0
- package/skills/orca/references/adapters/artifact.md +32 -0
- package/skills/orca/references/adapters/chat.md +33 -0
- package/skills/orca/references/adapters/native-plan.md +18 -0
- package/skills/orca/references/adapters/plan-file.md +20 -0
- package/skills/orca/references/adapters/speckit.md +42 -0
- package/skills/orca/references/engine-manual.md +30 -0
- package/skills/orca/references/engine-orca.md +36 -0
- package/skills/orca/references/engine-subagents.md +19 -0
- package/skills/orca/references/integrate.md +37 -0
- package/skills/orca/references/plan.md +48 -0
- package/skills/orca/references/race.md +35 -0
- package/skills/orca/references/setup.md +26 -0
- package/skills/orca/references/units.md +44 -0
- package/skills/orca/references/worker-contract.md +49 -0
- package/skills/speckit-orca-implement/SKILL.md +17 -0
- package/speckit-extension/orca/README.md +15 -0
- package/speckit-extension/orca/commands/implement.md +16 -0
- package/speckit-extension/orca/extension.yml +26 -0
- package/templates/.worktreeinclude +4 -0
- package/templates/AGENTS.md +13 -0
- package/templates/CLAUDE.md +4 -0
- package/templates/ORCHESTRATION.md +49 -0
- package/templates/STACK.md +91 -0
- package/templates/claude-settings.json +27 -0
- 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
|
+
}
|