CodeAlmanacと同じ用途で使える、当社の製品
OSSを自分で立てて日本語化する代わりに、日本語で作った当社の製品を自社のサーバーに置く方法もあります。ソースコード付きで、月額はかかりません。
AIエージェントの構築の業務で、CodeAlmanacを使うと
AIエージェントの構築とは、AIに作業そのものを任せたいという状態を、仕組みで解消することです。CodeAlmanacを土台にすると、たとえば次のことを自社のサーバーで回せるようになります。
- AIエージェントの文脈維持
- 設計判断・障害の記録
- コードベースwiki
すでに世界で使われている完成品を土台にするので、同じものをゼロから作るより短い期間で済みます。当社は、この土台に対して日本語化、画面や項目の変更、権限、帳票、既存システムとの連携を加えて、御社の業務に合う状態にします。
社内システムの改修でCodeAlmanacを使うと、1日の仕事がどう変わるか
社内の販売管理や予約の仕組みを、社内の1〜2人か外注先がClaude CodeやCodexで直している会社を考えます。いまは「なぜこの画面はこうなっているのか」「前に何が壊れたのか」が担当者の頭の中やチャットの履歴に散らばっていて、AIに作業を頼むたびに同じ説明をし直しています。
- 朝:担当者がAIに修正を頼むと、AIはリポジトリの中の almanac/ フォルダにある記録(設計の理由、過去の障害、守るべき決まり)を検索してから作業に入ります。公式のREADMEでは、人もAIも同じ検索コマンドで記録を読む形になっています。
- 日中:AIとのやり取りは普段どおりです。会話の中で出た判断は、Syncという定期処理(既定は5時間ごと)が会話ログを読み、残す価値のあるものだけを記録に回します。
- 夜:Gardenという定期処理(既定は24時間ごと)が、古くなった記録や重複した記録を手入れします。
- 記録はただのMarkdownファイルなので、変更はGitの差分として見られ、コードと同じようにレビューできます。
担当者が替わっても、引き継ぎ資料を別に作らずに、判断の理由がコードの隣に残っている状態に近づきます。
向いている会社・向いていない会社
向いている会社
- Claude CodeかCodexを、すでに日常の開発で使っている会社(READMEが対象にしているのはこの2つです)
- 社内システムのソースコードを自社のGitリポジトリで持っていて、担当者や外注先が入れ替わる会社
- 「仕様書が古くて当てにならない」状態を、書類を増やさずに減らしたい会社
向いていない会社
- AIコーディングエージェントを使っていない会社。AIとの会話から記録を作るのが仕組みの前提なので、効き目がありません。
- ソースコードを持たず、パッケージやクラウドサービスだけで業務を回している会社
- 開発機がWindowsだけの会社。公式の対応は現時点でmacOSで、Linuxは当社が作った対応を本家に提案している段階です。
ライセンスはApache-2.0です。社内で使ったり手を加えたりしても、ソースコードを公開する義務はありません。
導入で決めておくこと
- どのリポジトリに入れるか:記録はリポジトリの中に置かれます。社外の人も見るリポジトリなら、記録に書いてよい内容の線を先に決めます。
- AIの実行役:CodexとClaudeのどちらに記録を書かせるかを、セットアップのときに選びます。選んだ側にログインしておく必要があります。
- 自動処理をどこまで入れるか:会話の取り込み、記録の手入れ、本体の自動更新は、READMEの手順でそれぞれ止められます。
- 誰が記録を確かめるか:READMEは、記録を書く処理は信頼したAIエージェントとして広いファイル権限で動く、と明記しています。自動で書かれた差分を見る担当を決めておきます。
- 動かす環境:Python 3.12以上が要ります。
当社の記録
当社の開発機はLinuxのため、そのままでは3つの定期処理が登録できませんでした。スケジューラの部分にsystemdのユーザータイマーで動く実装を足し、Linux上でテスト568件が通ることを確かめて、本家にプルリクエストを出しています。経緯と使い方はCodeAlmanacの解説記事にまとめました。
macOSとLinuxの導入手順に、当社が全プロジェクトで使っている日本語の判断記録の書式(判断・障害・不変条件・ワークフロー・用語集の雛形5点)とチームでの回し方を付けたものを、CodeAlmanac日本語導入・運用キットとして出しています。
CodeAlmanacの技術情報は
ライセンスはApache-2.0です。CodeAlmanacの日本語対応は当社が実際に立てて確かめました。UI・ドキュメントは英語のみ。公式はmacOS専用→当社がLinux対応(systemdユーザータイマー)を実装し本家PR #73として提出済み。GitHubでの公開は2026年4月、主な開発言語はTypeScript、GitHubスターは804、最終更新は2026年7月です(2026年11月19日時点)。
機能の一覧、日本語ファイルの実測、同じ分類のOSSとの比べ方など、技術者向けの情報はCodeAlmanacのOSS情報(Kurage)にまとめています。このページは、業務での使い方と導入の進め方を扱います。
CodeAlmanacを自分で入れるなら(導入キット)
当社が実際に立てて詰まった箇所まで含めた手順書・設計テンプレート・docker構成・バックアップスクリプトの一式です。開発を依頼せず自社で立てたい場合の早道です。税込5,500円(オンプレミス)。
進め方は?
進め方とは、現場を見て対象を決め、動くものを見ていただきながら作り、御社の環境へ導入するまでの流れのことです。書類で仕様を固めてから作る進め方はしません。
1日目(無料)
現場に伺い、いまのやり方を見せていただきます。AIエージェントの構築のどこから手を付けるかを決めます。
2〜4日目
CodeAlmanacを土台に、御社のPCで目の前で開発します。動くものを見ながらその場で直します。
5日目
御社の環境へ導入し、ソースコードと開発ノウハウをお渡しします。以後は自社で改造できます。
その後
追加の作り込みが必要なら、範囲を決めてあらためてお見積もりします。延長を前提にした進め方はしません。
この方法が向かないのは?
向かないのは、基幹システムの全面刷新や、複数部門にまたがる大規模な仕組みのことです。15時間という枠では作り切れません。また、決まった手順を正確に繰り返すだけの処理は、AIを使わないほうが速く、毎回同じ結果になります。当社ではその部分は普通のプログラムとして作ります。
AIエージェントの構築を、まず15時間で試す
名古屋市内なら、1日3時間×5日間の計15時間・税別15万円で試せます。初日3時間のヒアリングと提案は無料です。御社のPCと御社名義のAIエージェントで目の前で開発するので、作り方ごと社内に残ります。成果物とソースコードはお客様のものです。
AI導入お試し実験を見る 動くデモを先に見る(110,000円〜) CodeAlmanacについて相談する開発会社・IT販売の方へ
CodeAlmanacの日本語化・改修・導入(バイブOSS)を、御社のお客様に販売できます。導入作業は当社が行い、販売手数料は1件9万円(税別)です。ソースコードは MIT ライセンスで、御社のブランドでの販売もできます。登録無料・ノルマなし。販売代理店の条件を見る
AIエージェントの構築に使える他のオープンソース
同じ用途に使える土台は他にもあります。ライセンス、日本語対応、規模を比べて選べます。
| 名前 | できること | 日本語 | デモ |
|---|---|---|---|
| opencrew | Slackと連携してAIエージェントを協調動作させるマルチエージェントOSです。 | 日本語ファイルなし | — |
| agent-kanban | AIエージェントによる開発作業をタスクボードで管理するための開発者向けツールです | 日本語ファイルなし | — |
| agents-council | AIエージェント同士でフィードバックを依頼するための開発者向け通信ツールです | 日本語ファイルなし | — |
| join.cloud | 複数のAIエージェントがリアルタイムで共同作業するための開発基盤です。 | 日本語ファイルが一部のみ | — |
| technocore-chat | Web取得のみ許可されたサンドボックス内のAIエージェント向けに、HTTP経由のチャットとノート機能を提供する開発者向けツールです。 | 日本語ファイルなし | — |