orca-multiagent-kit 0.0.0-stage → 1.1.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 +56 -0
- package/GUIA.html +401 -0
- package/LICENSE +21 -0
- package/README.md +238 -2
- package/VERSION +1 -0
- package/bin/omk.js +147 -0
- package/core/AGENTS.md +80 -0
- package/docs/MANUAL.md +208 -0
- package/install.sh +297 -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,26 @@
|
|
|
1
|
+
# C / C++
|
|
2
|
+
**Gates**: `clang-format --dry-run -Werror` · `clang-tidy` · compilar con `-Wall -Wextra -Wpedantic -Werror` (MSVC `/W4 /WX`) · ASan+UBSan en tests · TSan si hay hilos · `cppcheck` · fuzzing
|
|
3
|
+
|
|
4
|
+
## Memoria (origen del 70% de los CVE de este lenguaje)
|
|
5
|
+
- **Cero `new`/`delete`/`malloc` manuales** en código nuevo: `std::unique_ptr`, `std::shared_ptr` solo si la propiedad es realmente compartida, contenedores de la STL.
|
|
6
|
+
- RAII para todo recurso (fichero, socket, lock, handle).
|
|
7
|
+
- Sin aritmética de punteros cruda: `std::span`, `std::string_view`, `.at()` en rutas no calientes.
|
|
8
|
+
- Regla del cero; si defines uno de los cinco especiales, define todos y razona la propiedad.
|
|
9
|
+
- Vigila: desbordamiento de buffer (CWE-787/121/122), lectura fuera de límites (125), use-after-free (416), doble liberación, `string_view`/iterador colgante tras reasignación.
|
|
10
|
+
- Nunca `strcpy`, `sprintf`, `gets`, `atoi`. Usa `snprintf` con tamaño, `std::from_chars`, `std::format`.
|
|
11
|
+
|
|
12
|
+
## Corrección
|
|
13
|
+
- C++ moderno (17/20/23): `constexpr`, `enum class`, `std::optional`, `std::variant`, `std::expected`, algoritmos de `<algorithm>` en vez de bucles a mano.
|
|
14
|
+
- `const` y `noexcept` donde corresponda; `[[nodiscard]]` en funciones cuyo retorno no se puede ignorar.
|
|
15
|
+
- Entero: comprueba desbordamiento (CWE-190) antes de operar; nada de conversión implícita con signo/tamaño distinto; `size_t` para tamaños.
|
|
16
|
+
- Sin comportamiento indefinido "que funciona": UB es un fallo, aunque el binario pase los tests.
|
|
17
|
+
- Inicializa siempre; sin variables no inicializadas.
|
|
18
|
+
|
|
19
|
+
## Concurrencia
|
|
20
|
+
`std::jthread` con `stop_token`, `std::mutex` con `scoped_lock`, orden fijo de bloqueos para evitar deadlock, atómicos solo con modelo de memoria entendido, nada de `volatile` como sincronización. TSan en CI.
|
|
21
|
+
|
|
22
|
+
## Build y dependencias
|
|
23
|
+
CMake moderno (targets, no variables globales), dependencias con vcpkg/Conan y versiones fijadas, `-D_FORTIFY_SOURCE=2`, `-fstack-protector-strong`, PIE y RELRO en binarios distribuidos.
|
|
24
|
+
|
|
25
|
+
## Tests
|
|
26
|
+
GoogleTest o Catch2 · sanitizers activos en la suite · `libFuzzer`/AFL++ en todo parser de entrada externa · Valgrind en CI nocturno · benchmarks con Google Benchmark.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# C# / .NET
|
|
2
|
+
**Gates**: `dotnet format --verify-no-changes` · `dotnet build -warnaserror` · `dotnet test --collect:"XPlat Code Coverage"` · `dotnet list package --vulnerable --include-transitive` · analizadores Roslyn + Security Code Scan
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- `Nullable` habilitado en el proyecto y respetado: sin `!` salvo comentario justificado.
|
|
6
|
+
- `record` para datos inmutables, `readonly struct` para valores pequeños, `required` e `init` en vez de constructores gigantes.
|
|
7
|
+
- `switch` con patrones y comprobación exhaustiva; evita cadenas de `if` sobre el tipo.
|
|
8
|
+
- Excepciones específicas; nunca `catch (Exception)` vacío; `throw;` para conservar el stack (no `throw ex;`).
|
|
9
|
+
- `IDisposable`/`IAsyncDisposable` con `using`. Nada de finalizadores salvo recursos no gestionados.
|
|
10
|
+
|
|
11
|
+
## Async
|
|
12
|
+
- `async` de punta a punta. Prohibido `.Result`, `.Wait()` y `Task.Run` para envolver I/O.
|
|
13
|
+
- `CancellationToken` propagado en toda operación asíncrona pública.
|
|
14
|
+
- `ConfigureAwait(false)` en librerías. `IAsyncEnumerable` para flujos.
|
|
15
|
+
- `HttpClient` vía `IHttpClientFactory` con timeout y Polly para reintentos con backoff.
|
|
16
|
+
|
|
17
|
+
## ASP.NET Core
|
|
18
|
+
Validación en el borde (FluentValidation o DataAnnotations) · autorización por política y por recurso, denegando por defecto · antiforgery activo con cookies · CORS explícito · cabeceras de seguridad · límites de tamaño y rate limiting · problemas devueltos como `ProblemDetails` sin stack · configuración y secretos por `IOptions` y gestor de secretos, nunca en `appsettings.json` del repo.
|
|
19
|
+
|
|
20
|
+
## EF Core
|
|
21
|
+
Consultas LINQ parametrizadas; `FromSqlRaw` solo con parámetros · `AsNoTracking` en lecturas · proyecta a DTO en vez de traer la entidad completa · evita N+1 con `Include` o proyección · paginación obligatoria · migraciones revisadas antes de aplicar.
|
|
22
|
+
|
|
23
|
+
## Seguridad
|
|
24
|
+
`RandomNumberGenerator` (nunca `Random`) · `CryptographicOperations.FixedTimeEquals` · ASP.NET Identity o Argon2/BCrypt para contraseñas · sin `BinaryFormatter` · rutas validadas con `Path.GetFullPath` y comprobación de prefijo.
|
|
25
|
+
|
|
26
|
+
## Tests
|
|
27
|
+
xUnit + FluentAssertions; NSubstitute/Moq solo para dependencias externas; WebApplicationFactory para integración; Testcontainers para BD; Bogus para datos; Stryker.NET para mutación.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Dart / Flutter
|
|
2
|
+
**Gates**: `dart format --set-exit-if-changed .` · `dart analyze --fatal-infos` · `flutter test --coverage` · `flutter build` por plataforma · `dart pub outdated` + auditoría
|
|
3
|
+
|
|
4
|
+
## Dart
|
|
5
|
+
- `analysis_options.yaml` estricto: `strict-casts`, `strict-raw-types`, sin `dynamic` implícito.
|
|
6
|
+
- Null safety real: sin `!` gratuito, sin `late` evitable.
|
|
7
|
+
- `sealed class` + `switch` exhaustivo para estados; `records` y patrones para retornos múltiples.
|
|
8
|
+
- Errores tipados de dominio; `Future` siempre esperado o encadenado (`unawaited` explícito si de verdad no se espera).
|
|
9
|
+
- `const` en todo lo que pueda serlo.
|
|
10
|
+
|
|
11
|
+
## Flutter
|
|
12
|
+
- Widgets pequeños y `const`; separa widget de lógica; nada de lógica de negocio en `build`.
|
|
13
|
+
- `build` debe ser puro y barato: sin I/O, sin construcciones costosas, sin `setState` en cadena.
|
|
14
|
+
- Estados de UI explícitos: cargando, error, vacío, con datos.
|
|
15
|
+
- Listas con `ListView.builder` y claves estables; imágenes con caché y tamaño acotado.
|
|
16
|
+
- Libera `controllers`, `streams`, `listeners` y `AnimationController` en `dispose`.
|
|
17
|
+
- Gestión de estado: la que use el proyecto (Riverpod/Bloc/Provider), pero una sola y coherente.
|
|
18
|
+
|
|
19
|
+
## Seguridad
|
|
20
|
+
- Secretos nunca en el binario ni en `--dart-define` de un repo público; usa `flutter_secure_storage` o Keychain/Keystore.
|
|
21
|
+
- Valida en el backend; el cliente no autoriza. Verificación TLS activa, pinning si aplica.
|
|
22
|
+
- Deep links y datos del portapapeles tratados como entrada no confiable.
|
|
23
|
+
- Ofusca y desactiva logs en release (`kReleaseMode`).
|
|
24
|
+
|
|
25
|
+
## Tests
|
|
26
|
+
Unitarios de dominio sin Flutter · widget tests con `pumpWidget` y `find.byRole`/semántica · golden tests con tolerancia · `integration_test` para recorridos críticos · `mocktail` para dependencias externas.
|
package/rules/lang/go.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Go
|
|
2
|
+
**Gates**: `gofmt -l .` · `go vet ./...` · `golangci-lint run` · `go test -race -cover ./...` · `govulncheck ./...` · `gosec ./...`
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Errores como valores: comprobar **siempre**. `fmt.Errorf("contexto: %w", err)` para envolver; `errors.Is`/`errors.As` para inspeccionar.
|
|
6
|
+
- Nunca `_ = err` salvo comentario justificado. Nunca `panic` en librería; solo en `main` ante estado imposible.
|
|
7
|
+
- Interfaces pequeñas, definidas en el **consumidor**. Acepta interfaces, devuelve structs.
|
|
8
|
+
- Valor cero útil. Constructores solo si hay invariante que mantener.
|
|
9
|
+
- `context.Context` como primer parámetro en toda función que haga I/O; respétalo (`ctx.Done()`), no lo guardes en structs.
|
|
10
|
+
- `defer` para liberar; cuidado con `defer` dentro de bucles.
|
|
11
|
+
|
|
12
|
+
## Concurrencia
|
|
13
|
+
- No lances una goroutine sin saber cómo termina. `errgroup` o `WaitGroup` siempre.
|
|
14
|
+
- Canales para comunicar, mutex para proteger estado. Cierra el canal quien escribe.
|
|
15
|
+
- `go test -race` obligatorio en CI.
|
|
16
|
+
- Timeouts en todo cliente HTTP (`http.Client{Timeout}`), nunca `http.DefaultClient` en producción.
|
|
17
|
+
|
|
18
|
+
## Seguridad
|
|
19
|
+
- `database/sql` con parámetros (`$1`, `?`); nunca `fmt.Sprintf` en SQL.
|
|
20
|
+
- `exec.Command` con argumentos separados; sin shell.
|
|
21
|
+
- `crypto/rand` para aleatoriedad; `subtle.ConstantTimeCompare`; `golang.org/x/crypto/argon2` para contraseñas.
|
|
22
|
+
- `html/template` (escapa) y no `text/template` para HTML.
|
|
23
|
+
- Límite de tamaño en `io.Copy`/body (`http.MaxBytesReader`), timeouts de servidor (`ReadHeaderTimeout`).
|
|
24
|
+
- Rutas: `filepath.Clean` + comprobación de prefijo; `os.Root` o `http.Dir` con cuidado.
|
|
25
|
+
|
|
26
|
+
## Rendimiento
|
|
27
|
+
`pprof` y `go test -bench -benchmem` antes de optimizar. Preasigna slices con capacidad conocida. Evita copias grandes; punteros cuando el struct pesa. `strings.Builder` para concatenar.
|
|
28
|
+
|
|
29
|
+
## Tests
|
|
30
|
+
Table-driven con subtests, `t.Parallel` cuando sea seguro, `httptest` para servidores, `testing/fstest`, fuzzing con `go test -fuzz`. Sin dependencias de red en unitarios.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Infraestructura: Docker, Kubernetes, Terraform, CI, YAML
|
|
2
|
+
**Gates**: `hadolint` · `trivy fs .` y `trivy image` · `checkov -d .` · `tfsec` · `terraform validate` + `plan` revisado · `kube-score`/`kubeconform` · `actionlint` · `yamllint`
|
|
3
|
+
|
|
4
|
+
## Docker
|
|
5
|
+
- Imagen base mínima y **fijada por digest** (`node:22-alpine@sha256:...`); multi-stage para no arrastrar herramientas de build.
|
|
6
|
+
- `USER` no root, sistema de ficheros de solo lectura cuando se pueda, `--cap-drop ALL`.
|
|
7
|
+
- Sin secretos en `ENV`, ni en argumentos de build, ni en capas intermedias (quedan en el historial). Usa montajes de secreto de BuildKit.
|
|
8
|
+
- `.dockerignore` que excluya `.git`, `.env`, `node_modules`, artefactos.
|
|
9
|
+
- `HEALTHCHECK` definido; señales gestionadas (`exec` form de `CMD`, init si hace falta reaper de zombies).
|
|
10
|
+
- Escaneo de la imagen antes de publicar; reconstruye para recoger parches de la base.
|
|
11
|
+
|
|
12
|
+
## Kubernetes
|
|
13
|
+
- `requests` y `limits` en todo contenedor; `livenessProbe` y `readinessProbe` distintas.
|
|
14
|
+
- `securityContext`: `runAsNonRoot`, `readOnlyRootFilesystem`, `allowPrivilegeEscalation: false`, `seccompProfile: RuntimeDefault`.
|
|
15
|
+
- NetworkPolicy por defecto denegando; ServiceAccount dedicada con RBAC mínimo; sin `cluster-admin`.
|
|
16
|
+
- Secretos por gestor externo (External Secrets, Vault, SOPS); nunca en el repo ni en `ConfigMap`.
|
|
17
|
+
- `PodDisruptionBudget`, estrategia de despliegue y rollback definidos; sin `latest` como tag.
|
|
18
|
+
|
|
19
|
+
## Terraform / IaC
|
|
20
|
+
- Estado remoto con bloqueo y cifrado; nunca estado local en equipo compartido.
|
|
21
|
+
- Versiones fijadas de proveedores y módulos; `plan` revisado por humano antes de `apply`; `apply` automático solo con aprobación.
|
|
22
|
+
- Sin secretos en variables planas ni en el estado si se puede evitar; marca `sensitive`.
|
|
23
|
+
- Principio de mínimo privilegio en IAM: nada de `*:*`. Cifrado en reposo y en tránsito por defecto. Logs y auditoría activados.
|
|
24
|
+
- Etiquetado consistente (dueño, entorno, coste) y entornos separados por cuenta o proyecto.
|
|
25
|
+
|
|
26
|
+
## CI/CD
|
|
27
|
+
- Acciones de terceros ancladas por SHA; permisos del token mínimos; sin secretos accesibles desde PR de forks.
|
|
28
|
+
- Gates bloqueantes: format, lint, typecheck, build, test, cobertura, `gitleaks`, SAST, auditoría de dependencias.
|
|
29
|
+
- Construcción reproducible, artefactos con checksum o firma, SBOM en release.
|
|
30
|
+
- Despliegue con rollback de un paso y salud verificada tras el cambio.
|
|
31
|
+
|
|
32
|
+
## YAML
|
|
33
|
+
Indentación de 2 espacios, sin tabuladores · comilla las cadenas ambiguas (`yes`, `no`, `on`, versiones como `1.10`) · sin anclas crípticas · valida contra esquema cuando exista.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Java (y Spring Boot / Quarkus)
|
|
2
|
+
**Gates**: `mvn -q verify` o `gradle check` · Spotless/Checkstyle · SpotBugs + find-sec-bugs · `mvn dependency-check` u OSV · JaCoCo con umbral
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Java moderno: `record` para datos, `sealed` + `switch` con patrones para jerarquías cerradas, `var` solo cuando el tipo es evidente, text blocks.
|
|
6
|
+
- Inmutabilidad por defecto: campos `final`, colecciones `List.of`/`Map.copyOf`, sin setters en objetos de dominio.
|
|
7
|
+
- `Optional` como tipo de retorno; nunca como parámetro ni como campo. Nunca devolver `null` en API pública.
|
|
8
|
+
- Excepciones: comprobadas para fallos recuperables del dominio, no comprobadas para errores de programación. Nunca `catch (Exception e) {}`. Conserva la causa.
|
|
9
|
+
- Inyección por constructor, no por campo. Sin `static` mutable.
|
|
10
|
+
- `try-with-resources` para todo `Closeable`. `equals`/`hashCode` coherentes.
|
|
11
|
+
|
|
12
|
+
## Spring / Quarkus
|
|
13
|
+
- Capas: controlador (validación y mapeo) → servicio (negocio, transacciones) → repositorio. Sin entidades JPA en la API pública: usa DTO.
|
|
14
|
+
- `@Transactional` en el servicio, con el alcance mínimo; sin llamadas remotas dentro de la transacción.
|
|
15
|
+
- Validación con Bean Validation en el borde (`@Valid`).
|
|
16
|
+
- Seguridad: autorización por método/endpoint (`@PreAuthorize`), denegar por defecto, CSRF activo si hay sesión por cookie, CORS explícito, actuator restringido.
|
|
17
|
+
- Configuración externalizada; secretos en el gestor, nunca en `application.yml` del repo.
|
|
18
|
+
|
|
19
|
+
## JPA
|
|
20
|
+
`FetchType.LAZY` por defecto; evita N+1 con `join fetch` o `EntityGraph`; paginación siempre; consultas con parámetros nombrados, nunca concatenadas; `@Version` para bloqueo optimista; migraciones con Flyway/Liquibase, jamás `ddl-auto=update` en producción.
|
|
21
|
+
|
|
22
|
+
## Seguridad
|
|
23
|
+
`PreparedStatement` siempre · sin deserialización Java de datos externos · `SecureRandom` · BCrypt/Argon2 para contraseñas · `MessageDigest.isEqual` para comparar · parser XML con entidades externas desactivadas · límites de tamaño de petición.
|
|
24
|
+
|
|
25
|
+
## Concurrencia
|
|
26
|
+
Prefiere inmutabilidad y `ExecutorService`/virtual threads a hilos manuales. `ConcurrentHashMap` en vez de sincronizar a mano. Nada de bloqueo dentro de secciones críticas. Timeouts en todo cliente.
|
|
27
|
+
|
|
28
|
+
## Tests
|
|
29
|
+
JUnit 5 + AssertJ; Mockito solo para colaboradores externos; Testcontainers para BD y colas; `@SpringBootTest` solo en pruebas de integración reales; ArchUnit para reglas de arquitectura; jqwik para propiedades; PIT para mutación.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Kotlin (JVM, Android, KMP)
|
|
2
|
+
**Gates**: `ktlint`/`spotless` · `detekt` · `./gradlew build` con warnings como error · `./gradlew test connectedCheck` · `lint` de Android · OSV/Dependabot
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Nulabilidad real: sin `!!`, sin `lateinit` evitable, sin `platform types` sin anotar. `?.`, `?:` y `requireNotNull` con mensaje.
|
|
6
|
+
- `data class` para datos, `sealed interface` + `when` exhaustivo para estados, `value class` para identificadores.
|
|
7
|
+
- Inmutabilidad: `val` por defecto, `List` en vez de `MutableList` en APIs públicas.
|
|
8
|
+
- Funciones de extensión con criterio; nada de extensiones sobre tipos del framework que confundan.
|
|
9
|
+
- Errores: `Result` o tipo sellado de dominio; excepciones para lo excepcional. Nunca `catch (e: Exception) {}`.
|
|
10
|
+
|
|
11
|
+
## Corrutinas
|
|
12
|
+
- `suspend` para I/O; `Dispatchers.IO` para bloqueo; nunca bloquear el hilo principal.
|
|
13
|
+
- Concurrencia estructurada: alcance con ciclo de vida (`viewModelScope`, `lifecycleScope`), nada de `GlobalScope`.
|
|
14
|
+
- Cancelación cooperativa: comprueba `isActive`, usa `withTimeout`, limpia en `finally` con `NonCancellable` solo si es imprescindible.
|
|
15
|
+
- `Flow` frío para flujos; `StateFlow`/`SharedFlow` para estado; `flowOn` para cambiar de contexto; sin `collect` sin alcance.
|
|
16
|
+
|
|
17
|
+
## Android
|
|
18
|
+
- Estado de UI inmutable expuesto desde el ViewModel; eventos de una sola vez por canal, no por estado.
|
|
19
|
+
- Sin lógica ni claves en `Activity`/`Composable`. Nada de secretos en el APK ni en `strings.xml`.
|
|
20
|
+
- Permisos mínimos y justificados; `EncryptedSharedPreferences`/Keystore para datos sensibles; `usesCleartextTraffic=false`; certificate pinning si aplica.
|
|
21
|
+
- Compose: estado elevado, `remember` con claves correctas, `key` estable en listas, evita recomposición por lambdas nuevas, `derivedStateOf` cuando toca.
|
|
22
|
+
- Exporta componentes solo si es necesario; valida los `Intent` recibidos; `PendingIntent` inmutable.
|
|
23
|
+
|
|
24
|
+
## Tests
|
|
25
|
+
JUnit5 + Turbine para `Flow` · `kotlinx-coroutines-test` con dispatcher controlado · MockK para dependencias externas · Robolectric/Compose UI tests para pantallas · Testcontainers en backend Ktor/Spring.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# PHP (y Laravel / Symfony)
|
|
2
|
+
**Gates**: `php-cs-fixer fix --dry-run` (PSR-12) · `phpstan analyse --level=max` o Psalm · `phpunit --coverage-text` · `composer audit` · `psalm --taint-analysis`
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- `declare(strict_types=1)` en todos los ficheros. Tipos en parámetros, retornos y propiedades.
|
|
6
|
+
- `readonly` y objetos de valor para datos; enums nativos en vez de constantes sueltas.
|
|
7
|
+
- Excepciones de dominio propias; nunca `@` para silenciar errores; nunca `die`/`exit` en código de librería.
|
|
8
|
+
- Composer con `composer.lock` commiteado y autoload PSR-4. Sin `require` de rutas dinámicas.
|
|
9
|
+
|
|
10
|
+
## Seguridad
|
|
11
|
+
- SQL: PDO con sentencias preparadas y `PDO::ATTR_EMULATE_PREPARES => false`. Eloquent/Doctrine con binding; nunca concatenar.
|
|
12
|
+
- XSS: escapa en la plantilla (`{{ }}` de Blade/Twig escapa; `{!! !!}` y `|raw` prohibidos salvo sanitizado explícito).
|
|
13
|
+
- Nunca `eval`, `extract`, `unserialize` sobre datos externos (usa JSON), ni `include` con variable del usuario.
|
|
14
|
+
- `password_hash`/`password_verify` (Argon2id si está disponible); `random_bytes` para tokens; `hash_equals` para comparar.
|
|
15
|
+
- CSRF activo en todo formulario; sesión con cookie `httponly`, `secure`, `samesite`; regenerar id al iniciar sesión.
|
|
16
|
+
- Subida de ficheros: comprobar tipo real, renombrar, guardar fuera del webroot, sin permisos de ejecución.
|
|
17
|
+
- Producción: `display_errors=Off`, `expose_php=Off`, `open_basedir` si aplica, dependencias sin CVE.
|
|
18
|
+
|
|
19
|
+
## Laravel
|
|
20
|
+
- Validación con Form Request; autorización con Policies (denegar por defecto) en cada acción.
|
|
21
|
+
- Sin asignación masiva ciega: `$fillable` explícito, nunca `$guarded = []`.
|
|
22
|
+
- Evita N+1 con `with()`; activa `Model::preventLazyLoading()` en desarrollo.
|
|
23
|
+
- Colas para trabajo lento; jobs idempotentes. Migraciones reversibles.
|
|
24
|
+
- `.env` fuera del repo; `php artisan config:cache` en despliegue.
|
|
25
|
+
|
|
26
|
+
## Tests
|
|
27
|
+
PHPUnit o Pest · factories para datos · base de datos en transacción o contenedor efímero · Infection para mutación · tests de autorización por cada endpoint protegido.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Python
|
|
2
|
+
**Gates**: `ruff format --check .` · `ruff check .` · `mypy --strict` · `pytest -q --cov` · `bandit -r src` · `pip-audit`
|
|
3
|
+
|
|
4
|
+
## Estilo y tipos
|
|
5
|
+
- PEP 8 vía Ruff. Anotaciones de tipo en todo lo público.
|
|
6
|
+
- `mypy --strict` como objetivo; `# type: ignore[codigo]` solo con motivo en la misma línea.
|
|
7
|
+
- Datos: `dataclass(frozen=True, slots=True)` o Pydantic v2. `Protocol` para interfaces. `Enum`/`Literal` en vez de strings sueltos.
|
|
8
|
+
- Nunca argumentos por defecto mutables. Nunca estado global mutable.
|
|
9
|
+
|
|
10
|
+
## Idiomas
|
|
11
|
+
- Comprensiones para transformar; generadores para volumen (memoria constante).
|
|
12
|
+
- `with` para todo recurso. `pathlib` en vez de `os.path`. `enumerate` y `zip` en vez de índices.
|
|
13
|
+
- Excepciones específicas y jerarquía de dominio propia. `raise ... from e`. Nunca `except:` desnudo ni `except Exception: pass`.
|
|
14
|
+
- `logging` con logger por módulo; nunca `print` en librería.
|
|
15
|
+
- Dependencias con `uv` o Poetry y lockfile; `pyproject.toml` como única fuente.
|
|
16
|
+
|
|
17
|
+
## Seguridad
|
|
18
|
+
- SQL parametrizado o SQLAlchemy; nunca f-strings en consultas.
|
|
19
|
+
- `subprocess.run([...])` sin shell; nunca `os.system`.
|
|
20
|
+
- Nunca `eval`, `exec` ni `pickle.loads` sobre datos externos. `yaml.safe_load`. `defusedxml` para XML.
|
|
21
|
+
- `secrets` para tokens, `hmac.compare_digest` para comparar, `argon2-cffi` o `bcrypt` para contraseñas. `random` nunca en seguridad.
|
|
22
|
+
- `requests`/`httpx`: `timeout` obligatorio, verificación TLS activa, redirecciones controladas.
|
|
23
|
+
- Rutas del usuario: resolver a absoluto y comprobar que cuelgan del directorio base.
|
|
24
|
+
- Django/Flask/FastAPI: `DEBUG` desactivado en producción, `SECRET_KEY` fuera del código, ORM sin `raw`, permisos comprobados por vista.
|
|
25
|
+
|
|
26
|
+
## Asincronía
|
|
27
|
+
No mezclar bloqueo con `asyncio`: `asyncio.to_thread` o ejecutor. `asyncio.timeout` en toda espera externa. `TaskGroup` en vez de tareas sueltas sin supervisión.
|
|
28
|
+
|
|
29
|
+
## Rendimiento
|
|
30
|
+
Perfila con `cProfile` o `py-spy` antes de tocar nada. `"".join` en vez de concatenar en bucle. `set`/`dict` para pertenencia. NumPy/Polars cuando hay volumen.
|
|
31
|
+
|
|
32
|
+
## Tests
|
|
33
|
+
`pytest` con fixtures, `parametrize` para tablas de casos, `hypothesis` para propiedades, `freezegun` para tiempo, `respx`/`responses` para HTTP, `pytest-cov` con umbral, `mutmut` en dominio crítico.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# React / Next.js
|
|
2
|
+
**Gates**: `eslint` con `react-hooks` y `jsx-a11y` · `tsc --noEmit` · Testing Library · Playwright · Lighthouse
|
|
3
|
+
|
|
4
|
+
## Componentes
|
|
5
|
+
- Función pura de props a UI. La lógica no visual vive en hooks propios o módulos de dominio.
|
|
6
|
+
- Extrae cuando el JSX pasa de ~80 líneas o mezcla dos conceptos.
|
|
7
|
+
- Props tipadas y explícitas; sin spread ciego sobre elementos del DOM.
|
|
8
|
+
- `key` estable y única; nunca el índice si la lista se reordena o filtra.
|
|
9
|
+
|
|
10
|
+
## Estado y efectos
|
|
11
|
+
- Menos estado posible: deriva en el render en vez de duplicar. Estado del servidor en TanStack Query/SWR, no en `useState`.
|
|
12
|
+
- `useEffect` solo para sincronizar con sistemas externos. No para transformar datos, ni para responder a eventos de usuario.
|
|
13
|
+
- Dependencias completas y honestas; nunca silenciar la regla del linter.
|
|
14
|
+
- Toda suscripción, timer o listener se limpia en el retorno del efecto.
|
|
15
|
+
- Estados de UI obligatorios: cargando, error, vacío y con datos. Los cuatro.
|
|
16
|
+
|
|
17
|
+
## Rendimiento
|
|
18
|
+
- Mide con el Profiler antes de memoizar. `useMemo`/`useCallback`/`memo` solo con causa medida.
|
|
19
|
+
- Re-render típico: objeto, array o función nueva en props. Saca las constantes fuera del componente.
|
|
20
|
+
- Listas largas virtualizadas; rutas con `lazy` + `Suspense`; imágenes dimensionadas y diferidas.
|
|
21
|
+
|
|
22
|
+
## Seguridad
|
|
23
|
+
- `dangerouslySetInnerHTML` prohibido salvo con sanitizador y comentario.
|
|
24
|
+
- Nunca secretos en el bundle ni en variables `NEXT_PUBLIC_*`.
|
|
25
|
+
- Server actions y route handlers: validar entrada y autorizar en servidor siempre; ocultar un botón no es control de acceso.
|
|
26
|
+
- Vigila filtrar datos del servidor al cliente vía props de componentes cliente.
|
|
27
|
+
|
|
28
|
+
## Accesibilidad
|
|
29
|
+
HTML semántico antes que `div` con `onClick`. Etiqueta asociada a cada control. Foco visible y orden lógico. Modal con trampa de foco y cierre con `Esc`. `aria-*` solo si el elemento nativo no basta. Contraste AA. Detalle en `lang/web.md`.
|
|
30
|
+
|
|
31
|
+
## Tests
|
|
32
|
+
Consultas por rol y texto accesible, no por clase CSS. MSW para red. Un E2E por recorrido crítico.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Ruby (y Rails)
|
|
2
|
+
**Gates**: `rubocop` · `srb tc` o RBS/Steep si hay tipos · `rspec` con cobertura (SimpleCov) · `brakeman` · `bundler-audit check --update`
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Métodos cortos; `guard clauses` en vez de anidar. Sin `unless` con `else`.
|
|
6
|
+
- Objetos de valor y `Struct`/`Data` para datos; `freeze` en constantes.
|
|
7
|
+
- Excepciones específicas; nunca `rescue => e` genérico sin relanzar; nunca `rescue nil`.
|
|
8
|
+
- Sin monkey patching de clases del core ni de gemas; si es inevitable, en un refinement documentado.
|
|
9
|
+
- `Enumerable` antes que bucles manuales; cuidado con cargar colecciones enteras en memoria.
|
|
10
|
+
|
|
11
|
+
## Rails
|
|
12
|
+
- Modelo gordo no: lógica de negocio en objetos de servicio o de dominio; el modelo mantiene invariantes y consultas.
|
|
13
|
+
- Strong parameters siempre; nunca `params.permit!`.
|
|
14
|
+
- Autorización explícita por acción (Pundit/CanCan), denegando por defecto; comprueba propiedad del recurso.
|
|
15
|
+
- Evita N+1 con `includes`; usa `bullet` en desarrollo; paginación obligatoria.
|
|
16
|
+
- Consultas: parámetros de Active Record; nunca interpolar en `where("... #{}")`.
|
|
17
|
+
- Vistas: escapado por defecto; `html_safe` y `raw` prohibidos sobre datos del usuario.
|
|
18
|
+
- `has_secure_password` (BCrypt) o Argon2; `SecureRandom` para tokens; credenciales cifradas de Rails, nunca en el repo.
|
|
19
|
+
- Migraciones reversibles; índices con la migración; `strong_migrations` para cambios peligrosos en caliente.
|
|
20
|
+
- Jobs idempotentes con reintentos acotados.
|
|
21
|
+
|
|
22
|
+
## Tests
|
|
23
|
+
RSpec o Minitest · factories (FactoryBot) con datos mínimos · `request specs` sobre controladores · VCR/WebMock para HTTP externo · un test de autorización por endpoint protegido · sin `sleep` en tests de sistema.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Rust
|
|
2
|
+
**Gates**: `cargo fmt --check` · `cargo clippy --all-targets --all-features -- -D warnings` · `cargo test` · `cargo build --locked --release` · `cargo audit` · `cargo deny check` · `cargo llvm-cov`
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Errores: `thiserror` en librería, `anyhow` en binario. `?` para propagar, `.context(...)` para contexto.
|
|
6
|
+
- Prohibido en producción: `unwrap()`, `expect()`, `panic!`, indexado sin comprobar; salvo comentario `// INVARIANT:` que demuestre que no puede fallar. En tests, libre.
|
|
7
|
+
- Tipos que impiden estados inválidos: newtype (`struct UserId(Uuid)`), enum en vez de booleanos, `NonZeroU32`, typestate.
|
|
8
|
+
- Préstamos antes que clones. `&str`/`&[T]` en parámetros, tipo propio en retorno. `Cow<str>` si dudas.
|
|
9
|
+
- Iteradores en vez de índices. `collect::<Result<Vec<_>, _>>()` para propagar en lote.
|
|
10
|
+
- Traits pequeños, `impl Trait` en argumentos, genéricos solo con más de un tipo real.
|
|
11
|
+
- `#[must_use]` en constructores; `#[non_exhaustive]` en enums de error públicos.
|
|
12
|
+
|
|
13
|
+
## Seguridad
|
|
14
|
+
- `unsafe`: prohibido salvo necesidad demostrada; bloque mínimo con `// SAFETY:` justificando cada invariante; testear con Miri.
|
|
15
|
+
- Aritmética: `checked_*` / `saturating_*` / `wrapping_*` explícito donde pueda desbordar (release no comprueba overflow).
|
|
16
|
+
- Cripto: RustCrypto (`aes-gcm`, `chacha20poly1305`), `argon2`, `rand::rngs::OsRng`; `zeroize` para claves y contraseñas.
|
|
17
|
+
- SQL: `sqlx` con macros verificadas en compilación, o `rusqlite` con parámetros nombrados. Nunca `format!` en SQL.
|
|
18
|
+
- Serde en entrada externa: `#[serde(deny_unknown_fields)]` y límites de tamaño.
|
|
19
|
+
- `cargo deny` para licencias, duplicados y avisos de seguridad.
|
|
20
|
+
|
|
21
|
+
## Async
|
|
22
|
+
- Un solo runtime. No bloquear el executor: `spawn_blocking` para CPU o I/O sincrónica.
|
|
23
|
+
- `tokio::time::timeout` en toda operación de red. Cuidado con cancelación: estado a medias al soltar un future.
|
|
24
|
+
- Canales y propiedad antes que `Arc<Mutex<T>>`.
|
|
25
|
+
|
|
26
|
+
## Tauri (si aplica)
|
|
27
|
+
- Capabilities al mínimo, CSP estricta, sin `shell.open` con entrada del usuario.
|
|
28
|
+
- Claves y material criptográfico **solo** en el core Rust; el frontend invoca comandos tipados y nunca ve una clave.
|
|
29
|
+
- Todo argumento que llega del WebView es entrada no confiable: validar en Rust.
|
|
30
|
+
|
|
31
|
+
## Tests
|
|
32
|
+
Unitarios en `#[cfg(test)]`, integración en `tests/`. `proptest` para invariantes, `cargo fuzz` en parsers, `insta` para snapshots, `criterion` para benchmarks, `cargo-mutants` en dominio crítico.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Shell (Bash) y PowerShell
|
|
2
|
+
**Gates**: `shellcheck -S style` · `shfmt -d` · `Invoke-ScriptAnalyzer` · ejecución en seco (`--dry-run`) antes de la real
|
|
3
|
+
|
|
4
|
+
## Bash
|
|
5
|
+
- Cabecera obligatoria: `#!/usr/bin/env bash` y `set -Eeuo pipefail`; `IFS=$'\n\t'` si iteras texto.
|
|
6
|
+
- **Comilla todo**: `"$var"`, `"$@"`, `"${array[@]}"`. Sin comillas = bug de espacios y de globbing.
|
|
7
|
+
- `trap 'cleanup' EXIT INT TERM` para temporales; `mktemp -d` para directorios de trabajo.
|
|
8
|
+
- Comprueba dependencias al inicio (`command -v jq >/dev/null || exit 1`) y valida los argumentos.
|
|
9
|
+
- Nunca `eval`. Nunca `curl ... | bash`. Nunca rutas relativas asumidas: calcula el directorio del script.
|
|
10
|
+
- Nada de parsear `ls`; usa globs o `find -print0` con `read -d ''`.
|
|
11
|
+
- `rm -rf` solo sobre ruta construida y verificada (comprueba que no está vacía y que cuelga de la base esperada).
|
|
12
|
+
- Salida: errores a `stderr`, código de salida significativo, mensajes sin secretos.
|
|
13
|
+
|
|
14
|
+
## PowerShell
|
|
15
|
+
- `Set-StrictMode -Version Latest` y `$ErrorActionPreference = 'Stop'`.
|
|
16
|
+
- Verbo-Sustantivo aprobado, `[CmdletBinding()]`, `SupportsShouldProcess` con `-WhatIf` en cualquier función destructiva.
|
|
17
|
+
- Parámetros tipados con validación (`[ValidateSet]`, `[ValidateNotNullOrEmpty]`).
|
|
18
|
+
- `try/catch/finally` con excepciones tipadas; nunca `-ErrorAction SilentlyContinue` para tapar un fallo.
|
|
19
|
+
- Secretos: `SecureString`/`PSCredential` o gestor externo; nunca en texto plano ni en el historial de consola.
|
|
20
|
+
- Nunca `Invoke-Expression` con entrada externa. Llama binarios con `&` y array de argumentos.
|
|
21
|
+
- No uses `New-Item -Force` sobre un fichero existente: trunca.
|
|
22
|
+
|
|
23
|
+
## Ambos
|
|
24
|
+
Scripts idempotentes · `--help` y modo verboso · sin rutas absolutas de tu máquina · sin credenciales en línea de comandos (aparecen en la tabla de procesos) · registra lo que hace antes de hacerlo si es destructivo.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# SQL y bases de datos
|
|
2
|
+
**Gates**: linter SQL (sqlfluff) · `EXPLAIN ANALYZE` en consultas nuevas · migración aplicada y revertida en entorno efímero · revisión de índices
|
|
3
|
+
|
|
4
|
+
## Seguridad
|
|
5
|
+
- **Siempre parametrizado**. Identificadores dinámicos (tabla, columna, orden) desde allowlist cerrada, jamás desde la petición.
|
|
6
|
+
- Usuario de aplicación con permisos mínimos: sin `SUPERUSER`, sin DDL en producción, sin acceso a tablas que no usa.
|
|
7
|
+
- Row Level Security cuando hay multi-tenant (y verifica que la política se aplica también al rol de la app).
|
|
8
|
+
- Nunca datos sensibles en claro: hash para credenciales, cifrado para PII; cuidado con logs de consultas lentas que registran parámetros.
|
|
9
|
+
- Copias de seguridad cifradas y **restauración probada**, no solo programada.
|
|
10
|
+
|
|
11
|
+
## Modelado
|
|
12
|
+
- Claves primarias estables (UUIDv7 o bigint); claves foráneas con `ON DELETE` explícito.
|
|
13
|
+
- `NOT NULL` por defecto; `CHECK` para invariantes; `UNIQUE` para reglas de unicidad reales.
|
|
14
|
+
- Tipos correctos: `timestamptz` (nunca `timestamp` sin zona), `numeric` para dinero (nunca `float`), `text` en Postgres, enum o tabla de catálogo para conjuntos cerrados.
|
|
15
|
+
- Normaliza primero; desnormaliza solo con medición y con plan de consistencia.
|
|
16
|
+
|
|
17
|
+
## Consultas
|
|
18
|
+
- Sin `SELECT *` en código de aplicación. Paginación por keyset cuando el offset crece.
|
|
19
|
+
- Índice que cubra `WHERE` + `ORDER BY`; cuidado con funciones sobre la columna (rompen el índice) y con `LIKE '%x'`.
|
|
20
|
+
- Evita N+1 desde el ORM; agrupa con `IN` o `JOIN`.
|
|
21
|
+
- `EXISTS` mejor que `COUNT(*) > 0`. `UNION ALL` si no hace falta deduplicar.
|
|
22
|
+
- CTE cuando aclara; vigila que no fuerce materialización innecesaria.
|
|
23
|
+
- Transacción corta: nada de llamadas de red dentro; nivel de aislamiento consciente; reintento ante deadlock.
|
|
24
|
+
|
|
25
|
+
## Migraciones
|
|
26
|
+
- Versionadas, en el repo, reversibles, idempotentes en lo posible. Una migración, un cambio.
|
|
27
|
+
- Cambios en caliente en dos o tres pasos: añadir (nullable/valor por defecto) → rellenar por lotes → hacer obligatorio → retirar lo viejo en un despliegue posterior.
|
|
28
|
+
- `CREATE INDEX CONCURRENTLY` en Postgres. Evita bloqueos largos: comprueba el nivel de lock antes de aplicar.
|
|
29
|
+
- Prueba la migración con datos de volumen realista y mide el tiempo antes de producción.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Swift (iOS / macOS)
|
|
2
|
+
**Gates**: `swiftformat --lint` · `swiftlint --strict` · `swift build -warnings-as-errors` · `swift test` / `xcodebuild test` · escaneo de dependencias SPM
|
|
3
|
+
|
|
4
|
+
## Idiomas
|
|
5
|
+
- Semántica de valor: `struct` y `enum` por defecto; `class` solo con identidad o ciclo de vida compartido; `final` salvo que se herede a propósito.
|
|
6
|
+
- Opcionales explícitos: sin `!` forzado, sin `try!`, sin `as!`. `guard let` con salida temprana.
|
|
7
|
+
- Errores con `throws` y tipos de error propios; `Result` en fronteras asíncronas antiguas. Nunca silenciar con `try?` sin comentario.
|
|
8
|
+
- Protocolos pequeños y composición; extensiones para conformidad. Genéricos con restricciones claras.
|
|
9
|
+
- `@inlinable`/`@usableFromInline` solo con motivo; `Codable` con claves explícitas y validación del payload externo.
|
|
10
|
+
|
|
11
|
+
## Concurrencia (Swift 6)
|
|
12
|
+
- `async/await` y actores; sin `DispatchSemaphore` para esperar código asíncrono.
|
|
13
|
+
- Estado mutable compartido dentro de un actor; `@MainActor` para todo lo que toque UI.
|
|
14
|
+
- Respeta `Sendable`: si el compilador se queja de concurrencia, es un bug real, no ruido.
|
|
15
|
+
- Cancelación cooperativa: comprueba `Task.isCancelled`, propaga el `Task` y cancélalo en `deinit`/`onDisappear`.
|
|
16
|
+
|
|
17
|
+
## Memoria
|
|
18
|
+
`weak`/`unowned` para romper ciclos en closures y delegados (`[weak self]`); cuidado con retención en `Task` de larga vida; instrumenta fugas con Instruments.
|
|
19
|
+
|
|
20
|
+
## Seguridad (app)
|
|
21
|
+
- Secretos y tokens en Keychain (`kSecAttrAccessibleWhenUnlockedThisDeviceOnly`), nunca en `UserDefaults` ni en el bundle.
|
|
22
|
+
- Biometría con `LAContext` como conveniencia, no como única barrera; la clave real protegida por Secure Enclave o por contraseña del usuario.
|
|
23
|
+
- ATS activo; certificate pinning si el modelo de amenaza lo exige. Sin `NSAllowsArbitraryLoads`.
|
|
24
|
+
- `CryptoKit` para cripto (`AES.GCM`, `ChaChaPoly`, `SymmetricKey`); nunca cripto propia. Borra material sensible de memoria cuando puedas.
|
|
25
|
+
- Valida todo lo que entre por URL scheme, universal link, pasteboard o ficheros compartidos.
|
|
26
|
+
|
|
27
|
+
## SwiftUI
|
|
28
|
+
Una fuente de verdad por estado; `@State` local, `@Observable`/`@StateObject` para modelos; vistas pequeñas y puras; `id` estable en `ForEach`; evita trabajo pesado en `body`.
|
|
29
|
+
|
|
30
|
+
## Tests
|
|
31
|
+
XCTest o Swift Testing · dependencias inyectadas por protocolo · `URLProtocol` simulado para red · pruebas de UI solo en recorridos críticos · snapshot tests con tolerancia controlada.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# TypeScript / JavaScript / Node
|
|
2
|
+
**Gates**: `prettier --check .` · `eslint . --max-warnings=0` · `tsc --noEmit` · `vitest run --coverage` · `npm audit --omit=dev` · `knip`
|
|
3
|
+
|
|
4
|
+
## Tipos
|
|
5
|
+
- `strict: true` + `noUncheckedIndexedAccess` + `exactOptionalPropertyTypes` + `noImplicitOverride` + `verbatimModuleSyntax`.
|
|
6
|
+
- `any` prohibido: usa `unknown` y estrecha. `as` solo con comentario. Sin `@ts-ignore` (`@ts-expect-error` con motivo si es inevitable).
|
|
7
|
+
- Datos externos (HTTP, env, JSON, storage) validados con Zod/Valibot y tipo derivado. Los tipos no existen en runtime.
|
|
8
|
+
- Uniones discriminadas con `switch` exhaustivo y `never` en el default.
|
|
9
|
+
- `readonly`, `as const`, `satisfies`. Uniones de literales en vez de enums.
|
|
10
|
+
|
|
11
|
+
## Idiomas
|
|
12
|
+
- ESM, imports `type`-only, sin `export default` en módulos internos.
|
|
13
|
+
- `===` siempre. `??` y `?.` en vez de `||` cuando 0 o cadena vacía son válidos.
|
|
14
|
+
- Inmutabilidad: `map`/`filter`/`reduce` y spread; no mutar parámetros.
|
|
15
|
+
- Errores: clases propias con `cause`; nunca lanzar strings. `Promise.allSettled` si el fallo parcial es aceptable.
|
|
16
|
+
- Async: sin promesas flotantes; `Promise.all` cuando no hay dependencia; `await` dentro de manejo real de error.
|
|
17
|
+
- `AbortController` y timeout en todo `fetch`.
|
|
18
|
+
|
|
19
|
+
## Node
|
|
20
|
+
- Nunca `exec` con interpolación: `execFile`/`spawn` con array de argumentos.
|
|
21
|
+
- Rutas: `path.resolve` y comprobar que el resultado está bajo el directorio base.
|
|
22
|
+
- Config desde `process.env` validada con esquema al arrancar; si falta algo, fallo al iniciar.
|
|
23
|
+
- Express/Fastify: `helmet`, límite de body, rate limit, CORS explícito, cookies `httpOnly`+`secure`+`sameSite`, manejador de errores que no filtra stack.
|
|
24
|
+
- JWT: algoritmo fijado (rechaza `none` y confusión RS/HS), verifica `exp`, `aud`, `iss`; revocación prevista. Sesión en cookie antes que token en localStorage.
|
|
25
|
+
- `crypto.randomUUID`, `crypto.randomBytes`, `timingSafeEqual`. Nunca `Math.random` en seguridad.
|
|
26
|
+
- ORM: consultas parametrizadas; `$queryRaw` solo con plantilla etiquetada `sql`.
|
|
27
|
+
|
|
28
|
+
## Navegador
|
|
29
|
+
`textContent` antes que `innerHTML`; si hace falta HTML, DOMPurify. Sin `eval` ni `new Function`. CSP sin `unsafe-inline`. `postMessage`: verifica `origin`. Enlaces externos con `rel="noopener noreferrer"`.
|
|
30
|
+
|
|
31
|
+
## Tests
|
|
32
|
+
Vitest/Jest + Testing Library, MSW para HTTP, Playwright para E2E, `fast-check` para propiedades. No mockear el propio dominio. Sin snapshots gigantes.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# HTML / CSS / Accesibilidad / Frontend base
|
|
2
|
+
**Gates**: validador HTML · `stylelint` · `axe`/Lighthouse (a11y ≥95) · presupuesto de bundle · Core Web Vitals
|
|
3
|
+
|
|
4
|
+
## HTML semántico
|
|
5
|
+
- Un `h1` por página y jerarquía de encabezados sin saltos. `header`, `nav`, `main`, `section`, `article`, `footer`, `button`, `a`.
|
|
6
|
+
- `button` para acciones, `a[href]` para navegación. Nunca `div` con `onClick`.
|
|
7
|
+
- Todo control con etiqueta asociada (`label for` o `aria-label`). `alt` en imágenes (vacío si son decorativas).
|
|
8
|
+
- Formularios: `type` correcto, `autocomplete`, `required`, mensajes de error asociados con `aria-describedby` y anunciados.
|
|
9
|
+
- Idioma en `html lang`; `title` descriptivo por página; `meta viewport` sin bloquear el zoom.
|
|
10
|
+
|
|
11
|
+
## Accesibilidad (WCAG 2.2 AA)
|
|
12
|
+
- Todo lo usable con ratón, usable con teclado. Foco **visible** y orden lógico. Sin trampas de foco salvo en modales (y con `Esc`).
|
|
13
|
+
- Contraste texto ≥4,5:1 (grande ≥3:1); elementos de interfaz ≥3:1.
|
|
14
|
+
- Objetivo táctil ≥24×24 px. Respeta `prefers-reduced-motion`.
|
|
15
|
+
- ARIA solo si el elemento nativo no basta; ARIA mal usado es peor que nada.
|
|
16
|
+
- Cambios dinámicos anunciados (`aria-live` en mensajes de estado y errores).
|
|
17
|
+
- Prueba real: navega la pantalla solo con `Tab`, y una vez con lector de pantalla.
|
|
18
|
+
|
|
19
|
+
## CSS
|
|
20
|
+
- Sistema de diseño con tokens (color, espaciado, tipografía) en custom properties; sin valores mágicos repetidos.
|
|
21
|
+
- Layout con Grid y Flexbox; evita posicionamiento absoluto para estructura.
|
|
22
|
+
- Mobile-first, unidades relativas (`rem`, `ch`, `%`), `clamp()` para escalas fluidas.
|
|
23
|
+
- Especificidad baja y plana; sin `!important` salvo utilidades documentadas; sin selectores de más de 3 niveles.
|
|
24
|
+
- Modo oscuro por `prefers-color-scheme` con variables, no duplicando hojas.
|
|
25
|
+
- Anima solo `transform` y `opacity`; nada de animar `width`/`top` en bucles.
|
|
26
|
+
|
|
27
|
+
## Rendimiento
|
|
28
|
+
Imágenes dimensionadas, modernas (AVIF/WebP), `loading="lazy"`, `srcset` · fuentes con `font-display: swap`, subconjunto y precarga de la crítica · CSS crítico en línea si mejora el LCP · sin librerías pesadas para una animación · presupuesto: JS inicial <200 KB comprimido, LCP <2,5 s, CLS <0,1, INP <200 ms.
|
|
29
|
+
|
|
30
|
+
## Seguridad en el navegador
|
|
31
|
+
CSP estricta sin `unsafe-inline` (nonce o hash) · `Subresource Integrity` en scripts de CDN · sin datos sensibles en `localStorage` · `iframe` con `sandbox` y `allow` mínimos · `noopener` en enlaces externos · validar `origin` en `postMessage`.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: csr-audit
|
|
3
|
+
description: Auditoria de seguridad completa (OWASP Top 10 2025, ASVS 5.0, CWE Top 25) sobre el diff, un fichero, un modulo o todo el repositorio, con informe de hallazgos y correcciones.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# csr-audit — Auditoría de seguridad
|
|
7
|
+
|
|
8
|
+
1. Define el alcance: diff actual (por defecto), fichero, módulo o repo completo si el usuario lo pide.
|
|
9
|
+
2. Ejecuta `~/.agents/rules/31-security-audit.md` completo: fases A (modelo de amenaza) → G (criterio de cierre).
|
|
10
|
+
3. Ejecuta las herramientas disponibles de la fase E; lo que no esté instalado, se declara `SKIPPED`, no se simula.
|
|
11
|
+
4. Informe: una línea por hallazgo con severidad, CWE/OWASP, `fichero:línea`, problema y corrección. Ordenado por severidad.
|
|
12
|
+
5. Ofrece corregir CRIT y HIGH en el mismo turno; MED y LOW se listan para decisión del usuario.
|
|
13
|
+
|
|
14
|
+
**Prohibido**: inventar hallazgos, inventar resultados de escáneres, o escribir exploits armados. Prueba de concepto mínima y corrección.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: csr-gate
|
|
3
|
+
description: Ejecuta la puerta de validez completa (format, lint, typecheck, build, test, cobertura, seguridad, dependencias) y reporta PASS/FAIL/SKIPPED antes de dar una tarea por terminada.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# csr-gate — Puerta de validez
|
|
7
|
+
|
|
8
|
+
1. Lee `STACK.md` §3 para los comandos. Si falta, deduce del manifiesto y dilo.
|
|
9
|
+
2. Lee `~/.agents/rules/50-done-gate.md` y ejecuta las fases 4 a 8.
|
|
10
|
+
3. Ejecuta en este orden, parando y arreglando la causa raíz en el primer fallo:
|
|
11
|
+
`format → lint → typecheck → build → test → coverage → sec-scan → deps-audit`
|
|
12
|
+
4. Autorrevisión adversarial (fase 4 del done-gate): responde las 7 preguntas en una línea cada una, solo para el diff actual.
|
|
13
|
+
5. Si el diff toca entrada de usuario, autenticación, autorización, criptografía, ficheros, red, SQL, procesos, deserialización o dependencias, ejecuta además `~/.agents/rules/31-security-audit.md`.
|
|
14
|
+
6. Reporta la tabla de gates (`50-done-gate.md` §8). Nada de prosa adicional.
|
|
15
|
+
|
|
16
|
+
**Regla absoluta**: un gate que no se ejecutó se reporta `SKIPPED (motivo)`. Nunca `PASS`.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: csr-stack
|
|
3
|
+
description: Genera o actualiza el STACK.md del repositorio actual detectando lenguajes, frameworks, comandos y riesgos. Usar al abrir un proyecto sin STACK.md, o cuando el stack haya cambiado.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# csr-stack — Ficha de stack del proyecto
|
|
7
|
+
|
|
8
|
+
## Procedimiento
|
|
9
|
+
1. **Detecta** sin preguntar lo que se puede leer:
|
|
10
|
+
- Manifiestos: `package.json`, `pnpm-workspace.yaml`, `Cargo.toml`, `pyproject.toml`, `requirements*.txt`, `go.mod`, `pom.xml`, `build.gradle*`, `*.csproj`, `composer.json`, `Gemfile`, `pubspec.yaml`, `Package.swift`, `CMakeLists.txt`, `mix.exs`.
|
|
11
|
+
- Config: `tsconfig.json`, `.eslintrc*`, `ruff.toml`, `.golangci.yml`, `Makefile`, `Taskfile.yml`, `justfile`, `docker-compose*.yml`, `Dockerfile`, `.github/workflows/*`, `terraform/`, `k8s/`.
|
|
12
|
+
- Versiones reales: `.nvmrc`, `.tool-versions`, `rust-toolchain.toml`, `.python-version`, campos `engines`/`edition`/`target-framework`.
|
|
13
|
+
- Comandos reales: scripts del manifiesto, targets del Makefile, jobs del CI. **No inventes ninguno**: lo que no exista va como `N/A`.
|
|
14
|
+
2. **Infiera** tipo de proyecto, base de datos, framework de tests, gestor de paquetes (por el lockfile presente).
|
|
15
|
+
3. **Escribe** `STACK.md` en la raíz usando la plantilla `~/.agents/templates/STACK.md`.
|
|
16
|
+
4. **Marca** con `TODO:` solo lo que no se puede deducir del repo (nivel ASVS, amenazas, presupuestos, decisiones cerradas) y pregunta al usuario **como máximo 3** de esos puntos, en una sola tanda.
|
|
17
|
+
5. **Selecciona** los módulos CSR activos (§9) según los lenguajes detectados.
|
|
18
|
+
6. Reporta en 2 líneas: stack detectado y qué quedó como `TODO:`.
|
|
19
|
+
|
|
20
|
+
## Reglas
|
|
21
|
+
- Si ya existe `STACK.md`, **actualiza** preservando lo escrito a mano (§5–§8); no lo sobrescribas entero.
|
|
22
|
+
- Versiones exactas, no rangos, cuando el repo las fije.
|
|
23
|
+
- Si hay monorepo, una tabla por paquete relevante, no una ficha por paquete.
|