parallel-docs-simplify-sync

並列ドキュメント簡素化同期

Task ツールを使用して、互いに独立した4つのスキルを並行して実行します。

開発者向けオーケストレーションスキルです。 正本は plugins/synapse-a2a/skills/ にあり、.agents/skills/ と .claude/skills/ に同期されます。

• synapse-docs — ドキュメントの更新
• /simplify — Claude Code 組み込みのコード簡素化（カスタムの code-simplifier を置き換えます）
• sync-plugin-skills — プラグインスキルの同期
• github-pages-sync — GitHub Pages サイトの同期

使用する場面

• 同じタスク内でコードとドキュメントの両方を変更した場合。
• ドキュメントの同期を保ちながら、簡素化やリファクタリングの整理が必要な場合。
• 同じ実行内でプラグインスキルの同期も行う場合。
• GitHub Pages サイト（site-docs/）にコードやドキュメントの変更を反映する必要がある場合。

並列実行ワークフロー

ステップ1：独立した4つのサブタスクに分割する

明確な目標を1つ定め、次のように分割します。

トラック	スキル	対象範囲の例
Docs	synapse-docs	README.md、guides/、CLAUDE.md
Simplify	/simplify（組み込み）	最近変更された .py ファイル
Sync	sync-plugin-skills	plugins/synapse-a2a/skills/
Pages	github-pages-sync	site-docs/

ステップ2：1つのメッセージでTaskツールを4回呼び出す

Task ツールを使用し、1つの応答内で並行して4回呼び出します。 各Task呼び出しでは、以下のプロンプトテンプレートを使用します。

# Example: four parallel calls (3 Task agents + 1 Skill)
Task(subagent_type="general-purpose", prompt="[synapse-docs prompt]")
Skill("simplify")
Task(subagent_type="general-purpose", prompt="[sync-plugin-skills prompt]")
Task(subagent_type="general-purpose", prompt="[github-pages-sync prompt]")

ステップ3：4つすべての出力を待つ

4つのタスクはそれぞれ独立して結果を返します。マージする前に結果を収集します。

ステップ4：マージして競合を解決する

各トラックの変更を適用します。競合が発生した場合は、以下の 競合解決ルールに従います。マージ後にテストを実行します。

ステップ5：失敗したトラックのみ再試行する

いずれかのトラックが失敗した場合は、そのトラックのみを再実行します。4つすべてを再実行してはいけません。

タスクプロンプトのテンプレート

各並列トラックで以下を使用します。

Goal: <shared task goal>
Track: <synapse-docs | simplify | sync-plugin-skills | github-pages-sync>
Scope: <files/areas>
Constraints:
- Keep behavior unchanged unless explicitly requested
- Keep style consistent with repository conventions
- Do NOT touch files outside your track's scope
Deliverable:
- Concise change summary and touched files

競合解決ルール

synapse-docs と sync-plugin-skills は、どちらも plugins/synapse-a2a/skills/ 配下のファイルを変更することがあります。その場合は、次のようにします。

1. スキルのSKILL.mdの内容については、sync-plugin-skillsを優先します。
2. README.md、guides/、スキル以外のドキュメントについては、synapse-docsを優先します。
3. 同じSKILL.mdを両方が変更した場合は、sync-plugin-skills の出力を採用し、 synapse-docs のドキュメント変更と照合します。説明に食い違いがあれば、手動で調整します。
4. /simplify は .py ファイルのみを変更するため、競合は発生しないはずです。
5. github-pages-sync が変更するのは site-docs/ と mkdocs.yml のみです。synapse-docs と github-pages-sync の両方が mkdocs.yml を変更した場合は、 サイトのビルド設定を管理する github-pages-sync を優先します。

完了チェックリスト

• 4つすべてのトラックが完了：synapse-docs、/simplify、sync-plugin-skills、github-pages-sync
• 上記のルールに従って競合を解決済み
• pytest が成功する
• uv run mkdocs build --strict が成功する（Pagesトラックを実行した場合）
• 最終差分に一貫性があり、レビュー可能である