毎回ドキュメントを読み直す
既知の挙動を、コンテキストと計算量を使って何度も探し直す。
エージェント向け経験インフラ
同じ調査に、何度も戻らない。
Knudg は、コーディングエージェント向けの経験共有インフラです。 過去の作業で得た学びを、次の作業が検証できる手がかりとして残すことを目指します。
ビルド、CI、移行、開発ツールまわりで、コーディングエージェントが同じ調査を繰り返しているチームのための仕組みです。
現在は情報公開のみで、製品へのアクセスは提供していません。
情報プレビュー
情報のみ
製品アクセス未提供
表示例
公開プレビュー / 実データなし
効果
既知の開発ツール失敗を、もう一度探し直す時間を減らす設計です。
再利用できる手がかり
安全性
過去の経験は命令ではなく、検証するための手がかり。
採用前に検証
管理
共有は、人間が承認する前提で設計します。
非公開が基本
効果 同じ調査に戻る時間を減らす設計
命令ではなく、検証すべき手がかり
非公開が基本
繰り返しの損失
同じ失敗が、毎回また起きる。
最初に減らすべきなのは、解決そのものではなく、同じ調査へ戻る時間です。 読み直し、再試行、環境差分の確認が毎回やり直しになります。
失敗した直し方をまた試す
だめだった道筋が残らず、次のエージェントが同じ罠へ戻る。
環境依存の罠が外に出ない
OS、shell、CI、依存ツールの差分が、個別セッションの中に閉じる。
検証したい効果
経験を再利用できるようにして、作業の戻りを減らす。
Knudg は、過去の作業を自動命令にするのではなく、次の作業が検証できる手がかりとして渡すことを目指します。
再探索を減らす設計
同じ調査に戻る前に、過去の手がかりを見つけやすくすることを目指します。
失敗の再試行を減らす設計
一度だめだった道を、次の作業でまた踏みにくくすることを目指します。
引き継ぎを軽くする設計
セッションの中だけに閉じていた学びを、次へ渡しやすくします。
安全に使う設計
出てきた情報を、命令ではなく検証する前提の手がかりとして扱います。
残す情報の例
残すのは、生ログではなく次に使える学び。
公開ページでは価値の種類だけを示し、内部のデータ構造や検索設計は出しません。
パッケージのビルドが、ローカルでは通るのに CI 上でだけ失敗する
CI では、ローカルとは異なるツールチェーンや設定が選ばれることがあります。
前に効いた修正を試す前に、CI とローカルの差分を確認します。前提が合わない場合は、この手がかりは使いません。
候補となる根拠にとどめ、現在の作業環境で検証します。
一度確かめた修正筋を、次が検証できる。
答えとして渡さず、確認すべき候補として残す。
次の作業が、あり得る修正筋を検証しやすくする。
よさそうに見えた修正が、実は遠回りだった。
一度だめだった手順を、次の作業でまた試しにくくする。
一見よさそうな手順で、また時間を失うのを避ける。
証拠が足りず、まだ結論にできない。
分からなかったことを、分からないまま残す。
未確定の情報を、確定情報のように扱わない。
解けていなくても、どこまで分かったかを残す。
価値があるのは、答えだけではなく調査の境界。
次の作業が、既に分かっている地点から始められる。
古い道を、いまの前提で使ってよいか見直す。
古い情報に戻る前に、確認が必要だと分かる。
前は正しかった道を、今も正しいものとして扱わない。
実際の使われ方
価値があるのは、思い出せる学びです。
内部ログや実装詳細を公開しなくても、過去の作業から得た学びは次に渡せるはずです。
- 失敗の種類を覚える
- 元の作業内容を見せずに、学びだけを渡す
- 手がかりには検証が必要だと示す
- 共有する前に人間の承認を必要にする
安全性の根拠
安全性の姿勢は、Knudg が勝手に決めないことから作る。
公開ページでは、公開前に満たすべき要件だけを示します。共有には人間の承認を必要とし、 出てくる経験は命令ではなく検証する手がかりとして扱います。
非公開を前提に設計
- 生の作業内容を公開ページに出さない。
- このページから自動公開はできない。
- このページから検索結果を表示しない。
公開ページは目指す姿勢を説明する場所であり、仕組みの中身を公開する場所ではありません。
人間の承認
- 共有する内容の確認は、公開前の製品要件として扱います。
- 共有範囲と取り消しは、公開前に必要な管理要件です。
- 古い手がかりや危険な手がかりは、再利用を止める理由として扱います。
これらの管理は、後から足す画面ではなく公開前から必要な要件です。
公開状態
このページは、製品への入口ではありません。
このページは方向性と安全性の考え方を説明するだけです。製品アクセスは提供しません。
公開ページ
概要と検証したい効果だけを表示します。
情報のみ 公開アクセスなし非公開検証
初期の検証はページ外で行います。
限定 公開前エージェント接続
製品としての接続面は、非公開の検証後に扱います。
今後 検証後技術詳細
ここでは効果と安全性の境界だけを示します。
制限 高水準のみ検証計画
検証すべきなのは、効果と安全性です。
公開アクセスの前に、同じ作業を減らせることと、安全に境界を保てることを確かめます。
- 反復作業
- 同じ調査に戻る時間を減らせたか
- 安全な再利用
- 候補を命令ではなく手がかりとして扱えたか
- プライバシー
- 生の作業内容を出さずに学びを共有できたか
- 人間の制御
- 共有内容を人間が理解し、制御できたか