HN 日本語サマリー

← 一覧へ戻る
その他

Show HN: CodeAlmanac – 会話から生成するKarpathy風コードベースWiki

Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations (github.com)

22 pointsby divitsheth9 コメント

要約

CodeAlmanacは、開発者の会話履歴からコードベースのWikiを自動生成するオープンソースのローカルツールです。会話中の知識が失われるのを防ぎ、Markdownファイルの手動更新の手間を省きます。5時間ごとにCodex/CC SDKを使用して会話を読み込み、関連ページを更新します。チームでの知識共有にも役立ちます。

全文翻訳

皆さん、こんにちは!Almanac(YC S26)のDivitです。私たちは、会話を続けることで更新される、コーディングエージェントのためのWiki「CodeAlmanac」を開発しました。これはオープンソースで、ローカルで実行でき、無料です。

デモはこちらです: https://www.youtube.com/watch?v=XNQWV3TFBWM

皆さんのCC/Codexの会話には、文書化されずに忘れられてしまう多くの知識が含まれています。人々はチャットを文書化するために独自のメソッドを持っています。私たちはかつて、MANUAL.mdやDESIGN.mdのようなMarkdownファイルを作成し、Claudeにそれらを更新するように指示していました。しかし、これらのファイルはすぐに古くなり、乱雑になり、単一のファイルに入れられる情報量には限界があります。

そこで私たちはCodeAlmanacを構築することにしました。私たちが求めていたのは、1) 自動的に維持され、2) リポジトリ内に存在し、3) 既存のCodex/Claude Codeサブスクリプションを利用できるものでした。

CodeAlmanacは、リポジトリ内にalmanac/フォルダを維持します。ここには、コードベースに文書化されていない決定事項や、コードベースがそのように形成されている理由など、関連するMarkdownページが含まれています。

ページはSQLiteにインデックス化されており、CLIを通じてクエリ可能です。AGENTS.mdやCLAUDE.mdに指示を追加することで、将来のセッションはコーディングを開始する前に自動的にWikiを検索するようになります。

5時間ごとに、CodeAlmanacはCodex/CC SDKを使用してエージェントを起動し、新しい会話を読み取り、関連ページを更新します。コミットベースのトリガーではなく時間ベースのトリガーを選択したのは、人々が非常に頻繁にコミットするのを見て、トークンコストが高くなることがわかったからです。

当初は個人開発者向けにCodeAlmanacを作成しましたが、私たち自身が使用する中で、チームでの利用ケースがはるかに明白になりました。私たちは3人のチームで、それぞれが自身のコーディングエージェントと協力しています。これ以前は、多くの思考を経て変更を加えた後、その変更がなぜそのようになったのかを共同創業者に電話で説明しなければなりませんでした。今では、私が下した決定が、彼らのエージェントが実際に読む場所に書き留められているという安心感があります。

本日より、どなたでも試すことができます。フィードバックをいただけると幸いです。ご質問にも喜んでお答えします。皆さんが現在、会話間でコンテキストをどのように維持しているかについても、ぜひお聞かせください!