posimai-kit/docs/workflow.md

1.7 KiB
Raw Permalink Blame History

フロー詳細

全体の流れ

00_clarify  →  仕様をまとめるproject-brief
                    ↓
10_breakdown →  タスクに分解するtasks
                    ↓
20_implement  ←─────────────────────┐
                    ↓               │
30_review   →  Approve?             │
                    ↓ No            │
              指摘を修正 ───────────┘
                    ↓ Yes
              次のタスクへ / 完了

途中で動かなくなったら 40_debug に寄ってから 30_review に戻る。


ステップごとの補足

00: 仕様整理

AIに渡す前に、自分の「作りたいもの」をメモするだけでよい。 箇条書きでも文章でも、整理されていなくてもよい。

出力を手元に保存しておくと、後のステップで参照できる。

10: タスク分解

「1タスクが大きすぎる」場合はAIに「もっと細かく分けて」と頼む。 目安は「完了したかどうか自分で判断できる粒度」。

20: 実装

必ず1タスクずつ進める。まとめて実装するとレビューが複雑になる。

30: レビュー

CriticalHigh の指摘は必ず修正する。
Medium 以下は「今やるか後にするか」を自分で判断してよい。

40: デバッグ

エラーメッセージとログをそのままAIに貼るだけで、原因を絞り込んでくれる。


やってはいけないこと

  • 「なんとなく動いてそう」でレビューを省略する
  • 複数タスクをまとめて実装する
  • APIキーを直接コードに書く必ず .env を使う)