ijust/intent-planner

intent-planner は何をしますか？

大規模リファクタ前に全体意図と統一設計を擦り合わせる軽量 Intent Planning workflow を、AI コーディングエージェント (Claude Code / Codex) の skill + scaffold として配置する npx インストーラ。

概要

ijust/intent-planner は、大規模なコードベースの変更に着手する前に、開発者の意図とAI エージェントの理解を整合させるためのワークフローを提供します。

• Claude Code (~/.claude/skills/) と Codex (~/.codex/skills/) に対応
• npx 一発でスキルファイルと scaffold をインストール
• 統一設計ドキュメント (INTENT.md など) を自動生成

インストール

npx ijust/intent-planner

手動インストール

リポジトリをクローンしてシンボリックリンクを作成することもできます:

git clone https://github.com/ijust/intent-planner.git ~/.intent-planner
ln -s ~/.intent-planner/skill.md ~/.claude/skills/intent-planner-skill.md

使い方

1. インストール後、AI エージェントに /intent-plan または Intent Planning を開始してください と指示します
2. プロンプトに従って以下の情報を入力:
   • 変更の全体的な目的
   • 制約条件
   • 統一設計の原則
3. AI エージェントが INTENT.md を生成し、設計の整合性を確認します
4. 承認後、段階的なコード変更を実行します

ワークフロー図

flowchart TD
    A[開発者が意図を説明] --> B[AI が INTENT.md を生成]
    B --> C{開発者が確認・承認}
    C -->|承認| D[段階的なリファクタリング開始]
    C -->|修正依頼| B
    D --> E[各変更が INTENT.md に沿っているか検証]

対応エージェント

エージェント	スキルディレクトリ	ステータス
Claude Code	~/.claude/skills/	✅ 対応済み
Codex	~/.codex/skills/	✅ 対応済み
Cursor	カスタム設定が必要	⏳ 開発中

設定

環境変数 INTENT_PLANNER_DIR で出力先ディレクトリを変更できます:

export INTENT_PLANNER_DIR=./docs/planning
npx ijust/intent-planner

ライセンス

MIT