Story / Spec / 追跡性

VibeProでは、StoryとSpecをAI作業の文脈として扱います。Storyは変更の目的を示します。Specは、守るべき振る舞いや制約を、VibeProがコード、テスト、PR証跡と照合しやすい形で表します。

Storyの流れ

AIにコード変更を頼む前に、Storyを作るか選択します。

vibepro story add . --id <story-id> --title "<title>"
vibepro story select . --id <story-id>
vibepro story status .

すでに作業があるリポジトリから候補を出す場合です。

vibepro story derive . --run-graphify
vibepro story plan .
vibepro story map . --json

特定Storyを深く見る場合です。

vibepro story diagnose . --id <story-id> --run-graphify
vibepro story report . --id <story-id>

Specの流れ

まずStory、コード、テスト、手順の文脈をまとめたfingerprintを作ります。

vibepro spec fingerprint . --id <story-id> --include-instructions > spec-fingerprint.json

生成したSpecはVibePro経由で書き込みます。これにより、参照元のパス、パターン、条項IDが検証されます。

vibepro spec write . --id <story-id> --from-stdin --caller codex < spec.json
vibepro spec show . --id <story-id>
vibepro spec drift . --id <story-id> --against origin/main

Specは人間が最初から完璧に手書きする契約書ではありません。VibeProがずれを検出するための、機械で扱える表現です。

追跡性

追跡性は、受入条件を実装、テスト、PR証跡につなぎます。

vibepro trace backfill . --story-id <story-id> --dry-run
vibepro trace declare . --story-id <story-id> --lifecycle declared_not_started --reason "<reason>"

まだ実装がないStoryは trace declare で明示します。すでにコードやテストがある場合は trace backfill でStoryに結びます。

文章生成物

PR本文や判断記録のような文章生成物には、report fingerprintを使います。

vibepro report fingerprint . --kind pr-body --id <story-id> --include-instructions
vibepro report write . --kind pr-body --id <story-id> --from-stdin --caller codex
vibepro report show . --kind pr-body --id <story-id>