背景
taberu.pro での kobito iter 実運用で、エージェントが踏みやすい罠が3つ判明した。これらは Issue Template ではなく kobito の preset プロンプトに集約するのが筋なので、dotfiles で preset を管理して全プロジェクトに横展開したい。
参照: https://www.notion.so/dtsuji/kobito-35f334685a6880229b2acc868b676e6a の「kobito iter 実運用での気づき」セクション
反映したい制約
1. PR タイトルの冗長化対策
- kobito の Conventional Commits 自動生成がそのまま PR タイトルに流れて冗長になる
- preset に「PR タイトルは Conventional Commits 形式で 70 字以内」と明示
2. ローカルテスト実行のオーバーヘッド対策
- エージェントが反復ごとに
pnpm test を回してトークン・時間を浪費する
- preset に「ローカルでは型チェック・lint のみ実行、テスト本体は CI に任せる」と明示
gh pr checks --watch で CI 結果待ち → 落ちてたら fix → 再 push のフローを推奨
3. CI 未通過なのに TASK_COMPLETE 判定するバグ
- エージェントが完了宣言した時点で実は CI が落ちていたケースがあった
- preset に「
TASK_COMPLETE を emit する前に必ず gh pr checks で green を確認」と明示
やること
設計判断(要詰め)
- preset を 1 個に集約(
ralph-loop)か、用途別に分割(pr-conventions、ci-driven 等)か
- プロジェクト固有設定との合成方法(
{{var}} で project-specific value を差し込む)
- 既存 CLAUDE.md / AGENTS.md との役割分担(kobito README 曰く「プロジェクト規約はエージェントメモリに任せる」、preset は loop の制約のみ)
参考
背景
taberu.pro での kobito iter 実運用で、エージェントが踏みやすい罠が3つ判明した。これらは Issue Template ではなく kobito の preset プロンプトに集約するのが筋なので、dotfiles で preset を管理して全プロジェクトに横展開したい。
参照: https://www.notion.so/dtsuji/kobito-35f334685a6880229b2acc868b676e6a の「kobito iter 実運用での気づき」セクション
反映したい制約
1. PR タイトルの冗長化対策
2. ローカルテスト実行のオーバーヘッド対策
pnpm testを回してトークン・時間を浪費するgh pr checks --watchで CI 結果待ち → 落ちてたら fix → 再 push のフローを推奨3. CI 未通過なのに
TASK_COMPLETE判定するバグTASK_COMPLETEを emit する前に必ずgh pr checksで green を確認」と明示やること
kobito/presets/ディレクトリ作成ralph-loop.md(仮)preset を作成。上記3制約を含む~/.config/kobito/presets/への symlink を install スクリプトに追加(既存 dotfiles の symlink 運用に合わせる)kobito iter --preset ralph-loopの動作確認設計判断(要詰め)
ralph-loop)か、用途別に分割(pr-conventions、ci-driven等)か{{var}}で project-specific value を差し込む)参考
--presetフラグ、./.kobito/presets/<name>.mdまたは$XDG_CONFIG_HOME/kobito/presets/<name>.md