タスクを開始する前に、関連する開発ガイドラインを読んでください。
以下の手順を実行します。
-
現在のタスク成果物を読む:
prd.mdから要件と受け入れ基準を確認design.mdが存在する場合は技術設計を確認implement.mdが存在する場合は実行順序と検証計画を確認
-
パッケージとその spec レイヤーを検出する:
python3 ./.trellis/scripts/get_context.py --mode packages -
タスクに適用される spec を特定する:
- 修正対象のパッケージ（例：
cli/、docs-site/） - 作業の種類（バックエンド、フロントエンド、ユニットテスト、ドキュメントなど）
- タスク成果物で参照されている spec/リサーチパス
- 修正対象のパッケージ（例：
-
関連モジュールの spec インデックスを読む:
cat .trellis/spec/<package>/<layer>/index.mdインデックス内の 「事前開発チェックリスト」 セクションに従ってください。
-
事前開発チェックリストに記載されている、タスクに関連する特定のガイドラインファイルを読む。インデックス自体が目的ではなく、実際のガイドラインファイル（例：
error-handling.md、conventions.md、mock-strategies.md）へのポインタです。これらのファイルを読んで、コーディング標準とパターンを理解してください。 -
常に共有ガイドを読む:
cat .trellis/spec/guides/index.md -
非自明なタスクの場合は、コードを書く前に変更境界を明示する。非自明とは、複数のファイルに影響する、レイヤーをまたぐ、パブリックインターフェースを変更する、または直前に書いたコード以外を編集する場合を指します。以下を書き留めてください:
- 現在の動作と期待される動作の間の最小の動作ギャップ
- その動作が実際に存在する場所（最もインターセプトしやすい場所ではない）
- 変更予定のファイルと、それぞれが必要な理由
- このタスクで明示的に行わないこと
- ローカルリファクタリングが必要な場合、動作を変更しなかったことをどのように示すか
スコープが小さく適切に定義された変更には、これは不要です。直接行ってください。
実際のスコープがこれよりも明らかに大きいことが判明した場合は、続行する前にその理由を説明してください。自分だけでスコープを広げないでください。
-
従うべきコーディング標準とパターンを理解したら、開発計画を進めてください。
このステップは、コードを書く前に必須です。