Show HN: Shoaku – あなたのコーディングナビゲーター

Shoaku（「あなたのコーディングナビゲーター」）は、IntelliJ IDEA 向けのオープンソースプラグインで、AI によるコード生成が人間の理解速度を上回る問題に取り組みます。プロジェクト名の「Shoaku」は「しょうあく」と読み、コーディングをナビゲートする存在を意味します。

背景と動機

AI コーディングツールの発展により、コード生成の速度は人間の理解速度を超えています。README には「AI は私たちが理解できるよりも速くコードを生成できます。理解が追いつかないと、レビューが遅れ、メンテナンスのリスクが高まります」と記されています。Shoaku はこの課題に対処するために生まれ、開発を人間のペースに保ち、コードを理解可能で所有可能にすることを目指します。

技術アーキテクチャ

このプラグインは Codex CLI を内部で使用し、Node.js 22 以降が必要です。Codex CLI は OpenAI が提供するコマンドラインツールで、自然言語からコードを生成できます。Shoaku はそれを IntelliJ IDEA に統合し、開発者が IDE 内で AI 支援を受けながらもコードを完全に制御できるようにします。アーキテクチャの詳細は architecture.md に記載されています。

プロジェクトの状態とデータ

最新の統計によると、Shoaku は GitHub 上で 1 つのスター、0 のフォーク、0 のウォッチャーを持っています。コミュニティは小規模ですが、17 のリリースが行われ、最新バージョンは v0.1.3（2026 年 6 月 29 日）です。リポジトリには 110 のコミットがあり、主な言語は Kotlin（67.4%）と JavaScript（32.6%）です。プロジェクト構造には、Gradle ビルドファイル、サーバーモジュール、IntelliJ プラグインのソースコードが含まれます。

コア機能と特徴

Shoaku の核心理念は、AI が生成したコードを開発者が理解できるようにすることです。生成されたコードは自動的にプロジェクトに適用されるのではなく、提案として提示され、開発者が承認した場合のみ取り込まれます。これにより、理解不能な「ブラックボックス」コードが混入するリスクを低減します。

また、Shoaku は「人間のペース」での開発を促進します。対話的なインタラクションと明確なコード説明を通じて、開発者が段階的にコードを構築できるようにします。これはチームでのコードレビューや保守において特に重要です。

適用シーンと意義

Shoaku は、AI の力を活用して生産性を向上させつつ、コードの品質と可読性を犠牲にしたくない開発者に適しています。特に長期保守が必要な大規模プロジェクトで有効です。

AI 支援コーディングツールが増える中、Shoaku は AI を「ドライバー」ではなく「副操縦士」として位置づける独自のアプローチを取っています。この考え方は、開発者が AI に過度に依存することを防ぎ、ソフトウェアエンジニアリングへの深い理解を維持する助けとなります。

まとめ

Shoaku は、AI 時代におけるコード理解の遅れという問題に対して実践的な解決策を提供する有望な IntelliJ プラグインです。まだ初期段階（v0.1.3）ですが、その設計思想と技術実装は注目に値します。コードの品質とチーム効率を重視する開発者にとって、Shoaku は試す価値のあるツールです。