scartill-sdd-lite

コマンド

• Save Spec - 永続的な仕様を保存します（プロンプト：sc.save.spec.md）
• Split Tasks - 独立したタスクを作成します（プロンプト：sc.split.tasks.md）
• Implement - 実装を実行します（プロンプト：sc.implement.tasks.md）
• Finalize - 実装後のアクションを実行します（プロンプト：sc.finalize.md）
• Critique - 仕様を批評します（プロンプト：sc.critique.spec.md、批評対象のファイルをパラメーターとして指定）
• Code Review - 実装をレビューします（プロンプト：sc.code.review.md）
• Archive - 古いプロジェクトドキュメントをアーカイブします（プロンプト：sc.archive.md）
• Brainstorm - 詳細なブレインストーミングを行います（プロンプト：sc.brainstorm.md、検討する問題をパラメーターとして指定）
• Seed - ブレインストーミングの最終結果をシードに変換します（プロンプト：sc.brainstorm.to.seed.md）
• Gate Input - 生の入力をサニタイズし、整理されたシード仕様を抽出して、PM フィードバックレポートを生成します（プロンプト：sc.gate.input.md、入力ドキュメントのパスをパラメーターとして指定）

すべてのプロンプトは <skill-dir>/prompts/ にあります。

有効化されたら、これらのコマンドを記憶しておきますが、ユーザーから明示的な依頼があるまで実行しないでください。

ガイダンス

仕様ワークフロー：シードと完全仕様

このプロジェクトでは、2 段階の仕様作成プロセスを採用しています。どちらも docs/ の下にあります。

シード仕様（docs/seed/）

シード仕様は、人が簡潔に書いた意図を示すドキュメントです。以下の内容を記録します。

• ユーザーが求めているもの（機能の意図、期待される動作）
• 重要な例と期待される出力形式
• 概要レベルの CLI インターフェースまたは設定の形式
• 後続のタスク（README の修正、例の追加など）

シード仕様は形式ばらない文書で、ユーザー自身の語り口で書かれており、誤字や略記が含まれる場合もあります。以下の内容は含みません。

• 詳細な実装ガイダンス
• 内部データモデルやコード構造
• テスト要件を含む明示的なタスク分解
• Mermaid 図やアーキテクチャの決定
• 既存のコードベース内部に関する背景情報

シード仕様は、設計フェーズへの入力です。

完全仕様（docs/specs/）

完全仕様は、シード仕様をもとに作成された詳細な実装設計書です。以下の内容を含みます。

• 問題の説明：要件を正確に言い換えたもの
• 要件：受け入れ基準の網羅的な一覧
• 背景：関連するコードベース内部の情報（既存のパターン、モジュール、データ構造）
• 提案するソリューション：Mermaid 図、データモデル、コードの概要を含むアーキテクチャ
• タスク分解：番号付きの実装タスク。それぞれに以下を含みます。
  • 目的
  • 実装ガイダンス（対象ファイル、従うべきパターン）
  • テスト要件（検証する内容、使用するフィクスチャ）
  • 検証用デモコマンド

完全仕様は、人間または AI の実装者が追加の確認なしに作業を実行できるように作成します。

ワークフロー

1. ユーザーが docs/seed/ にシード仕様を作成し、意図を記録します。
2. シードを実行可能な計画へと展開した完全仕様を docs/specs/ に作成します（ユーザー自身が作成するか、AI の支援を受けて作成します）。
3. 実装は、完全仕様のタスク分解に従って進めます。

機能の実装を依頼されたら、シード（意図を把握するため）と完全仕様（実装の詳細を把握するため）の両方を確認してください。シードしか存在しない場合は、先に完全仕様を作成することを提案してください。