IPC Preload Spec Sync Guardian

概要

task-9D〜9J 仕様書の「旧参照パス」「artifacts不整合」「型配置ズレ」を監査し、最小差分で修正する。 コード実装は行わず、仕様書とシステム仕様の同期を目的とする。

ワークフロー

Phase 1: 監査スコープ固定

目的: 対象を限定し、全体ノイズと今回差分を分離する。

アクション:

1. 対象を task-022-task-9f と task-023[a-f]-task-9* に固定する。
2. 監査基準を references/spec-sync-checklist.md で確定する。

Phase 2: 並列監査

目的: 旧パス残存と artifacts 欠落を同時検出する。

アクション:

1. scripts/audit_task9_spec_sync.js を実行する。
2. oldPaths と missingArtifacts を分離して報告する。

Phase 3: 仕様書修正

目的: 現行実体に合わせた最小修正を適用する。

アクション:

1. preload/skillAPI.ts を preload/skill-api.ts に統一する。
2. main/ipc/channels.ts を preload/channels.ts に統一する。
3. packages/shared/src/types/skill-*.ts と packages/shared/src/types/index.ts を artifacts に反映する。

Phase 4: システム仕様同期

目的: 完了記録・苦戦箇所・再発防止を仕様正本へ反映する。

アクション:

1. aiworkflow-requirements/references/task-workflow.md に完了記録を追加する。
2. aiworkflow-requirements/references/lessons-learned.md に苦戦箇所と簡潔解決手順を追加する。
3. aiworkflow-requirements/LOGS.md と SKILL.md 変更履歴を同期する。

SubAgent 分担

SubAgent	責務	並列可否
A	task-9D〜9J 監査と差分抽出	可
B	仕様書修正（artifacts / 参照パス）	可
C	システム仕様書反映（task-workflow / lessons / logs）	可
D	最終整合確認（index再生成・検証）	A/B/C完了後

ベストプラクティス

すべきこと

• old path と missing artifacts を別問題として扱う。
• task-9 正本と UT系計画書 を混同しない。
• 変更後に監査スクリプトを再実行してから反映する。

避けるべきこと

• 仕様修正タスクで実装コードを同時変更する。
• 残課題テーブル更新なしで完了扱いにする。
• LOGS.md と SKILL.md の片方だけ更新する。

リソース参照

scripts/

スクリプト	機能	使用例
scripts/audit_task9_spec_sync.js	task-9D〜9J の旧参照・artifacts不足を監査	node scripts/audit_task9_spec_sync.js --format markdown
scripts/validate_all.js	スキル構造と監査結果をまとめて検証	node scripts/validate_all.js
scripts/log_usage.js	使用ログ記録	node scripts/log_usage.js --result success --phase Phase4

agents/

Task	パス	責務
audit-task9-spec	agents/audit-task9-spec.md	監査観点固定と差分抽出
patch-task9-spec	agents/patch-task9-spec.md	仕様書修正パッチ設計
sync-system-spec	agents/sync-system-spec.md	task-workflow/lessons/logs同期

references/

リソース	パス	読込条件
監査チェックリスト	references/spec-sync-checklist.md	修正前
クイック復旧手順	references/quick-recovery-playbook.md	苦戦時
実行パターン集	references/patterns.md	改善時

変更履歴

Version	Date	Changes
1.1.0	2026-02-25	実運用版を作成。task-9D〜9J仕様同期ワークフロー、SubAgent分担、監査スクリプト連携を追加
1.0.0	2026-02-25	初版作成