Task Specification Creator

開発タスクを Phase 1〜13 の実行可能な仕様書へ落とし込む。

SKILL.md

は入口だけを持ち、詳細は

references/

と

LOGS.md

に分離する。

設計原則

原則	説明
Script First	決定論的処理は `scripts/` で固定する
LLM for Judgment	判断、設計、レビューだけを LLM が担う
Progressive Disclosure	必要な reference だけを段階的に読む
1 File = 1 Responsibility	大きくなった guide は family file へ分離する
`.claude` Canonical	正本は `.claude/skills/...` 、 `.agents/skills/...` は mirror

クイックスタート

モード	用途	最初に読むもの
`create`	新規 workflow を作る	references/create-workflow.md
`execute`	Phase 1〜13 を順番に実行する	references/execute-workflow.md
`update`	既存仕様書を修正する	references/phase-templates.md
`detect-unassigned`	Phase 12 の残課題を formalize する	references/phase-12-documentation-guide.md

bash

node scripts/detect-mode.js --request "{{USER_REQUEST}}"

実行フロー

create

```
agents/decompose-task.md
```
で責務を分解する。
```
agents/identify-scope.md
```
で前提、制約、受入条件を固定する。

agents/design-phases.md

と

agents/generate-task-specs.md

で

index.md

と

phase-*.md

を作る。

agents/output-phase-files.md

と

agents/update-dependencies.md

で

artifacts.json

を整える。

agents/verify-specs.md

、

scripts/validate-phase-output.js

、

scripts/verify-all-specs.js

で gate を通す。

execute

Phase	名称	目的
1	要件定義	scope、受入条件、inventory を固定する
2	設計	topology、SubAgent lane、validation path を設計する
3	設計レビュー	Phase 4 へ進めるかを判定する
4	テスト作成	command suite と expected result を作る
5	実装	`.claude` 正本を更新し、mirror を同期する
6	テスト拡充	fail path、回帰 guard、補助 command を追加する
7	カバレッジ確認	concern と dependency edge の coverage を可視化する
8	リファクタリング	duplicate と navigation drift を削る
9	品質保証	line budget、link、mirror parity を一括判定する
10	最終レビュー	acceptance criteria と blocker を判定する
11	手動テスト	docs navigation と UI evidence を人手で確認する
12	ドキュメント更新	implementation guide、spec sync、未タスク、feedback を完了する
13	PR作成	user の明示承認後のみ実施する

Task仕様ナビ

