workflow

ワークフロー

高速なソロ開発。アイデアから本番環境まで同日中に実現します。

エージェントの機能

機能	用途	必須	代替手段
ファイルの読み書き	仕様、設定、履歴	はい	—
コード検索（grep/glob）	調査、コンテキストの把握	はい	—
シェル／コマンドの実行	品質ゲート（lint、build、test）	はい	ユーザーが実行するコマンドを提示
コードベースのインテリジェンス（npx codebase-intelligence）	TS/TSX プロジェクトの構造分析（グラフ、メトリクス、影響範囲）	いいえ	grep/glob/read（手動で調査）
タスク／ToDo の追跡	フェーズ管理	推奨	spec の Progress セクションで追跡
ユーザーとの対話	行き詰まりの報告、リスクの提示	推奨	spec の Notes に判断を記録
Web／ドキュメント検索	パターンの検索	いいえ	組み込みのパターンを使用

代替手段のルール： エージェントに機能がない場合は、代替手段を使ってください。ワークフローのステップを省略せず、方法を調整してください。

コマンド

コマンド	アクション	参照
plan {idea}	spec を作成	plan.md
spike {question}	時間を区切った調査	spike.md
ship / ship {idea}	実装と検証	ship.md
fix / fix {bug}	科学的なデバッグと回帰修正	fix.md
review	行単位・ルール単位の網羅性を備えた、持ち運び可能な多角的レビュー仕様	review.md
spec-review	敵対的な観点からの仕様分析	spec-review.md
focus	優先順位の分析とタスクの提案	focus.md
done	検証、振り返り、アーカイブ	done.md
drop	学びを残して中止	drop.md
workflow	状態の表示と次のアクションの提案	Status（下記）

フラグは不要です。エージェントはコンテキストから意図を自動検出します。

• 「spec をレビューして」→ 手動レビューのために一時停止
• 「テストをスキップして」→ テストゲートをスキップ（記録します）
• 「このバグを修正して」→ 回帰テストを含む専用のバグ修正
• 「緊急修正」→ spec の手順を省略
• 「本番環境に対応できる状態にして」→ 本番向けの検証

フロー

Features: focus → plan {idea} → ship → [implement/review/fix loop] → done
Bug fixes: fix {bug} → [investigate/TDD/validate] → done

クイックモード（2時間未満）：ship {idea} → done 何に取り組めばよいかわからない場合：focus

方針

• 仕様優先：すべての作業に spec が必要です（なければ作成します）
• 出荷ループ：ビルド → レビュー → 問題がなくなるまで修正
• 品質ゲート：lint → typecheck → build → test → E2E → coverage（プロジェクトごとに自動検出）
• E2E ファーストのテスト：E2E テストを標準とします。ユニットテストは純粋関数にのみ使用します
• TDD を徹底：AC ごとに RED → GREEN → REFACTOR の順に進めます。実装前にテストを作成します（必須）
• モックの境界：実システムを優先します。サンドボックスのないサードパーティ API のみモックします（最終手段）
• AC 主導のカバレッジ：すべての Must Have + Error AC を、シナリオレジストリ内の E2E テストに対応させます
• 回帰防止：バグ修正には E2E 回帰テストとアンチカスケード差分が必要です（必須）
• 失敗モードのテスト：HIGH/MED の失敗仮説ごとに、防御的な E2E テストを作成します
• デプロイの制御は人間が担う：エージェントがコードを書き、あなたがプッシュ／デプロイします
• 同日中に完了：今日中に出荷できる範囲に絞ります
• 計画は自分で作成：ホストエージェントに組み込まれた計画モード（EnterPlanMode など）は使わないでください。このスキルは specs/active/ に実際の spec ファイルを作成します。

Spec の段階

段階	規模	Spec	タスク追跡
trivial	<5 LOC	なし — そのまま実行	いいえ
micro	<30 LOC	コード内のインラインコメント	いいえ
mini	<100 LOC	最小限の Spec ファイル	はい（利用可能な場合）
standard	100+ LOC	チェックリスト付きの完全な spec	はい（利用可能な場合）

アクションルーター

User input
  │
  ├─ "plan", "spec", "design"           → Load references/actions/plan.md
  ├─ "spike", "explore", "investigate"   → Load references/actions/spike.md
  ├─ "ship", "implement", "build"         → Load references/actions/ship.md
  ├─ "fix", "debug", "repair"            → Load references/actions/fix.md
  ├─ "review", "check code"              → Load references/actions/review.md
  ├─ "review spec", "analyze spec",
  │  "challenge spec"                    → Load references/actions/spec-review.md
  ├─ "focus", "what should i do",
  │  "prioritize", "overwhelmed"         → Load references/actions/focus.md
  ├─ "done", "finish", "complete"        → Load references/actions/done.md
  ├─ "drop", "abandon"                   → Load references/actions/drop.md
  └─ "workflow", "what's next", "what now",
     "what's up", "whats up", "status"  → Status Action (below)

読み込みルール： 実行前にアクションファイルを読んでください。アクションファイルには、必要なロジック、タスクテンプレート、参照情報がすべて含まれています。

ステータスアクション

個別のアクションファイルはありません。ロジックはここに直接記述されています。現在の状態を検出し、次のアクションを提案します。

1. Check specs/active/ for active spec
2. Check git status for uncommitted work
3. Check task list for in-progress items

State → Suggestion:
  No spec, no changes    → "Ready. Run: plan {idea}"
  Active spec, no code   → "Spec ready. Run: ship"
  Active spec, code WIP  → "In progress. Run: ship (resumes)"
  Active spec, code done → "Ready to close. Run: done"
  No spec, dirty tree    → "Uncommitted work. Run: ship (creates spec) or done"

出力：status-output.mdに従ってください。

プロジェクト構成

specs/
  active/       ← Current work (0-1 specs)
  backlog/      ← Queued work from focus
  shipped/      ← Completed features
  dropped/      ← Abandoned with learnings
  history.log   ← One-line per feature shipped/dropped

設定

スキルファイルを直接編集することで、すべての動作を設定できます。

変更する内容	編集するファイル
アクションのロジック、ゲート、上限	references/actions/{action}.md
出力形式	references/templates/{action}-output.md
仕様の構成	references/spec-template.md
品質ゲートのコマンド／レベル	references/quality-gates.md
セッションの再開、行き詰まりの検出	references/session-management.md

参考資料

アクション：

• 計画 | リリース | 修正 | レビュー | 仕様レビュー | 集中 | 完了 | 破棄 | スパイク

出力テンプレート：

• 計画＋仕様レビュー | リリース | 修正 | レビュー | 集中 | 完了 | 破棄 | スパイク | ステータス

レビュー基準：

• 移植可能なコアレビュー仕様 | 実行パターン | 本番環境の基準

移植可能なレビュー仕様は規範的なものです。実行パターンは任意の実装ガイダンスです。

仕様とゲート：

• 仕様テンプレート | 品質ゲート | セッション管理 | メモリの更新 | テストの自動化 | E2Eシナリオ | コードベースのインテリジェンス

パターン：

• 実装 | 計画 | デバッグ | 意思決定 | 分解 | 回帰テスト