# タスク指示書

[nrslib]

タスク指示書

目的

既存の UnitTest ピースに準拠した新規 E2E テスト用ピースを実装し、TAKT の標準フローで選択・実行できる状態にする。
E2Eテストのフレームワークは現行採用のものをそのまま使用し、まずコードベース内を検索して特定すること。

作業項目

1. 現行E2Eフレームワークの特定（優先度: 高）

• 対象モジュール:
  • package.json
  • src/__tests__/ 配下
  • docs/、README.md、docs/README.ja.md
  • 既存のテスト実行設定ファイル（例: vitest.config.ts、Playwright/Cypress系設定ファイルがあればそれも）
• 作業内容:
  • リポジトリ内検索で現行のE2Eフレームワークを特定する
  • 実行コマンド・想定ディレクトリ・出力形式を確認する
  • 以降のピース設計でこのフレームワークを固定採用する

2. UnitTestピースの構造調査とE2E化設計（優先度: 高）

• 対象モジュール:
  • builtins/ja/pieces/ 内の UnitTest ピース
  • builtins/en/pieces/ 内の UnitTest ピース
• 作業内容:
  • 既存 UnitTest ピースの movement 構成、rules、instruction、report 形式を確認
  • E2E 用に必要な指示へ置換（テスト作成、実行、失敗解析、修正、再実行）
  • 既存運用に沿った命名を決定して新規ピースを定義

3. E2Eピースの実装（優先度: 高）

• 対象ファイル:
  • builtins/ja/pieces/<新規e2eピース名>.yaml（新規）
  • builtins/en/pieces/<新規e2eピース名>.yaml（新規）
• 作業内容:
  • JA/EN 両方で同等機能の E2E ピースを追加
  • 現行E2Eフレームワークの実行手順を instruction に反映
  • 既存 facet/persona を優先再利用し、不要な増築を避ける

4. カテゴリ・選択導線への反映（優先度: 中）

• 対象ファイル:
  • builtins/ja/piece-categories.yaml
  • builtins/en/piece-categories.yaml
• 作業内容:
  • 新規E2Eピースをカテゴリに追加し、takt switch 等で選択可能にする

5. テスト整備（優先度: 高）

• 対象モジュール:
  • src/__tests__/ のピース読込/一覧/カテゴリ関連テスト
• 作業内容:
  • 新規E2Eピースがロード・列挙・カテゴリ表示されるテストを追加/更新
  • 既存テストスイートで回帰がないことを確認

6. ドキュメント更新（優先度: 低）

• 対象ファイル:
  • README.md
  • docs/README.ja.md
  • 必要に応じてピース説明ドキュメント
• 作業内容:
  • 新規E2Eピースの用途、想定入力、実行内容を追記
  • UnitTestピースとの使い分けを明記

再現手順

1. takt switch で新規E2Eピースを選択できることを確認。
2. E2Eテスト作成タスクを投入して実行。
3. 現行E2Eフレームワークでテスト作成・実行・修正ループが動作することを確認。

確認方法

1. 新規E2Eピースが JA/EN 両方で読み込める。
2. カテゴリ表示に新規ピースが現れる。
3. 関連テストおよび全体テスト（少なくとも変更影響範囲）が成功する。
4. ドキュメントに利用方法が反映されている。

制約（ユーザー明示）

• E2Eテストのフレームワークは現行通りにすること。
• そのフレームワークが何かは、実装前にリポジトリ内検索で特定すること。

[nrslib]

Addressed in PR #190 (commit ec88b90). Release v0.11.0 (#197) でマージ済み。