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

こんにちはHN！Almanac (YC S26) のDivitです。私たちはCodeAlmanacを開発しました。これは、会話に合わせて更新されるコーディングエージェントのためのWikiです。オープンソースで、ローカルで、無料です。 デモはこちら: 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人のチームで、それぞれが独自のコーディングエージェントと協力しています。これ以前は、多くの思考を経て変更を加えた後、共同創設者に電話してなぜそのように見えるのかを説明しなければなりませんでした。私が下した決定が、彼らのエージェントが実際に読む場所に書き留められていると知ることで、ほとんど安心感があります。 本日、誰でも試せるように公開されています。フィードバックをいただければ、喜んで質問にお答えします。皆さんが今日、会話間でコンテキストをどのように維持しているかについても、ぜひお聞きしたいです。