HagiCode の使い方 Tips

This FAQ reads the tips snapshot synchronized from Index during docs release builds and groups the advice into a browsable article.

Updated: 2026-06-0153 tipsData locale: ja-JPView source JSON on Index

Project Setup

8 items

セッションを始める前にプロジェクトを作成してください。HagiCodeがファイル、コンテキスト、履歴をまとめて管理できるようになります。
project-first
各プロジェクトは関連するコードと資料に絞ってください。セッションが無関係なコンテキストを読み込むのを防げます。
project-boundary
プロジェクト名には業務名やリポジトリ名を使うと、後から探しやすくなります。
project-name-clear
現在の目標をプロジェクトに記録しておくと、後のセッションで作業を素早く再開できます。
project-goal-note
起動手順、アカウント情報、よく使うコマンドはプロジェクトのメモにまとめておきましょう。毎回入力する手間が省けます。
project-docs
資料をアップロードする前に無関係なファイルを除外してください。HagiCodeがタスクに集中しやすくなります。
project-context-clean
新しいセッションを開く前に、正しいプロジェクトを選択してください。タスクが適切なコンテキストで実行されます。
project-before-session
プロジェクトの履歴を確認するときは、直近の完了セッションの結論から読み始めましょう。
project-history

Proposals and Scope

8 items

大きな変更を行う場合は、実装する前にHagiCodeに提案書を書いてもらうことをおすすめします。
proposal-large-change
提案の範囲を明確にしておきましょう。セッションが進むにつれて範囲が広がり続けるのを防げます。
proposal-scope
アプローチに迷ったときは、HagiCodeに複数の選択肢を提案してもらうよう依頼してください。
proposal-options
提案にリスクの注記を含めると、その変更を続けるべきかどうか判断しやすくなります。
proposal-risk
提案を個々のタスクに分割すると、実行の進捗を追いかけやすくなります。
proposal-tasks
実装に入る前に提案を確認しましょう。見落としや方向性の誤りに早く気付けます。
proposal-review
各提案には短く分かりやすい名前を付けてください。後から見つけやすくなります。
proposal-change-name
提案が完了したら結果を記録しておきましょう。なぜその変更を行ったかを後で振り返れます。
proposal-finish

Session Workflow

9 items

各セッションには明確な目標を一つだけ設定してください。結果を評価しやすくなります。
session-single-goal
セッションの最初に、目標・制約・期待する出力を直接伝えてください。
session-start-clear
以前のタスクを続けるときは、HagiCodeに最近の変更点を伝えてください。
session-context
長いセッションでは、随時HagiCodeに進捗の確認を求めましょう。
session-checkpoint
セッションを一時停止する前に、次のステップを記録しておくと再開時の手間が減ります。
session-stop-point
セッション終了後は、結果の要約を読んでから追加の質問を続けるか判断しましょう。
session-review-result
方向が違うと感じたら、すぐに訂正してください。最後に全部やり直すより早く解決できます。
session-correction
関連するファイルが分かっている場合は、ファイルパスをHagiCodeに直接伝えてください。
session-files
エラーが発生したときは、「失敗した」とだけ伝えるのではなく、エラーメッセージ全体をHagiCodeに送ってください。
session-errors

Multi-Session Coordination

5 items

セッションを並行して実行する前に、互いに競合しないように目標を分割してください。
multi-session-plan
並行セッションには分かりやすい名前を付けましょう。例えば「提案の設計」「フロントエンド実装」「トラブルシューティング」などです。
multi-session-naming
セッションを並行して実行する場合は、同じファイル群を編集しないようにしてください。
multi-session-isolation
並行セッションが終わったら、結果をまとめて確認してから採用する部分を決めましょう。
multi-session-merge
重要なタスクでは、あるセッションに実装を担当させ、別のセッションにレビューを担当させると効果的です。
multi-session-review

Agent Roles

6 items

各エージェントに明確な役割を与えてください。例えば、実装、レビュー、テスト、ドキュメントの整理などです。
agent-role
複数のエージェントが連携するときは、事前に責任の範囲を定義しておいてください。
agent-boundary
エージェント間で作業を引き継ぐときは、重要な結論・未完了の作業・留意事項を確実に引き継いでください。
agent-handoff
レビュー担当のエージェントは、一度に大規模な書き直しを行うより、問題を見つけることに専念させるのが適しています。
agent-review
調査担当のエージェントがまず背景情報を集め、その結果を実装担当のエージェントに引き継ぐとスムーズです。
agent-research
次のステップを素早く判断したいときは、エージェントに短い要約を求めてください。
agent-summary

Using Claude

3 items

Claudeは、長文の資料の分析、複数のアプローチの比較、複雑なコンテキストの整理に適しています。
claude-analysis
複雑な設計を行う前に、Claudeに推論の網羅性を確認してもらいましょう。
claude-design
大量のドキュメントを読む際は、Claudeに重要なポイントと制約事項の抽出を頼むことができます。
claude-docs

Using Codex

3 items

Codexは、リポジトリに加えてコードを編集し、コマンドを実行して結果を検証する作業に適しています。
codex-implementation
どこを変更すべきか分からないときは、まずCodexにプロジェクト構造を検索してもらいましょう。
codex-navigation
Codexが変更を行った後は、どのファイルが変更され、なぜその変更が必要だったかに注目してください。
codex-review-diff

code-server

4 items

コードを手動で確認したい場合は、code-serverでプロジェクトを開いてください。
code-server-open
小さな手動修正には、ローカル環境を切り替えるよりcode-serverの方が便利です。
code-server-edit
code-serverでコマンドを実行する前に、ターミナルが対象のプロジェクト内にあることを確認してください。
code-server-terminal
インターフェースを調整するときは、code-serverで実際の結果をプレビューしてください。
code-server-preview

OmniRoute

4 items

OmniRouteを使うと、複数のモデルを一箇所で管理でき、機能の切り替えが簡単になります。
omniroute-provider
単純なタスクには高速なモデルを、複雑なタスクには高性能なモデルを使い分けましょう。
omniroute-model-choice
モデルが利用できない場合、OmniRouteのフォールバックルートにより中断を減らせます。
omniroute-fallback
OmniRouteでは、タスクの重要度に応じて速度・品質・コストのバランスを調整できます。
omniroute-cost

HagiPower

3 items

Hagipowerはセッション全体のエネルギーと活動を記録するため、利用状況の推移を確認できます。
hagipower-overview
毎日のHagipowerの達成状況を確認して、コーディングの目標とストリークを維持しましょう。
hagipower-daily-achievement
短いタスクと集中するディープワークのセッションを組み合わせて、Hagipowerの消費バランスを保ちましょう。
hagipower-energy-balance