[awf] ledger guidance: comment-backed storage missing from agent authoring guide
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 72/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown, yaml
調査の方向性
.github/aw/ledger.md を読むことから始め、Git 固有の主張(branch、commits、clone/push、compaction、1024-file limit)をすべて書き留め、次に pkg/parser/schemas/main_workflow_schema.json の comment-backed スキーマ(tools.ledger.<name>.storage: comment-memory と tools.comment-memory のエントリを参照)および docs/src/content/docs/specs/repo-memory-ledger-specification.md の trust/queue/capacity セクションと比較する。Git に関する記述の範囲を絞り、必要な target configuration とバックエンドごとの制限を備えた動作する comment-backed の例を追加し、storage を切り替えても履歴は移行されないことに言及する。ガイドが documented config としてコンパイルされ、追加した guidance check がすべての ledger が Git branch を使うという主張を拒否したら完了。
索引モデルが issue の本文から書いたものです。
説明
Problem
The agent authoring guide .github/aw/ledger.md presents Git branch storage (ledgers/<name> branch, commits, clone/push, compaction, 1024-file limit) as universal. Since tools.ledger.<name>.storage: comment-memory was added (commit 910cd8c), agents may choose or describe the wrong backend.
Context
Original issue: github/gh-aw#77571 (feature ID ledger.storage-comment-memory).
Root Cause
The guide was written before the comment backend existed and was not updated. Its Git-specific statements are not scoped to Git-backed ledgers. The schema (pkg/parser/schemas/main_workflow_schema.json) and human docs already cover comment storage, so the gap is limited to agent-facing guidance.
Proposed Solution
- P1: Update
.github/aw/ledger.mdwith a valid comment-backed example, the requiredtools.comment-memorytarget configuration, deferred persistence, and per-backend limits (no compaction, smaller history). - P2: Explain the Git vs. comment choice. State that changing storage does not migrate existing ledger history. Link
docs/src/content/docs/specs/repo-memory-ledger-specification.mdfor trust, queue, and capacity limits. - P2: Add a guidance check that compiles the documented comment-backed configuration and fails on claims that all ledgers use a Git branch.
Generated by Firewall Issue Dispatcher · copilot · routed: haiku55 xhigh · ~2 AIC · ⊞ 3K · ◷
- 主要言語
- TypeScript
- スター
- 165
- フォーク
- 84
- 平均マージ
- 5時間 57分
- マージ済み PR(30日)
- 390
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
github/gh-aw-firewall のほかの issue
-
code-quality refactoring
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
github/gh-aw-firewall#11797 ·
メンテナーはふだん 1 日以内に返信
-
agentic-workflows automated dependencies
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
github/gh-aw-firewall#3837 ·
メンテナーはふだん 1 日以内に返信
-
agentic-workflows
難易度 3/5 1〜2日 初心者へのやさしさ 48/100
github/gh-aw-firewall#11802 ·
メンテナーはふだん 1 日以内に返信
-
automation otel smoke-test tracing
難易度 1/5 1時間未満 初心者へのやさしさ 1/100
github/gh-aw-firewall#11801 ·
メンテナーはふだん 1 日以内に返信
-
automation otel smoke-test tracing
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
github/gh-aw-firewall#11800 ·
メンテナーはふだん 1 日以内に返信
github/gh-aw-firewall の issue をすべて見る
似ている issue
-
bug documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
Potential Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
Comfy-Org/ComfyUI_frontend#23773 ·
メンテナーはふだん 1 日以内に返信
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
lingdojo/kana-dojo#34301 · コメント 1 件 · リアクション 5 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
code-yeongyu/senpi#7007 ·
メンテナーはふだん 1 日以内に返信
-
area/renderer bug plugin/echarts priority/P3
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信