📢 X投稿文
AIエージェント向けのコードwiki。設計理由や過去の失敗をマークダウンで記録し、エージェントがコードの背景を理解するために必要な文脈を提供。
https://github.com/AlmanacCode/codealmanac
🤖 AI考察
■ 概要
AI が駆動し Git で管理するコードベース用 wiki——コード外にある「なぜこう設計した」を機械が追記・検索可能にする。
■ 特徴・用途
- **コンテキスト層の明示化**:なぜのドキュメント(破綻した前例・不変量・サービス横断ワークフロー)をAIが発見しマークダウン化し、後続のエージェント(Codex/Claude Code)の推論に供給。コード単体では保持できない集団的認知を再現可能に。
- **Git-native・レビュー可能**:wiki は repo 内マークダウン、変更は diff で見える。エージェントが「新しい設計パターン」を書いたとき、人間が即座に抗議・修正・approve でき、ドキュメント堆積の汚濁を防ぐ。
- **ローカル索引=プライベート+オフライン**:wiki を検索・参照するのに API・クラウド同期不要で、リポジトリがあれば完結。
■ 結論
エージェント時代の暗黙知蒸留装置——チーム記憶をエージェント可読形式で外部化し、コード+wiki の二層体制で初めて「知ってる」という状態を作る枠組み。Y Combinator の選抜からみても、エージェント経済圏の基盤部品として収束する可能性は高い。