allium skills: document invariant+@guidance pattern for complex semantics
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 65/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Área
- documentation
Línea de trabajo
Comienza revisando las skills de allium existentes, especialmente allium:tend, y el contexto fuente del wemble issue #109. Documenta cuándo deben usarse reglas formales frente al patrón invariant más @guidance, incluyendo el procesamiento de colecciones y la concurrencia en varias fases; se considera terminado cuando el patrón y sus criterios de decisión están claros para los autores de specs.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Context
When Allium behaviors are too complex to express as trigger/ensures rules (e.g., concurrent iteration, parallel merge, heterogeneous collection processing), there's a useful workaround pattern that isn't documented in the allium skills.
Pattern
Use invariant Name { true } with an @guidance block for prose:
invariant ParallelMerge { true }
@guidance """
All parallel branches execute concurrently.
Results are merged into the parent entity when all branches complete.
"""
The checker accepts this; the meaningful content lives in the guidance annotation.
Request
Document this pattern in the allium skills (likely allium:tend or a new "Spec Authoring Patterns" section) explaining:
- When to use formal rules vs invariant+@guidance
- Reserve formal rules for entity state transitions and attribute causality
- Use invariants+@guidance for behaviors involving collection processing or multi-phase concurrency
Source
Discovered during wemble issue #109 — parallel/iterate/cond semantics couldn't be expressed cleanly with Allium rule syntax.
- Lenguaje dominante
- JavaScript
- Estrellas
- 10
- Forks
- 6
- Merge medio
- 9 min
- PR fusionados (30 d)
- 1
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Issues similares
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
swc-project/swc-ai-issues#995 ·
-
[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)Abiertofeedback simulation workshop
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
githubnext/gh-aw-workshop#5973 ·
Los mantenedores suelen responder en 1 día
-
Development server fails with webpack-dev-server 6.1.0Posiblemente ocupada @utsxvrai la tomó hoy. Abiertobug
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
rabbitmq/rabbitmq-website#2733 ·
Los mantenedores suelen responder en 1 día
-
[BUG]: Paperless-ngx import fails when a document has no original file namePosiblemente ocupada @Israel-Kli la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Mintplex-Labs/anything-llm#7310 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 80/100
kentcdodds/kcd-skills#32 ·