4
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

非エンジニア PdM が AI でドキュメント作成時間を 1/10 にした話

4
Posted at

TL;DR

  • 理想:PdMになって、社会、ユーザーの問題解決するぞー!
  • 現実:社内各所との調整、企画書、仕様書のドキュメント作成に追わる日々、、、あれ?

理想と現実のギャップを少しでも埋めるために、、、
AIで仕様書作成を半自動化する、「スラッシュコマンド」集を作りました。

結果 : 非エンジニアPdMでも、ドキュメント作成時間を1/10に改善できた!

私はエンジニアではありません。複雑なコードが書けるわけでもありません。 それでも、AIと相談しながら、自分の業務を劇的に効率化するツール 『Yodogawa』 を作成しました。

これは、非エンジニアがAIを相棒にして業務課題をハックした記録であり、同じ悩みを持つPdMへの共有です。(そんな大げさなものじゃないですw)

Yodogawa について

現物(恥ずかしい、、、)

npx yodogawa

このコマンドで、スラッシュコマンド集とドキュメントテンプレート集がレポジトリに召喚できます。

私が注目したのは、CursorやClaude Codeなどで使える「スラッシュコマンド」機能です。 既存の使用駆動開発用ツールの Speckit や SuperClaude も素晴らしいのですが、生成される仕様書がシンプルすぎて、いざ「バイブコーディング(AI任せの実装)」をすると、決められてないところでは自由に暴れたれてなもんで、バイブスが合わずに微妙な結果になることがありました。

「もっとこう、ガッツリ仕様を固めたいんだよなぁ...」 そう悩みながら淀川(Yodogawa)の河川敷を散歩しているときに、「あ、自分で作ればいいじゃん」と思いつきました。(ツール名の由来はそのままです)

このツールの最大の特徴は、AIによる徹底的な事情聴取です。 Speckitなどのようにサクッとは終わりません。あえて時間をかけ、AIがインタビュー形式で仕様を深掘りしてきます。

「この条件の時はどうしますか?」「エラーハンドリングは?」 と、AIに矢継ぎ早に質問される感覚は、まるで上司に仕様の甘さを詰められているかのよう。 「うっ...そこは考えてなかった...」と冷や汗をかきながら回答することで、結果的に抜け漏れのない完璧な仕様書が出来上がります。(Mっ気のある方には特におすすめです(笑))

実際の画面

1. プロジェクト設計・要件定義(A 系列)

要件定義やドメインモデル、システム設計など、プロジェクト全体の方向性を決めるドキュメントを作成するフェーズです。

1.png

「システム概要」や「機能一覧」「ドメインモデル」など、上流工程で必要な定義をAIと対話しながら作成します。まず、何で作るの?から、徹底的に詰められます!((((;゚Д゚))))ガクガク

2.png

可読性の高いGherkin 形式でシナリオを記述することで、エンジニアや事業側との目線合わせがしやすくなります。

3.png

作成されたドメインモデルを元に、画面遷移図、データモデルや API 仕様などのシステムの詳細を詰めていきます。もう、謎の画面、変な処理順は書かせないぜ。

2. タスク管理・実装計画(B、C 系列)

Jiraチケットのように個々の開発タスクについて、定義、リサーチ、実装計画を作成し、日々の開発サイクルを回すためのフェーズです。

4.png

タスクの目的、変更内容、受け入れ基準を明確にする「タスク定義書」を作成します。

5.png

リサーチステップを基に、実装タスクを具体化した「実装計画書」を自動生成します。これを、エンジニアに依頼したり、AIに依頼したりしています。

具体的な効果

「Yodogawa」を導入してから、私のPdMライフは激変しました。

  1. ドキュメント作成時間が 1/10 に(体感)
    「空いた時間で戦略立案を!」...と言いたいところですが、実際は**「面倒なドキュメント作成が一瞬で終わる快感」**が一番です。 今まで数時間かかっていた作業が、AIとの壁打ち(という名の尋問)を数回こなすだけで終わります。浮いた時間で、本来やるべきユーザーヒアリングや、美味しいコーヒーを飲む時間が確保できるようになりました。

  2. エンジニアからの「ツッコミ」が激減
    これまではエンジニアに「ここの異常系、どうなってます?」と突っ込まれて「あ、すんません...」となるのが日常でした。 しかし今は、AIが先に「ここの異常系はどうしますか?」と私を詰め...いや、確認してくれます。 AIという「最強の防壁」が事前に穴を塞いでくれるおかげで、エンジニアとの仕様確認がスムーズになり、平和が訪れました。

  3. 「書くのめんどくさい」からの解放
    「仕様書書かなきゃ...」という憂鬱なプレッシャーがなくなりました。「とりあえずコマンド叩いて、AIにインタビューされれば終わるか」と思えるだけで、心の余裕が段違いです。

使い方

使い方は非常にシンプルです。

  • 召喚: npx yodogawa を叩き、ワークフローをプロジェクトに読み込ませます。
  • 詠唱: エディタ上で Slash コマンドを入力し、タスク(PRD作成、ユーザーストーリーなど)を選びます。
  • 対話: あとはAIのインタビューに答えるだけ。あなたの思考が綺麗なドキュメントに変換されます。

現在は個人開発メインですが、ドキュメントをGit管理することで、チーム全体の知見として蓄積できると感じています。

今後の展望

「Yodogawa」はまだ完成形ではありません。今後は以下のような進化を考えています。

  • 作ったばかりのツールで、精度が悪い部分や、エンジニアからドキュメンテーションはこうしてほしい!など意見いただいているので、改善していきたい。皆様も、つたないツールですが使っていただいた感想などあればいただきたいです。
  • シェルスクリプトとの融合: AIの弱点である「揺らぎ」を排除するため、確定的な処理はスクリプトに任せて再現性を高める。
  • もっと上流から: 仕様書作成の前段階、「そもそも何を作るべきか?」という企画の壁打ちからサポートできるようにする。

おわりに

エンジニアじゃなくても、複雑なコードが書けなくても、AIと対話しながら自分だけのツールを作ることはできます。

もし興味があれば、ぜひ使ってみてください。 PdMの仕事は多岐に渡りますが、AIを相棒にして、面倒な作業は自動化し、本当に人間がやるべきことに全力を注げる環境を一緒に作っていきましょう!

4
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?