ドキュメント

PM on Railsの使い方

まず、自分の立場で何が変わるかを読んでから、操作に進んでください。新しく始める方はクイックスタート、招待された方はメンバー管理、日々の進み具合は進捗の見える化へ。

自分の立場から読む

操作の前に、自分の困りごとと、画面で何が変わるかを確認できます。詳しい説明は立場別ガイド、画面の操作はこの下のページにあります。

発注・内製化

機能リストで始めてしまい、リリースで「違う」となる。

PM on Railsのロードマップ。サイクルや四半期の予定と、今作っているまとまりが並ぶ。任せきりにせず、現在地を自分で見る画面。 — いつリリースされるかを自分で見る
サイクルや四半期の予定と、今作っているまとまりが見えます。進捗率の書類ではなく、今どこまで進んでいるかを確認できます。

発注・内製化の方へ

文書を整えることが仕事になり、範囲が膨らむ。

PM on Railsの確認事項。聞くべきこと、宛先、回答状態が一覧になる。ヒアリングで固める前の未決事項が、この一覧に残る。 — 確認すべきことが一覧になる
未決事項、質問文、回答待ちが並びます。機能を積み上げる前に、まだ決まっていないことだけを確認できます。

PMの方へ

エンジニア

機能リストとタスク名だけを渡され、推測で実装している。

PM on RailsのClaude Code / Codex連携。背景、完成条件、タスク、PRがつながったまま渡る。完成条件が無いまま書かせないための連携。 — 完成条件を読んで実装する
Claude Code連携の画面です。要求、完成条件、タスクを開発AIが読みます。機能リストだけで当てさせません。

エンジニアの方へ

確認する人

業務を知っている側に、完成の基準がない。

対象者別ガイド

はじめに

PM on Railsとは

ヒアリングだけで固めて発注すると、現場で使われないものができる。いまとこれから、なぜ今か、なぜこのプロダクトか。

クイックスタート

新規利用・招待参加から、資料の登録、スコープ確定、最初の作業まで。

対象者別ガイド

失敗の出方は、役割で違う。いまとこれから、次に見る画面。

基本のことば（用語と関係）

プロジェクト・要求・要件・ストーリー・シナリオ・タスクなど主要概念を非エンジニア向けに。

おすすめの運用（フェーズ別）

全フェーズ共通の操作のリズム（AIが叩き台 → 人が確定）と、要件定義から実装・テスト・仕様変更のループまでのフェーズ別の使い方。

要求をまとめる（PMの流れ）

ナレッジに集める

議事録・資料・音声・Word/Excelを集約し、版管理・レビューする。

要求カードを作る

要求カードの自動生成・スコアリング・5Why・FM優先度・重複検出・採用判断。

スコープを確定する（MoSCoW）

作る・作らないをMoSCoWで合意し、優先度を整理する。

設計してタスクに落とす

ユーザーストーリー・シナリオ

要求からストーリーを起こし、Gherkinの受入シナリオで「できたらOK」を定義する。

基本設計（API設計・DB設計）

要件をもとにAPI設計書・DB設計書を作る。AI叩き台とmermaid図（ER図・シーケンス図）に対応。

タスク管理

タスク種別・担当・優先度・期限・見積もり・AI見積もり・ラベル・カンバン4状態・サブタスク階層・PR紐付け。

バグと変更管理

バグ起票・影響範囲・解決記録・再発防止の要件化・変更リクエスト・版管理。

開発して届ける

Claude Web / Claude Code / Codexで管理・開発する

UIで整えた要求を、MCPでClaude Web / Claude Code / Codexから管理・実装する体験。

Claude Web・Claude Code・MCP連携

Claude Web / Claude Code / Codex等からMCPでグラフを操作。使い分けと活用例。

MCP機能リファレンス

PM on Rails MCPで何ができるかを日本語で網羅。必要な人向けにツール名も併記。

GitHub連携

MCP開発フローの出口連携。Issue同期・PR紐付け・マージで自動done。

変更の追従と差分チェック

議事録の再取り込みによる自動更新・差分チェック・影響範囲・変更通知・更新マーカー。

進捗を管理する

進捗の見える化

開発の準備・自分の作業・進捗と管理の使い分け、PR連携、ロードマップ、開発サイクル。

テスト

受入シナリオの合否と、ストーリーに紐づかないタスクの確認結果を集約。完成度を要求から実装まで把握。

処理状況・履歴（バックグラウンド処理）

時間のかかる処理を画面を止めずに実行。進捗・完了・失敗の確認。

AI機能

AIのしくみ

なぜ普通の検索や汎用チャットより、的確に答えられるのか。

AIアシスタント（プロンプト網羅）

こう話しかけるとこうなる。調べる・作る・気づく、の具体プロンプト集。

管理と設定

メンバーと権限

ワークスペース招待・プロジェクト参加・ロール・可視性の考え方。

関係者（ステークホルダー）の管理

関係者の連絡先の管理・タグ分類・viewer招待。

確認事項

AIレビューなどで出た「ステークホルダーに確認すること・自分たちで決めること」を横断で集め、回答・解決まで管理する。

フィードバック

ステークホルダーや利用者の指摘を、対象画面・理想・現状・再現手順つきで受け取る。

通知とSlack

割当・メンション・期限・遅延・招待受諾・開発サイクル完了、Slack(毎朝の開発状況サマリー)、ダイジェスト、未読・スヌーズ。

設定

メンバー・連携・AIモデル選択・キャパシティ・トークン発行のまとめ。

Macデスクトップアプリ（ベータ）

Mac版（ベータ）の入手、ブラウザからの受け渡し、メニューバー常駐、通知、共有リンクとオフライン時の挙動。

リファレンス

リバースエンジニアリング（既存システム解析）

改修案件で、既存システムを解析して現状・制約を可視化し、改修要求につなげる。

決定の記録（要求の判断・ADR）

延期・対象外の判断履歴と、設計上の意思決定（ADR）を残す。

よくある質問

つまずきやすいポイントと対処。

CI・テスト連携

CIからテスト結果を自動記録する

GitHub Actions の JUnit XML を、PM on Rails の受入シナリオへ token なしで自動記録する手順。