[awf] ledger guidance: comment-backed storage missing from agent authoring guide

オープン 初心者向け
#11,612 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
72/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
markdown, yaml
領域
documentation

調査の方向性

.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 の本文から書いたものです。

説明

awf-triage

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.md with a valid comment-backed example, the required tools.comment-memory target 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.md for 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

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

github/gh-aw-firewall のほかの issue

github/gh-aw-firewall の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。