allium skills: document invariant+@guidance pattern for complex semantics
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 65/100
- issue の種類
- ドキュメント
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
調査の方向性
まず既存の allium skills、特に allium:tend と、wemble issue #109 のソースコンテキストを確認します。collection の処理と複数フェーズの並行性を含め、formal rules を使うべき場合と invariant に @guidance を加えるパターンを使うべき場合を文書化します。パターンとその判断基準が spec authors にとって明確になれば完了です。
索引モデルが issue の本文から書いたものです。
説明
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.
- 主要言語
- JavaScript
- スター
- 10
- フォーク
- 6
- 平均マージ
- 9分
- マージ済み PR(30日)
- 1
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
vercel-labs/ui#999 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
swc-project/swc-ai-issues#995 ·
-
[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)オープンfeedback simulation workshop
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
githubnext/gh-aw-workshop#5973 ·
メンテナーはふだん 1 日以内に返信
-
Development server fails with webpack-dev-server 6.1.0対応中かも @utsxvrai が今日担当しました。 オープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
rabbitmq/rabbitmq-website#2733 ·
メンテナーはふだん 1 日以内に返信