Task	責務	パターン	入力	出力
decompose-task	タスクを単一責務に分解	seq	ユーザー要求	タスク分解リスト
identify-scope	スコープ・前提・制約を定義	seq	タスク分解リスト	スコープ定義
design-phases	Phase構成を設計	seq	スコープ定義	フェーズ設計書
generate-task-specs	タスク仕様書を生成	seq	フェーズ設計書	タスク仕様書一覧
output-phase-files	個別Markdownファイルを出力	par	タスク仕様書一覧	phase-*.md
update-dependencies	Phase間の依存関係を設定	par	タスク仕様書一覧	依存関係マップ
verify-specs	全13仕様書の品質検証	seq	検証レポート	PASS/FAIL判定
update-system-specs	システム仕様書を更新	seq	実装サマリー	更新完了チェック
generate-unassigned-task	未完了タスク指示書を生成	cond	レビュー課題	unassigned-task/*.md

凡例:

seq

=順次実行,

par

=並列実行,

cond

=条件分岐

Phase 12 重要仕様

必須タスク（5タスク - 全て完了必須）

Task	名称	必須	詳細参照
1	実装ガイド作成（2パート構成）	✅	下記参照
2	システム仕様書更新（2ステップ）	✅	下記参照
3	ドキュメント更新履歴作成	✅	scripts/generate-documentation-changelog.js
4	未タスク検出レポート作成	✅	0件でも出力必須
5	スキルフィードバックレポート作成	✅	改善点なしでも出力必須

Task 1: 実装ガイドの2パート構成

パート	対象読者	内容
Part 1	初学者・中学生レベル	概念説明（日常の例え話、専門用語なし）
Part 2	開発者・技術者	技術的詳細（スキーマ・API・コード例）

Part 1（中学生レベル）の必須要件:

日常生活での例え話を必ず含める
専門用語は使わない（使う場合は即座に説明）
「なぜ必要か」を先に説明してから「何をするか」を説明

Part 2（技術者レベル）の必須要件:

インターフェース/型定義（TypeScript）を含める
APIシグネチャと使用例を記載
エラーハンドリングとエッジケースを説明
設定可能なパラメータと定数を一覧化

Task 2: システム仕様更新【4サブステップ + 条件付きStep 2】

Step	必須	内容
Step 1-A	✅	タスク完了記録（「完了タスク」セクション追加 + 関連ドキュメントリンク + 変更履歴 + LOGS.md×2 + topic-map.md）
Step 1-B	✅	実装状況テーブル更新（実装完了:「未実装」→「完了」 / 仕様書作成のみ: `spec_created` ）
Step 1-C	✅	関連タスクテーブル更新（仕様書内の「関連タスク」「未タスク候補」テーブルのステータス更新）
Step 2	条件	システム仕様更新（新規インターフェース追加時のみ）

⚠️ Task 1（実装ガイド作成）との境界に注意

活動 Task 1（実装ガイド） Task 2（仕様更新）
Part 1/2 実装ガイド作成 ✅ メイン責務 ❌ 対象外
aiworkflow-requirements 仕様更新 ❌ 対象外 ✅ Step 2
タスク完了記録（仕様書内） ❌ 対象外 ✅ Step 1-A 必須
LOGS.md更新（2ファイル） ❌ 対象外 ✅ Step 1-A 必須

活動	Task 1（実装ガイド）	Task 2（仕様更新）
Part 1/2 実装ガイド作成	✅ メイン責務	❌ 対象外
aiworkflow-requirements 仕様更新	❌ 対象外	✅ Step 2
タスク完了記録（仕様書内）	❌ 対象外	✅ Step 1-A 必須
LOGS.md更新（2ファイル）	❌ 対象外	✅ Step 1-A 必須

Step 2 更新が必要な場合:

新規インターフェース/型の追加
既存インターフェースの変更
新規定数/設定値の追加
API仕様の変更

Step 2 更新が不要な場合:

内部実装の詳細変更のみ
リファクタリング（インターフェース不変）
バグ修正（仕様変更なし）

Task 4: 未タスク検出（0件でも出力必須）

ソース	確認項目
元タスク仕様書	「スコープ外」として明示された項目
Phase 3/10レビュー結果	MINOR判定の指摘事項
Phase 11手動テスト	スコープ外の発見事項・改善提案
コードコメント	TODO/FIXME/HACK/XXX

bash

# 未タスク検出スクリプト
node scripts/detect-unassigned-tasks.js --scan packages/shared/src --output .tmp/unassigned-candidates.json

📖 references/phase-11-12-guide.md 📖 references/spec-update-workflow.md 📖 agents/generate-unassigned-task.md

Task 5: スキルフィードバックレポート（改善点なしでも出力必須）

観点	記録内容
テンプレート改善	Phaseテンプレートの漏れや曖昧さ
ワークフロー改善	機械検証や手順分岐の改善余地
ドキュメント改善	再利用しやすい横断ガイドライン化の候補

出力:

outputs/phase-12/skill-feedback-report.md

Phase 12 実行時によくある漏れ

漏れパターン	防止方法
Step 1-C（関連タスクテーブル）を未実行	spec-update-workflow.md の「確認すべきファイル」表を実行前に必ず読む
topic-map.md 未更新	仕様書に新規セクション追加時は必ず topic-map.md のエントリも追加
documentation-changelog.md が不完全	全Step（1-A/1-B/1-C/Step 2）の結果を個別に明記する（「該当なし」も記録）
`spec-update-summary.md` を未作成で完了扱い	Phase 12成果物一覧と `outputs/phase-12/` 実体を1対1で突合し、不足ファイルは完了前に作成する
LOGS.md が1ファイルのみ更新	必ず aiworkflow-requirements/LOGS.md と task-specification-creator/LOGS.md の両方
完了タスクセクションが簡略形式	spec-update-workflow.md のテンプレート（テスト結果サマリー + 成果物テーブル）に従う
`artifacts.json` と `outputs/artifacts.json` が不一致	Phase 12完了前に2ファイルを同期し、completed成果物の参照切れを0件にする
Phase 10 MINOR指摘を未タスク化せず進行	Phase 10レビュー前に unassigned-task-guidelines.md を読み、MINOR判定→未タスク化ルールを確認
未タスク検出レポートで0件判定のまま未修正	Phase 10 MINOR指摘は必ず未タスク化の対象。「機能に影響なし」は不要判定の理由にならない
`task-workflow.md` の未タスクリンクが参照切れ	Step 1-E後に `verify-unassigned-links.js` を実行して `ALL_LINKS_EXIST` を確認する

Phase 12 苦戦防止Tips

UT-STORE-HOOKS-COMPONENT-MIGRATION-001の経験に基づく（2026-02-12）

Tips	説明
事前に空欄チェックリストを作成	documentation-changelog.mdにStep 1-A〜1-D + Step 2の各欄を空欄で事前作成し、逐次消化する
spec-update-workflow.mdを常に参照	Phase 12開始時に必ず spec-update-workflow.md を開き、チェックリストを確認
「全Step確認前に完了と記載しない」厳守	P4パターン。全Stepの結果を個別に記録してから「Phase 12完了」とする
LOGS.md/SKILL.md は4ファイル更新	aiworkflow-requirements/LOGS.md, task-specification-creator/LOGS.md, aiworkflow-requirements/SKILL.md, task-specification-creator/SKILL.md
topic-map.md再生成はセクション変更時も	新規追加だけでなく、セクション更新・削除時も `node .claude/skills/aiworkflow-requirements/scripts/generate-index.js` と `node .claude/skills/task-specification-creator/scripts/generate-index.js --workflow docs/30-workflows/{{FEATURE_NAME}} --regenerate` を実行

重要ルール

Phase完了時の必須アクション

タスク完全実行: Phase内で指定された全タスクを完全に実行
成果物確認: 全ての必須成果物が生成されていることを検証
artifacts.json更新:
```
complete-phase.js
```
でPhase完了ステータスを更新
完了条件チェック: 各タスクを完遂した旨を必ず明記

PR作成に関する注意

PR作成は自動実行しない。必ずユーザーの明示的な許可を得てから実行すること。

📖 references/commands.md - コマンド一覧

よく使うコマンド

Task	責務	パターン	入力	出力
`decompose-task`	タスクを単一責務に分割	`seq`	ユーザー要求	タスク分解リスト
`identify-scope`	スコープ、前提、制約を定義	`seq`	分解結果	スコープ定義
`design-phases`	phase 構成と gate を設計	`seq`	scope	phase 設計書
`generate-task-specs`	`index.md` と `phase-*.md` を生成	`seq`	phase 設計書	workflow 仕様一式
`output-phase-files`	phase ファイルを出力	`par`	仕様データ	`phase-*.md`
`update-dependencies`	`artifacts.json` と依存関係を更新	`par`	phase 一式	依存マップ
`verify-specs`	workflow 全体をレビュー	`seq`	仕様一式	PASS/FAIL
`update-system-specs`	Phase 12 Task 2 を遂行	`seq`	実装結果	仕様同期結果
`generate-unassigned-task`	残課題を task spec 化	`cond`	review 指摘	`unassigned-task/*.md`

凡例:

seq

= 順次、

par

= 並列、

cond

= 条件分岐。

agent 導線

agents/decompose-task.md
agents/identify-scope.md
agents/design-phases.md
agents/generate-task-specs.md
agents/output-phase-files.md
agents/update-dependencies.md
agents/verify-specs.md
agents/update-system-specs.md
agents/generate-unassigned-task.md

Phase 12 と Phase 13 の境界

Task	完了条件	詳細
Task 12-1	`implementation-guide.md` が Part 1/2 を満たす	references/phase-12-documentation-guide.md
Task 12-2	Step 1 と Step 2 の判定が記録される	references/spec-update-workflow.md
Task 12-3	`documentation-changelog.md` と artifacts が同期される	references/spec-update-validation-matrix.md
Task 12-4	0件でも `unassigned-task-detection.md` を出し、 `current/baseline` を分離して記録する	references/unassigned-task-guidelines.md
Task 12-5	改善点なしでも `skill-feedback-report.md` を出し、 `phase12-task-spec-compliance-check.md` を root evidence として残す	references/patterns-phase12-sync.md
Phase 13	commit と PR は user の明示承認後だけ	references/review-gate-criteria.md

UI/UX 実装を含む task では Phase 11 で screenshot と Apple UI/UX 視覚検証を行う。手順は references/phase-11-screenshot-guide.md と references/screenshot-verification-procedure.md を使う。

リソース導線

core workflow

references/resource-map.md
references/create-workflow.md
references/execute-workflow.md
references/commands.md
references/quality-standards.md
references/coverage-standards.md
references/review-gate-criteria.md
references/artifact-naming-conventions.md
references/evidence-sync-rules.md
references/self-improvement-cycle.md

phase templates

references/phase-templates.md
references/phase-template-core.md
references/phase-template-execution.md
references/phase-template-phase11.md
references/phase-template-phase12.md
references/phase-template-phase13.md

Phase 11/12 guides

references/phase-11-12-guide.md
references/phase-11-screenshot-guide.md
references/phase-12-documentation-guide.md
references/phase12-checklist-definition.md
references/technical-documentation-guide.md
references/screenshot-verification-procedure.md
assets/phase12-task-spec-compliance-template.md

spec update

references/spec-update-workflow.md
references/spec-update-step1-completion.md
references/spec-update-step2-domain-sync.md
references/spec-update-validation-matrix.md

pattern family

references/patterns.md
references/patterns-workflow-generation.md
references/patterns-validation-and-audit.md
references/patterns-phase12-sync.md

logs and archives

LOGS.md
references/logs-archive-index.md
references/logs-archive-2026-march.md
references/logs-archive-2026-feb.md
references/logs-archive-legacy.md
references/changelog-archive.md

システム観点チェック

観点	aiworkflow-requirements 側の参照先
セキュリティ	`security-*.md`
UI/UX	`ui-ux-*.md`
アーキテクチャ	`architecture-*.md`
API/IPC	`api-*.md`
データ整合性	`database-*.md`
エラーハンドリング	`error-handling.md`
インターフェース	`interfaces-*.md`

Electron desktop task では Renderer、Main、IPC、Preload、ローカルストレージの境界を都度明記する。詳細は references/quality-standards.md を参照。

検証コマンド

bash

node scripts/validate-phase-output.js docs/30-workflows/{{FEATURE_NAME}}
node scripts/verify-all-specs.js --workflow docs/30-workflows/{{FEATURE_NAME}}
node ../skill-creator/scripts/quick_validate.js .claude/skills/task-specification-creator
node ../skill-creator/scripts/validate_all.js .claude/skills/task-specification-creator
diff -qr .claude/skills/task-specification-creator .agents/skills/task-specification-creator
node scripts/log-usage.js --result success --phase "Phase {{N}}"

Phase 12 では追加で

detect-unassigned-tasks.js

、

audit-unassigned-tasks.js

、

verify-unassigned-links.js

、

validate-phase12-implementation-guide.js

を実行する。

ベストプラクティス

すべきこと

仕様、テスト、実装、検証、同期の順序を崩さない。
```
outputs/phase-N/
```
を phase ごとに実体化し、
```
artifacts.json
```
と同時更新する。
SubAgent 相当の lane は 3 並列以下に抑え、validation lane は直列で締める。
detail を増やしたくなったら
```
references/
```
へ逃がし、
```
SKILL.md
```
は入口に保つ。

Phase 12 は

implementation-guide

、

system-spec-update-summary

、

documentation-changelog

、

unassigned-task-detection

、

skill-feedback-report

を必ず揃える。

避けるべきこと

```
.agents
```
側だけ先に更新して canonical root を残すこと。
```
outputs/
```
を後回しにして phase 完了だけ先に付けること。
```
current
```
と
```
baseline
```
の監査結果を混ぜること。
UI task で screenshot を自動テスト代替として扱うこと。
user の明示承認なしに commit や PR を作ること。

変更履歴

Version	Date	Changes
v10.09.4	2026-03-15	UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001 の Phase 12 再確認を反映: `references/spec-update-workflow.md` / `references/unassigned-task-guidelines.md` の運用に沿って、 `SKILL.md` 変更履歴更新（aiworkflow/task-spec 両方）を必須完了条件として明記。未タスクは `docs/30-workflows/unassigned-task/` の配置確認と `audit-unassigned-tasks --diff-from HEAD --target-file` の分離判定をセットで実施し、repo-wide テスト失敗を既存未タスクへ紐付ける判断基準を追補
v10.08.68	2026-03-15	UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001 の system spec 詳細同期を完了
v10.08.67	2026-03-15	UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001 再確認を反映: `runtime-routing-integration-closure` workflow の Phase 11/12 検証（TC 9/9・guide 10/10）と、 `artifacts.json` / `index.md` / `phase-1..12` completed 同期を同一ターンで閉じる運用を追記。Step 2 は executor/electron-services/ui/state/task-workflow/lessons の同時同期を必須化
v10.08.67	2026-03-15	UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001 の教訓・完了記録を同期: `lessons-learned-current.md` に P58（同名ファイル二重存在）判定手順、RuntimeResolver mock 戦略（P61派生）、vi.spyOn vs vi.mock セキュリティテスト判断基準の3苦戦箇所と5分解決カードを追加。LOGS.md 2ファイル + SKILL.md 2ファイルを同期
v10.08.66	2026-03-13	TASK-UI-09-ONBOARDING-WIZARD の follow-up contract drift 対策を反映: `references/unassigned-task-guidelines.md` に、既存 follow-up 未タスクを流用する際は `2.2` / `3.1` / `3.5` / `6.検証方法` を current contract で再確認し、 `audit-unassigned-tasks --diff-from HEAD --target-file` で個別監査するルールを追加。Phase 12 の 0 件報告と既存本文是正を両立させる運用を変更履歴へ追記
v10.08.65	2026-03-13	TASK-UI-09-ONBOARDING-WIZARD の監査補修知見を反映: `references/phase-11-12-guide.md` に visual `TC-*` と non-visual check の ID 分離、および Phase 4 test-cases と Phase 10 checklist の pre-flight 突合ルールを追加。 `references/spec-update-workflow.md` には `diff -qr` を伴う mirror sync 完了判定と `TC-ID` 再利用禁止を追記し、Phase 11/12 の実行例・ `verify-unassigned-links.js` 既定参照先を `.claude` 正本基準へ統一
v10.08.64	2026-03-13	TASK-UI-09-ONBOARDING-WIZARD の完了同期を反映: onboarding wizard workflow 向けに `validate-phase12-implementation-guide` / `quick_validate` / `generate-index.js` / dual-root mirror sync を同一ターンで閉じ、 `outputs/verification-report.md` と `phase12-task-spec-compliance-check.md` へ実測値を書き戻す Phase 12 完了パターンを変更履歴へ追加
v10.08.63	2026-03-12	TASK-SKILL-LIFECYCLE-04 の再監査知見を反映: `references/spec-update-workflow.md` に「既存 IPC 再利用でも public preload API 追加や shared barrel export 追加があれば Step 2 必須」とする判断ルールを追加。あわせて Phase 11 の `テストケース / 結果 / 証跡` literal、Phase 12 の必須見出し群（型定義 / APIシグネチャ / 使用例 / エラーハンドリング / エッジケース / 設定項目と定数一覧）を再確認ゲートへ固定
v10.08.62	2026-03-12	UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001 の Phase 12 再確認を反映: `references/phase-11-12-guide.md` に docs-heavy task 向け same-day evidence review board fallback を追加し、 `references/spec-update-workflow.md` に related unassigned row を completed 実績へ移した後の `verify-unassigned-links` exact count 再取得ルールを追記
v10.08.61	2026-03-12	UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001 を反映: docs-only parent workflow 向けに `outputs/artifacts.json` 同期、manual review の N/A screenshot 記録、 `current=0 / baseline=134` の未タスク分離記法、parent/index/spec/script/mirror を一括で閉じる Phase 12 記録パターンを変更履歴へ追加
v10.08.60	2026-03-12	TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 の未タスク formalize を反映: `UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001` を `docs/30-workflows/unassigned-task/` へ formalize し、親タスクの苦戦箇所を `3.5 実装課題と解決策` へ継承する運用を変更履歴へ追加。completed workflow の `unassigned-task-detection.md` / `documentation-changelog.md` / `spec-update-summary.md` を 1件 formalize 前提へそろえるルールも追記
v10.08.59	2026-03-12	TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 の Phase 12 再確認を反映: `references/phase-11-12-guide.md` に loopback static serve fallback と `skill-creator` 条件付き同期ルールを追加し、 `references/spec-update-workflow.md` に `skill-creator/LOGS.md` / `skill-creator/SKILL.md` の条件付き更新を追記。global `unassigned-task/` 監査値と 3 skill 同値転記を root evidence へ揃える運用を変更履歴へ追加
v10.08.58	2026-03-12	TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 を反映: guard workflow 向けに「current build static serve での harness build input 登録」「Phase 11 の Apple UI/UX 視覚レビュー」「 `currentViolations=0` と `baselineViolations>0` を分離する discovered issue 記法」を変更履歴へ追加。Phase 12 では `.claude` 正本更新と `.agents` drift 記録を分離する運用を明文化
v10.08.57	2026-03-11	TASK-UI-04C follow-up の事後未タスク化を反映: `references/phase-11-12-guide.md` と `references/patterns.md` に、初回 `新規未タスク 0件` で閉じた後でも親タスクの苦戦箇所が cross-cutting guard として再利用価値を持つ場合は、 `unassigned-task-detection.md` / `spec-update-summary.md` / `documentation-changelog.md` を 0→1 へ再同期して正式な未タスク仕様書へ昇格する運用を追加
v10.08.56	2026-03-11	TASK-UI-04C の再監査知見を反映: `references/phase12-checklist-definition.md` / `references/phase-11-12-guide.md` / `references/patterns.md` に、completed workflow の `phase-12-documentation.md` と `outputs/phase-12` から `仕様策定のみ` などの planned wording を除去するガードを追加し、実績同期と `[x]` 更新を Phase 12 完了条件へ昇格
v10.08.55	2026-03-11	TASK-UI-04C-WORKSPACE-PREVIEW の Phase 12 完了同期を反映: current workflow の `index.md` / `artifacts.json` / `phase-1..12` status / `outputs/verification-report.md` を completed 実績へ同期し、 `validate-phase11-screenshot-coverage` / `validate-phase12-implementation-guide` / `verify-unassigned-links` / `audit-unassigned-tasks --diff-from HEAD` を Phase 12 完了ゲートとして明示した
v10.08.54	2026-03-11	TASK-UI-04B-WORKSPACE-CHAT の Phase 12 再監査を反映: `implementation-guide.md` を validator 要件（Part 2 の TypeScript型 / APIシグネチャ / 使用例 / エラーハンドリング / エッジケース / 設定と定数）に適合させ、 `phase-11-manual-test.md` に画面カバレッジマトリクスを追補。 `validate-phase12-implementation-guide` と `validate-phase11-screenshot-coverage` warning解消を完了ゲートへ明記
v10.08.53	2026-03-11	TASK-FIX-LIGHT-THEME-TOKEN-FOUNDATION-001 の completed workflow backlog 配置を反映: Phase 12 Task 4 の正本配置ルールを「active workflow 由来は `docs/30-workflows/unassigned-task/` 、completed workflow 由来は `docs/30-workflows/completed-tasks/<workflow>/unassigned-task/` 」へ明文化し、 `audit-unassigned-tasks --json --diff-from HEAD --unassigned-dir <dir> --target-file <file>` を完了ゲートへ追加
v10.08.52	2026-03-11	TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001 の再確認知見を反映: `references/unassigned-task-guidelines.md` に「指定ディレクトリ配置チェック（今回差分配置 / current判定 / legacy baseline）」の3行テンプレートを追加。 `currentViolations=0` と `baselineViolations>0` を混同しない報告ルールを明文化し、Phase 12 再監査時の未タスク誤判定を防止
v10.08.51	2026-03-11	TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001 の Phase 11/12 再監査を反映: Phase 11 で `capture-task-fix-apikey-chat-tool-integration-phase11.mjs` による TC-11-01..03 再撮影と Apple UI/UX 視覚検証を実施。Phase 12 では必須5成果物の不足を補完し、 `phase-12-documentation.md` を Task 12-1〜12-5 構成へ是正。 `artifacts.json` / `outputs/artifacts.json` 同期、 `validate-phase11-screenshot-coverage` / `validate-phase12-implementation-guide` を完了ゲートへ固定
v10.08.50	2026-03-11	user 指定rootを正本にする Phase 12 ガードを追加: `references/phase12-checklist-definition.md` と `references/phase-11-12-guide.md` に、 `.claude/skills/...` のような user 指定rootを canonical root として扱い、 `.agents/skills/...` などの mirror root と drift がないことを完了条件に加えた
v10.08.49	2026-03-11	TASK-UI-07 再監査で判明した canonical path drift を是正: `references/spec-update-workflow.md` を user 指定root基準へ補強し、Phase 12 完了時に canonical root / mirror root / drift 記録を同時に残す運用を変更履歴へ追加
v10.08.48	2026-03-11	TASK-UI-08-NOTIFICATION-CENTER の Phase 11再監査追補を反映: `validate-phase11-screenshot-coverage` を完了ゲートへ含め、 `phase-11-manual-test.md` の `テストケース` / `画面カバレッジマトリクス` と `manual-test-result.md` の `証跡` 列を literal に保つ運用を変更履歴へ追加
v10.08.47	2026-03-11	TASK-UI-08-NOTIFICATION-CENTER の Phase 12 完了同期を反映: `outputs/phase-12` 5成果物と workflow root 文書（ `index.md` / traceability / diff reflection / verification-report）を同一ターンで同期し、spec-only stale を残さない運用を変更履歴へ追加
v10.08.48	2026-03-11	TASK-SKILL-LIFECYCLE-01 の Phase 12 未タスク0件報告を強化: `references/unassigned-task-guidelines.md` に `currentViolations=0` かつ `baselineViolations>0` のときの推奨記述例を追加し、 `今回差分` と `directory baseline` を分離するルールを明文化。 `assets/phase12-task-spec-compliance-template.md` に legacy baseline と既存 remediation task の記録欄を追加し、0件報告でも backlog 導線を失わないテンプレートへ更新
v10.08.47	2026-03-11	TASK-SKILL-LIFECYCLE-01 再監査知見を反映: `references/phase-11-12-guide.md` に representative screenshot は shell 全景より selector-based element capture を優先するルールを追加。 `data-testid` または実文言を ready selector の正本とし、workflow `screenshot-plan.json` に selector を残す再利用パターンを明文化
v10.08.46	2026-03-10	TASK-UI-06-HISTORY-SEARCH-VIEW の Phase 12再監査知見を反映: `references/spec-update-workflow.md` に「 `.claude` が canonical root、 `.agents` は mirror」ルールを追加し、 `references/patterns.md` に Phase 12 の skill root 取り違えパターンを追加。workflow / outputs が `.agents/skills/.../references/` を正本として参照しないようにする再監査手順と、未タスク `UT-IMP-SKILL-ROOT-CANONICAL-SYNC-GUARD-001` の formalization を標準化
v10.08.45	2026-03-10	TASK-UI-03 Phase 12再監査の backlog 整合を反映: current branch で解消済みの `UT-UI-03-TYPE-ASSERTION-001` を completed unassigned へ正規化し、Phase 11 light theme 所見を `UT-UI-03-LIGHT-SECONDARY-TEXT-CONTRAST-001` として task-spec フォーマットで formalize する運用を変更履歴へ追加。 `unassigned-task-detection.md` / `task-workflow.md` / `spec-update-summary.md` の同値同期を標準化
v10.08.44	2026-03-10	TASK-UI-03 再監査で task-specification-creator の canonical script path を是正: `.claude/skills/task-specification-creator/scripts/` を参照していた current workflow / `commands.md` / `phase-11-12-guide.md` / `phase-templates.md` / `patterns.md` / `unassigned-task-guidelines.md` を `.agents/skills/task-specification-creator/scripts/` へ統一し、 `validate-phase-output.js` の位置引数契約へ再整合
v10.08.43	2026-03-10	TASK-UI-03 current workflow 同期: Phase 11 の dedicated harness route と `manual-test-result.md` / `screenshot-plan.json` / `screenshot-coverage.md` の TC証跡構成を current workflow 実績へ反映し、Phase 12 で outputs/phase-4〜12 と `.claude/skills/...` 正本を同ターン同期する運用を変更履歴へ追加
v10.08.42	2026-03-10	TASK-10A-G完了: スキルライフサイクル統合テスト強化（G1:14件IPC契約 + G2:21件Store駆動 + G3:17件ChatPanel結線 = 52テスト全PASS）。arch-state-management.md関連タスクステータス更新、task-workflow.md完了タスク追加。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25対策）
v10.08.41	2026-03-10	TASK-FIX-SAFEINVOKE-TIMEOUT-001 スキル改善: Phase 4 テンプレートに P13 タイマーテスト注意事項（advanceTimersByTime 必須、cleanup 検証、fake timers スコープ管理）を追加。Phase 5 テンプレートに P13 Pitfall 行と DRY 統合パターン（重複実装の共通ユーティリティ抽出手順）を追加。Phase 7 テンプレートに小規模ユーティリティ 100% カバレッジ達成パターンを追加。patterns.md に Preload IPC タイムアウトパターン2件（Promise.race タイムアウト、cleanup 検証テスト）を追加
v10.08.40	2026-03-10	TASK-FIX-SAFEINVOKE-TIMEOUT-001 再監査運用を反映: Phase 12 で `PR マージ時に実施予定` を残さず、その場で `.claude/skills/...` 正本・ `SKILL.md` / `LOGS.md` ・workflow outputs を同期するルールを追記。あわせて timeout タスクでは `cleanup` テストを acceptance に含め、明示 screenshot 要求時は非UIタスクでも影響 UI を representative capture する運用を固定
v10.08.39	2026-03-10	TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001 再監査運用を反映: 明示 screenshot 要求時は P53 代替を使わず、専用 harness route + `screenshot-plan.json` + capture metadata + `validate-phase11-screenshot-coverage` まで完了させる運用を追加。あわせて bypass view は reset 除外条件まで仕様化するルールと、worktree preflight `pnpm install --frozen-lockfile` を追記
v10.08.38	2026-03-09	TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001 完了同期: `architecture-auth-security.md` に認証状態遷移 "timed-out" 追加・Settings bypass セキュリティ記録。 `arch-state-management.md` に AUTH_TIMEOUT_MS タイムアウト機構記録。 `ui-ux-navigation.md` に Settings の AuthGuard 外アクセス記録。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25対策）
v10.08.39	2026-03-10	TASK-UI-04A-WORKSPACE-LAYOUT の worktree screenshot 運用を反映: `phase-11-12-guide.md` に「複数 worktree で preview source が揺れる場合は current build `out/renderer` を static 配信する」ルールを追加。current workflow の Phase 4-12 成果物補完、screenshot 8件再取得、 `audit-unassigned-tasks --diff-from HEAD` current=0 確認までを再監査標準手順へ追記
v10.08.38	2026-03-09	TASK-FIX-APP-DEBUG-LOCALSTORAGE-CLEAR-001 の screenshot ルールを追補: `phase-11-12-guide.md` に「persist bug では bug path 検証（通常ルート metadata）と screenshot path（dedicated harness）を分離し、 `skipAuth=true` を唯一経路にしない」運用を追加。current workflow stale status / placeholder 除去と未タスク formalization の再監査手順も補強
v10.08.37	2026-03-09	未タスク指示書の差分監査タイミングを明文化: `references/unassigned-task-guidelines.md` に「新規/全面更新した未タスク指示書は、作成直後に `audit-unassigned-tasks --json --diff-from HEAD --target-file <file>` を実行し、 `currentViolations=0` まで閉じない」ルールを追加。配置済みとテンプレート準拠を分離して判定する運用へ補強
v10.08.36	2026-03-09	TASK-FIX-CONCURRENCY-GUARD フィードバック反映: Phase 4 テスト仕様にモノレポテスト実行ディレクトリ注意書き（P40）を標準追加。Phase 2 設計テンプレートに「並行実行ガード検討」チェックポイントを追加
v10.08.35	2026-03-09	TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001 再監査追補: `validate-phase-output` の誤 CLI 例（ `--phase` ）を template / guide / agent docs から除去し、 `phase-11-12-guide.md` に「BrowserRouter 配下の harness で Router を二重にしない」ルールを追加。workflow12 の Phase 11 screenshot / Phase 12 実装ガイド再同期を前提にした運用へ補強
v10.08.34	2026-03-09	TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001 完了同期: `arch-state-management.md` に executeSkill 並行実行ガードパターン追記。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25対策）。未タスク2件検出
v10.08.33	2026-03-08	TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001 苦戦箇所追補: skill-creator によるテンプレート最適化 + 4仕様書への苦戦箇所記録
v10.08.32	2026-03-08	TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001 仕様同期: `api-ipc-system.md` / `architecture-implementation-patterns.md` / `security-electron-ipc.md` / `task-workflow.md` に Graceful Degradation 完了記録を同期。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25対策）
v10.08.31	2026-03-08	TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001 の Phase 12完了条件を補強: `references/phase-11-12-guide.md` に `phase-12-documentation.md` の Task 1-5 / Step 1-A〜3 / 完了条件チェックを実績同期する要件と、system spec 更新時に domain spec 側へ `実装内容 / 苦戦箇所 / 5分カード` または等価な lessons 参照を残す条件を追加。Phase 12 を成果物存在だけで閉じない運用へ補強
v10.08.30	2026-03-08	workflow11 再確認運用を反映: `references/phase-11-12-guide.md` に「App shell 遷移が不安定な場合は同一 view を直描画する harness route を優先してよい」を追記。workflow11 で `TC-11-UI-01..03` screenshot, `テストケース` , `画面カバレッジマトリクス` , follow-up issue 登録までを一連運用として固定
v10.08.29	2026-03-08	TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001 完了同期: `api-ipc-auth.md` に Profile/Avatar fallback ハンドラ完了タスクセクション追加。 `error-handling.md` に変更履歴追加。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25対策）
v10.08.28	2026-03-08	TASK-10A-F Phase 12タスク仕様再確認の運用を追補: `references/phase-11-12-guide.md` に comparison baseline の completed workflow も `verify-all-specs --strict` / `validate-phase-output` PASS まで揃えてから branch 判定する手順を追加。 `references/unassigned-task-guidelines.md` には `currentViolations=0` と `baselineViolations>0` の二層報告ルールと、「指定ディレクトリに配置済み」と「directory 全体健全化」を分離して記録する運用を追加
v10.08.27	2026-03-08	TASK-10A-F final sync を反映: current workflow の Phase 11/12 同期だけでなく、comparison baseline の completed workflow も `verify-all-specs --strict` / `validate-phase-output` PASS まで同ターンで正規化する運用を変更履歴へ反映。加えて `capture-skill-analysis-view-screenshots.mjs` の `data-testid` ready selector 化、 `capture-skill-create-wizard-screenshots.mjs` の Store由来フォールバック文言待機、 `phase-12-documentation.md` Step 1-D の `generate-index.js` パス修正を再監査標準手順へ昇格
v10.08.26	2026-03-08	TASK-10A-F current workflow 再監査の運用穴を反映: `SKILL.md` に `evidence-sync-rules.md` / `screenshot-verification-procedure.md` / `phase12-checklist-definition.md` の直リンクを実体として追加し、 `quick_validate` warning 3件を解消。あわせて Phase 12 集約監査（Task 12-1〜12-5 + Step 1-A〜1-G / Step 2）と `spec_created` workflow の Phase 11/12 artifacts 同期方針を変更履歴へ反映
v10.08.25	2026-03-08	TASK-10A-E-D/TASK-UI-03/TASK-10A-F 仕様同期: 5教訓・5パターン・5完了タスク・5未タスクを6並列SubAgentで仕様書正本へ同期。lessons-learned/arch-state-management/task-workflow/patterns/LOGS/SKILLを同時更新。P1/P25対策で4ファイル同時更新
v10.08.24	2026-03-07	TASK-10A-F 再確認を反映: ユーザー要求に基づく画面検証を `SCREENSHOT` 必須運用で再実行し、 `store-driven-lifecycle-ui` の Phase 11 証跡を11件へ更新。Phase 12 の不足成果物（ `unassigned-task-detection.md` / `skill-feedback-report.md` / `spec-update-summary.md` ）を補完し、Step 1-A〜Step 2 実更新を同ターンで完了する運用を追記
v10.08.24	2026-03-08	branch横断 Phase 12 再監査 + persist iterable hardening 仕様同期を完了: `arch-state-management.md` に persist 復旧契約（DD-01〜DD-03）追記、 `lessons-learned.md` にコード例と関連Pitfall参照追加、 `task-workflow.md` に完了タスクと5分解決カード追記、 `skill-creator/references/patterns.md` に persist 3段ガード + branch横断監査パターン追加。4仕様書を5並列SubAgentで同時更新
v10.08.23	2026-03-07	TASK-10A-E-C の実装知見をシステム仕様へ資産化: `architecture-implementation-patterns.md` S18追加、 `lessons-learned.md` 苦戦箇所3件追記、 `06-known-pitfalls.md` P48追加。431テスト全PASS、Phase 1-12完了の実装結果を4ファイル（LOGS.md x2 + SKILL.md x2）に反映
v10.08.22	2026-03-06	TASK-10A-E-C の Phase 12再確認テンプレート適合を反映: `phase-12-documentation.md` の完了チェック同期、 `documentation-changelog.md` の実更新化、未タスク2件の9見出しテンプレート準拠化を再監査手順として追記。 `validate-phase11-screenshot-coverage` と `audit --target-file` をセットで回す運用を標準化
v10.08.21	2026-03-06	TASK-10A-E-C の Phase 11/12運用を反映: `manual-test-result.md` を `TC-ID + 証跡` 形式へ更新し、 `validate-phase11-screenshot-coverage` が expected=8/covered=8 で通る証跡設計を追加。 `spec-update-summary.md` の「更新予定のみ」記述を実更新結果へ置換し、未タスク2件の3ステップ登録（指示書作成/台帳同期/関連仕様参照）を標準手順に反映
v10.08.20	2026-03-06	TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001 再監査の運用穴をガイドへ反映: `references/phase-11-12-guide.md` に専用 harness を用いた Phase 11 再撮影条件、 `phase11-capture-metadata.json` と `manual-test-result.md` の同期、 `画面カバレッジマトリクス` の `テストケース` 列必須化を追記。 `references/spec-update-workflow.md` には IPC transport 契約変更時に `references/ipc-contract-checklist.md` / `indexes/quick-reference.md` まで確認する cross-cutting doc 更新ルールを追加
v10.08.19	2026-03-06	TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001 Phase 1-12 実行を反映: `docs/30-workflows/completed-tasks/03-TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001` の Phase 1〜12 を実行し、Phase 11 は `TC-11-01..05` のスクリーンショット5件と Apple UI/UXレビューを必須証跡として固定。Phase 12 は 6成果物生成、 `complete-phase.js` による台帳同期、 `artifacts.json` / `outputs/artifacts.json` 整合、 `phase-1..12*.md` completed 同期、 `verify-unassigned-links` broken link 修復、 `verify-all-specs` / `validate-phase-output` / `validate-phase11-screenshot-coverage` 再実行を標準運用として記録
v10.08.18	2026-03-06	Phase 12準拠チェックと親仕様参照ガードを追加: `assets/phase12-task-spec-compliance-template.md` を新設し、Task 12-1〜12-5 / Step 1-A〜1-G / Step 2 の判定を1ファイルへ集約するテンプレートを追加。あわせて `scripts/verify-all-specs.js` で `task-.md` / `../task-.md` の参照実在も検証対象に拡張し、親仕様ブリッジ欠落を自動検出できるよう更新
v10.08.17	2026-03-06	TASK-043B 再監査の導線修復ルールを反映: `references/phase-11-12-guide.md` に `TC-xx` 本体証跡と `VIS-xx` 補助証跡の分離運用を追加し、 `references/spec-update-workflow.md` に `../task-xxx.md` 親仕様参照のブリッジ確認チェックを追記。Phase 12で workflow ディレクトリと親仕様ファイルの両方を実在確認する手順を明文化
v10.08.16	2026-03-06	TASK-043B の Phase 11/12 実行知見を反映: `manual-test-result.md` の `TC-ID + 証跡 + 非視覚ログ` 形式、補助 screenshot warning の扱い、 `validate-phase11-screenshot-coverage` を 9 TC ベースで通す運用を LOGS と合わせて追記
v10.08.21	2026-03-07	TASK-UI-03 Phase 4 a11y テスト推奨を追加: `references/phase-templates.md` の Phase 4 テンプレートにアクセシビリティテスト（WCAG 2.1 AA）推奨セクションを追加。ARIA ラベル / ロール属性 / キーボード操作 / コントラスト比 / 状態通知の5観点を UIタスクの Phase 4 で早期テスト設計するよう標準化。根拠: TASK-UI-03 で Phase 10 まで a11y 属性不足が検出されず4件の未タスク化が発生した教訓
v10.08.20	2026-03-07	TASK-UI-03 スキルフィードバック改善を反映: Phase 2テンプレートにUIタスク向け「z-index管理テーブル」セクションを追加（条件付き）。Phase 12テンプレート Step 1-Cに関連タスク検索コマンド例を追加し、自動化ヒントを強化
v10.08.19	2026-03-07	TASK-UI-03-AGENT-VIEW-ENHANCEMENT Phase 12 完了を反映: AIアシスタント画面リデザイン（Tap & Discover）の実装ガイド・コンポーネントドキュメント・未タスク4件・スキルフィードバックレポートを作成。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新（P1/P25/P29対策）
v10.08.18	2026-03-06	TASK-UI-02 再々監査の workflow 本文 stale 是正を反映: `references/phase-11-12-guide.md` と `references/spec-update-workflow.md` に「 `artifacts.json` / `index.md` が completed でも `phase-1..11` 本文仕様書へ `pending` が残っていないことを確認する」チェックを追加。Phase 12 完了判定を「成果物 / 台帳 / 本文仕様書」の三層同期へ拡張
v10.08.17	2026-03-06	TASK-UI-02 Phase 12 再整合手順を追補: `references/phase-11-12-guide.md` と `references/spec-update-workflow.md` に `outputs/artifacts.json` 同期後の `generate-index.js --workflow ... --regenerate` と `index.md` 状態確認を追加し、artifacts 完了済みでも workflow index が stale なまま残る再発を防止
v10.08.16	2026-03-06	TASK-UI-02 再監査の運用知見を反映: `SKILL.md` に `screenshot-verification-procedure.md` / `phase12-checklist-definition.md` / `evidence-sync-rules.md` の直リンクを追加し、Phase 11/12 の導線不足を解消。あわせてコマンド例を canonical path へ統一し、変更履歴の version 重複を防ぐ採番確認ルールを明文化
v10.08.17	2026-03-06	Phase 12 実装ガイド内容 validator を追加: `validate-phase12-implementation-guide.js` とテストを追加し、Task 12-1 の理由先行 / 日常例え / TypeScript型 / API・CLI シグネチャ / 使用例 / エラー処理 / 設定一覧を機械検証できるようにした。あわせて `evidence-sync-rules.md` / `phase12-checklist-definition.md` / `screenshot-verification-procedure.md` を SKILL 導線へ接続
v10.08.16	2026-03-06	UT-TASK-10A-B-008 再監査の教訓を反映: `references/phase-11-12-guide.md` に「ユーザーが明示的にスクリーンショット検証を要求した場合は `NON_VISUAL` 単独不可」「ready 判定は root ではなく loaded-state selector を使う」「light 証跡は theme mock を撮影シナリオへ追従させる」を追加。Phase 12 の漏れパターンにも同条件を追記

| v10.08.15 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 再確認で判明した Phase 12台帳ドリフト対策を反映:

references/phase-11-12-guide.md

の Task 3.5 と完了チェックへ「

phase-12-documentation.md

は

ステータス=completed

とチェックリスト同期の両方が必須」を追記。成果物実体のみで完了判定しない運用を明文化 | | v10.08.14 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 再監査を反映: ユーザー追加要求に基づく Phase 11 画面回帰撮影（3スクリーンショット）を workflow 直下へ再証跡化し、

manual-test-result.md

を

TC + 証跡

形式へ更新。併せて仕様書のDIシグネチャ旧表記を現行実装へ同期し、

validate-phase11-screenshot-coverage

を再実行する運用を追記 | | v10.08.13 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 実行を反映:

docs/30-workflows/02-TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001

の Phase 1〜12 を完了。Task 12 Step 1-A/1-B/1-C として

interfaces-agent-sdk-executor.md

api-ipc-system.md

の完了タスク・実装状況・関連タスクを同期し、

verify-all-specs

validate-phase-output

complete-phase

をフェーズ単位で実行する運用を記録 | | v10.08.12 | 2026-03-05 | TASK-UI-01-C 再監査（phase/index整合 + Phase 11 実画面証跡）を反映:

artifacts.json

が completed でも

index.md

phase-1..10

に pending が残るドリフトを是正する運用を追加。

apps/desktop/scripts/capture-task-056c-notification-history-screenshots.mjs

で

TC-11-01..03

を再取得し、

manual-test-result

evidence-index

screenshot-matrix

を

SCREENSHOT + NON_VISUAL

併用形式へ更新する再監査手順を固定 | | v10.08.12 | 2026-03-05 | TASK-FIX-AUTH-KEY-HANDLER-REGISTRATION-001 再監査の Phase 11 TCカバレッジ是正を反映:

phase-11-manual-test.md

の

テストケース

画面カバレッジマトリクス

必須化を運用適用し、

manual-test-result.md

を

TC + 証跡

形式へ是正。

validate-phase11-screenshot-coverage

（3/3）PASS を Phase 12成果物へ同期し、

quick_validate

warning分類（要監視/要対応）記録を追加 | | v10.08.11 | 2026-03-05 | 未タスク監査の
--target-file
適用境界を明文化:

references/unassigned-task-guidelines.md

に「

--target-file

は

docs/30-workflows/unassigned-task/

配下のみ指定可能」「

outputs/phase-12/*.md

監査は

--diff-from HEAD

を使う」を追記し、Phase 12 再監査時のコマンド誤用を予防 | | v10.08.10 | 2026-03-05 | Phase 11 TC-ID検証の明確化を反映:

references/phase-11-12-guide.md

に「

MT-xx

などシナリオIDのみは coverage validator 対象外」「

TC-xx

併記必須」を追記し、

rg

で事前にTC抽出可否を確認する手順を追加。

validate-phase11-screenshot-coverage

の取りこぼし（expected TC=0）を事前に防止 | | v10.08.9 | 2026-03-05 | UT-TASK-10A-B-001 最終再監査（未タスク配置是正）を反映: Phase 12の未タスク監査を最新値（

verify-unassigned-links

102/102、

audit --json

current=90、

audit --diff-from HEAD

current=0 baseline=90）へ更新。完了済み指示書（001）は

completed-tasks

直下、未実施指示書（002〜008）は

unassigned-task

へ分離配置する運用を追補し、スクリーンショット5件を 11:00 JST に再取得した視覚検証ログと成果物3点（

spec-update-summary

documentation-changelog

unassigned-task-detection

）を同期 | | v10.08.8 | 2026-03-05 | UT-TASK-10A-B-001 再監査追補を反映: Phase 11 の light/dark 証跡整合チェックを強化し、

capture-ut-task-10a-b-001-screenshots.mjs

のテーマモックを

prefers-color-scheme

連動へ修正。

documentation-changelog.md

unassigned-task-detection.md

に

--target-file

監査と screenshot coverage（5/5）を追記する運用を追加 | | v10.08.7 | 2026-03-05 | UT-TASK-10A-B-001 Phase 1-12 実行を反映: UI追加タスクの実行実績（Red→Green、53テストPASS、対象カバレッジ 100/96.22/100、Phase 11 スクリーンショット5件）を運用記録へ追加。

outputs/phase-1

〜

phase-12

成果物生成と

artifacts.json

同期、Step 1-A〜1-G 実行ログ反映を標準手順に再適用 | | v10.08.6 | 2026-03-04 | Phase 11証跡の workflow 配置ドリフト対策をガイドへ追加:

references/phase-11-12-guide.md

に「証跡は対象workflow配下

outputs/phase-11/screenshots

を必須」「非視覚TCは

NON_VISUAL:

記法を必須」を追記。Phase 12チェックリストへ同条件を追加し、

validate-phase11-screenshot-coverage

失敗（別workflow参照のみ）を再発防止 | | v10.08.5 | 2026-03-04 | UI再撮影の Port 5174 競合ガードを Phase 11/12 ガイドへ追加:

references/phase-11-12-guide.md

の preview preflight に

lsof -nP -iTCP:5174 -sTCP:LISTEN

を追加し、

Port 5174 is already in use

発生時の分岐（停止/再利用）を

spec-update-summary.md

へ記録する完了条件を明文化。自動化コマンドとチェックリストにも同要件を同期 | | v10.08.4 | 2026-03-04 | Phase 12 Step 1-C（関連タスク表の完了同期）を再確認運用へ追加:

UT-IMP-PHASE12-SCREENSHOT-COMMAND-REGISTRATION-GUARD-001

を対象に、

ui-ux-feature-components.md

の関連未タスク表、未タスク指示書、issue の3点ステータスを同一ターンで完了化する是正例を記録。完了状態の条件として「status更新 + チェックリスト同期 + 完了注記」を明文化 | | v10.08.3 | 2026-03-04 | TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001 第2回再確認を反映:

outputs/phase-11

の画面証跡時刻を 16:50 JST に更新し、撮影コマンドを

capture-skill-center-metadata-guard-screenshots.mjs

へ統一。

spec-update-summary.md

unassigned-task-detection.md

documentation-changelog.md

の再監査値を

verify-unassigned-links

88/88、

audit --diff-from HEAD

baseline=94 へ同期し、

phase-12-documentation.md

の引き継ぎ事項を完了移管済みへ更新 | | v10.08.2 | 2026-03-04 | SkillCenter再監査の UI再撮影 preflight を標準化:

references/phase-11-12-guide.md

に再撮影前

preview preflight

（build成功 +

127.0.0.1:4173

疎通確認）を追加。失敗時は

unassigned-task-detection.md

へ記録し、

docs/30-workflows/unassigned-task/

へ未タスク化する分岐を完了条件チェックへ追記 | | v10.08.1 | 2026-03-04 | TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001 再監査の最終固定:

complete-phase.js

を Phase 1〜12 へ順次適用して

artifacts.json

を

completed

同期、

outputs/artifacts.json

を生成。

generate-index

（2スキル）+

verify-all-specs

（13/13）+

validate-phase-output

（28項目）+

validate-phase11-screenshot-coverage

（4/4）+

verify-unassigned-links

（88/88）を再実行し、再監査の証跡を固定 | | v10.08.0 | 2026-03-04 | TASK-FIX-SKILL-IMPORT 3連続是正の再監査を反映:

01/02/03

workflow を再監査し、

aiworkflow-requirements

正本6仕様書（api-ipc/interfaces/arch-state/ui-ux-feature/task-workflow/lessons）へ実装内容と苦戦箇所を同期。Phase 12 Task 5 必須の4ファイル（

LOGS.md

x2 +

SKILL.md

x2）を同一ターンで更新し、

verify-all-specs

（3workflow）/

validate-phase-output

（3workflow）/

validate-phase11-screenshot-coverage

（workflow03）/

audit --diff-from HEAD

の証跡を固定 | | v10.07.1 | 2026-03-03 | TASK-10A-D 再監査追補: Phase 11 証跡不足を是正し、

outputs/phase-11/screenshots/

に TC-01〜TC-05 を追加。

manual-test-result.md

を証跡列付きへ更新して

validate-phase11-screenshot-coverage

を PASS 化。

task-workflow.md

の未タスクリンク3件を修正し、

verify-unassigned-links

を

ALL_LINKS_EXIST

へ回復。

artifacts.json

と

index.md

を再同期して Phase 13 を

pending

（未実施）へ整合化 | | v10.07.0 | 2026-03-03 | TASK-10A-D Phase 12 完了同期:

ui-ux-components.md

ui-ux-feature-components.md

arch-ui-components.md

arch-state-management.md

interfaces-agent-sdk-skill.md

task-workflow.md

に実装内容と苦戦箇所3件（Suggestion型不整合、P40再発、P11パターン）を同期。LOGS.md 2ファイル・SKILL.md 2ファイル同時更新（P1/P25/P29対策）。P43準拠3ファイル以下/エージェントに分割実行 | | v10.06.0 | 2026-03-02 | TASK-10A-C 再監査パターンを反映:

phase-11-manual-test.md

phase-12-documentation.md

で依存Phase成果物（2/5/6/7/8/9/10）の参照資料補完を必須化し、

verify-all-specs

の依存参照warningをゼロ化する運用を追記。UIタスクでは

screenshot:*

再実行で証跡鮮度を固定し、Step 1-A の LOGS/SKILL 4点同時更新を完了条件として明文化 | | v10.05.0 | 2026-03-02 | Phase 13 PR本文セクション連携を強化:

phase-templates.md

の Phase 13 に

/ai:diff-to-pr

Phase 3.6（

TARGET_WORKFLOW_DIR

特定）との連携ルールを追加し、PR本文を

.github/pull_request_template.md

準拠セクションへ同期。UI/UX変更時は

outputs/phase-11/screenshots/*.png

をPR本文

## スクリーンショット

へ自動挿入する要件を追加。

phase-11-12-guide.md

完了チェックへ「Phase 13で対象workflow確認」「

## その他

へのPhase 12実装ガイド反映」確認項目を追加 | | v10.04.0 | 2026-03-02 | Phase 11 画面カバレッジマトリクス改善:

phase-templates.md

に画面カバレッジマトリクス（4ステップ: 変更コンポーネント洗い出し/UI状態カバレッジ定義/撮影計画JSON作成/カバレッジレポート）を追加。

phase-11-12-guide.md

の実行フローを9ステップに拡張し、撮影コマンドをA.計画ベース一括撮影/B.個別撮影の2構成に再編。

capture-screenshots.js

を拡張版に更新（--plan/--selector/--action/--action-target/--helpオプション追加、テーマ別グループ化、カバレッジレポート自動生成） | | v10.05.0 | 2026-03-02 | TASK-10A-B Phase 11/12 再監査を反映:

phase-11-manual-test.md

に必須セクション「統合テスト連携」を追加し、

manual-test-result.md

を実スクリーンショット証跡ベースへ更新。

unassigned-task-detection.md

を 7件→5件へ再同期。

verify-all-specs

warning 13→0、

validate-phase-output

を 28項目PASS へ復帰 | | v10.04.0 | 2026-03-02 | TASK-10A-B SkillAnalysisView 実装完了を反映: Phase 1-12全完了（72テスト全PASS、カバレッジ Line100%/Branch95.83%/Function100%）。LOGS.md 2ファイル・SKILL.md 2ファイルを同時更新し、topic-map.md を再生成。

docs/30-workflows/completed-tasks/skill-analysis-view/outputs/phase-12/spec-update-summary.md

を更新 | | v10.03.0 | 2026-03-02 | Phase 12準拠再確認の実行パターンを反映:

skill-editor-view

と

TASK-UI-05

の2workflowで

verify-all-specs

validate-phase-output

を同時実行し、Task 1/3/4/5成果物実体・implementation-guide Part 1/2・未タスク10見出しを同一ターンで突合する運用を確立。未タスク監査は

currentViolations=0

を合格基準に固定 | | v10.02.0 | 2026-03-02 | TASK-UI-05A 再監査（Phase 11/12整合是正）:

outputs/phase-11

へ 2026-03-02 再取得スクリーンショット（Dashboard/Editor/導線チェック）を追補。

outputs/phase-12/spec-update-summary.md

を追加し、未タスク正本3件（

docs/30-workflows/unassigned-task/

）と

artifacts.json

outputs/artifacts.json

の同期を反映 | | v10.01.0 | 2026-03-01 | TASK-UI-05A 包括的監査・仕様修正反映: Phase 1/2/4/5 に skill:getFileTree IPCチャネルを追加し、useFileTree 引数仕様を skillName ベースに統一。UT-UI-05A-GETFILETREE-001 未タスク登録を反映 | | v10.00.0 | 2026-03-01 | TASK-UI-05A spec_created 再監査を反映: Phase 12運用に「画面検証スクリーンショット必須」を明記し、

docs/30-workflows/skill-editor-view/outputs/phase-11/

への証跡（Dashboard/Editorスクリーンショット、manual-test-result、discovered-issues）同期手順を追補。併せて

verify-unassigned-links

失敗要因になっていた completed-tasks 移管後リンクドリフトの是正運用を反映 | | v10.02.0 | 2026-03-02 | TASK-UI-05B 実装完了再監査を反映:

docs/30-workflows/skill-advanced-views

を再監査し、

spec_created

残存を

completed

へ同期。Phase 11 画面証跡（TC-04〜TC-07）を追加。

phase-12-documentation.md

をテンプレート準拠（

実行タスク

参照資料

成果物

完了条件

）へ補正し、

verify-all-specs

（13/13）/

validate-phase-output

（28項目）を PASS に復帰。Phase 12 Step 1-A の

SKILL.md

LOGS.md

4点同期を完了 | | v10.01.0-v9.97.0 | 2026-03-01〜2026-02-28 | Phase 12 完了同期と再監査ルールの整備:

artifacts.json

outputs/artifacts.json

index.md

phase-1..12

の同期、必須成果物実体確認、

validate-phase-output

verify-all-specs

verify-unassigned-links

/ screenshot coverage の完了ゲート化を段階的に整理。詳細は

LOGS.md

を参照 | | v9.96.0-v9.92.2 | 2026-02-27〜2026-02-25 | Phase 12 guard と quick_validate 運用の標準化: unassigned audit、親仕様参照整合、completed-tasks 移管、

quick_validate.js

経路統一、skill-creator 連携、

## メタ情報

重複防止などの再発防止ルールを整備。詳細は

LOGS.md

を参照 | | v9.92.1 | 2026-02-25 | 履歴運用改善:

SKILL.md

の変更履歴を直近中心に整理し、構造検証（500行上限）に適合。詳細な長期履歴は

LOGS.md

を正本として参照する方針へ統一 | | v9.92.0 | 2026-02-25 | UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001 再監査同期:

references/spec-update-workflow.md

の baseline/current 判定手順を

--target-file

--diff-from

ベースへ更新 | | v9.91.0 | 2026-02-25 | UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001 実装反映:

scripts/audit-unassigned-tasks.js

に

--target-file

--diff-from

、

currentViolations

baselineViolations

分離、scoped 判定を追加 | | v9.90.0 | 2026-02-25 | UT-IPC-AUTH-HANDLE-DUPLICATE-001 再確認反映:

phase-11-12-guide.md

spec-update-workflow.md

にスキル構造検証チェックを追記（

quick_validate.js

ベース） |

補足: v9.89.0 以前の履歴は
LOGS.md
に保持（監査証跡を維持）。 | v10.09.3 | 2026-03-13 | Phase 12 root evidence と split-aware 未タスク監査を強化:
assets/phase12-task-spec-compliance-template.md
を 4点突合 / implementation-guide 必須要素 / current-baseline 分離 / system spec 同期まで確認する root evidence 形式へ拡張し、
scripts/verify-unassigned-links.js
は親
task-workflow.md
指定時に sibling
task-workflow*.md
も走査するよう改善した。
references/unassigned-task-guidelines.md
にも split-aware 実行前提を追記 | | v10.09.2 | 2026-03-13 | artifacts schema compatibility を修正:
schemas/artifact-definition.json
を current workflow 実体へ合わせ、legacy string artifact array、Phase
blocked
、
metadata.taskType=improvement
を validator 互換として受理するよう更新。
references/artifact-naming-conventions.md
に object 推奨 / legacy 互換の運用ルールも追記した | | v10.09.1 | 2026-03-13 | TASK-IMP-AIWORKFLOW-REQUIREMENTS-LINE-BUDGET-REFORM-001 の再監査知見を反映:
spec_created
workflow でも branch-level documentation drift を解消するために
outputs/phase-12/
の shell を補完してよいが、
artifacts.json
の
currentPhase
は execution progress の正本として維持し、implementation guide / documentation changelog / cross-skill feedback を Phase 12 checklist の細目まで満たすルールを固定した | | v10.09.0 | 2026-03-12 | TASK-IMP-TASK-SPECIFICATION-CREATOR-LINE-BUDGET-REFORM-001 を反映:
SKILL.md
を入口特化へ slim 化し、
patterns
、
phase-templates
、
spec-update-workflow
、
phase-11-12-guide
、
LOGS.md
を family file と archive へ再編した。canonical root は
.claude
、mirror は
.agents
に固定し、line budget / direct link / mirror parity / dependency integrity の検証導線を整理した | | v10.08.60 | 2026-03-12 |
UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001
formalize を反映 | | v10.08.59 | 2026-03-12 | current build static serve fallback と skill-creator 条件付き同期ルールを追加 | | v10.08.58 | 2026-03-12 | Apple UI/UX 視覚レビューと current/baseline 分離記法を追記 | | v10.08.57 | 2026-03-11 | 事後未タスク化による 0件→1件再同期ルールを追加 |

詳細な履歴と usage log は LOGS.md と references/logs-archive-index.md を参照。

task-specification-creator

NPX Install

Tags

SKILL.md Content

Task Specification Creator

設計原則

クイックスタート

実行フロー

create

execute

Task仕様ナビ

Phase 12 重要仕様

必須タスク（5タスク - 全て完了必須）

Task 1: 実装ガイドの2パート構成

Task 2: システム仕様更新【4サブステップ + 条件付きStep 2】

Task 4: 未タスク検出（0件でも出力必須）

Task 5: スキルフィードバックレポート（改善点なしでも出力必須）

Phase 12 実行時によくある漏れ

Phase 12 苦戦防止Tips

重要ルール

Phase完了時の必須アクション

PR作成に関する注意

よく使うコマンド

agent 導線

Phase 12 と Phase 13 の境界

リソース導線

core workflow

phase templates

Phase 11/12 guides

spec update

pattern family

logs and archives

システム観点チェック

検証コマンド

ベストプラクティス

すべきこと

避けるべきこと

変更履歴