PJR-ZP0B system-design: sysd-<term> 新設と sysd-agent-settings 系の再構成
1. 概要
sysd-index／sysd-critical-flows／sysd-cross-cutting-policy の最小3種構成では、既存のマルチエージェント実行設計（sysd-agent-settings 系4件・sysd-job-execution）を収める場所が無い。tsd-index／tsd-rulebook に倣い sysd-rulebook（hub＋子構成を許容する個別設計トピック用rulebook）を新設し、既存文書を横断ルール・運用手順・個別設計トピックへ再配置する。
2. 完了条件
sysd-rulebook.md（sysd-<term>、hub＋子構成を許容）が新設され、tsd-rulebook.mdとの対応関係が明確であること。sysd-agent-settings.mdの1〜6章・8章（3層責務分離、設定解決規則、rate limit検出・retry/fallback方針、worktree分離・イベント命名、reopen規則）がsysd-cross-cutting-policy.mdへ移設され、scp-<カテゴリ>-<連番>形式のルールとして再構成されていること。sysd-agent-settings.mdの7章（外部エージェントCLI更新手順）がopr-agent-cli-update.md（運用手順）へ移設されていること。sysd-agent-settings.mdが、4provider設計（sysd-claude/codex/opencode/github-copilot-agent-settings.md）への導線を持つ薄いhubへ縮小され、rulebook参照が実在するspecdojo:sysd-rulebookに更新されていること。sysd-claude/codex/opencode/github-copilot-agent-settings.md・sysd-job-execution.mdのrulebook参照がspecdojo:sysd-rulebookに更新されていること。sysd-index.md（SSOT一覧）が新設され、Configurations種別に agent実行構成（.specdojo/exec-defaults.yaml／.claude/agents/／pm-members.yaml等）の行が追加されていること。sysd-critical-flows.mdの要否を判断し、採用または不採用の判断根拠を残すこと。prj-0001:dct-system-designの該当エントリが、再構成後の構成・パスと整合していること。npm run -s lint:mdにエラーがないこと。npm run docs:buildが成功すること。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | sysd-rulebook.md の新設 | ARC | done | hub＋子構成を許容する個別システム設計rulebookを新設 |
| 2 | sysd-cross-cutting-policy.md の新設・内容移設 | ARC | done | 規範を14件のscp-<カテゴリ>-<連番>へ再構成 |
| 3 | opr-agent-cli-update.md の新設・内容移設 | ARC | done | docs/ja/product/090-operations/へ更新手順と証跡要件を移設 |
| 4 | sysd-agent-settings.md の縮小・rulebook参照修正 | ARC | done | 共通責務と子設計への薄いhubへ縮小 |
| 5 | 個別agent設計・sysd-job-execution.md のrulebook参照修正 | ARC | done | 4provider、orchestrator、Jobをspecdojo:sysd-rulebookへ統一 |
| 6 | sysd-index.md の新設 | ARC | done | Configurationsを含む設計SSOT一覧を追加 |
| 7 | sysd-critical-flows.md の要否判断 | ARC | done | SpecDojo固有の事故予防フロー5件を採用 |
| 8 | catalog整合確認、lint:md／docs:build 実行 | ARC | done | catalog・全体lint・Frontmatter・docs:buildが成功 |
4. 対応結果
sysd-critical-flowsは作成する。PR承認、task worktreeの分離・統合・保持、register ID採番と衝突復旧、agent worker poolの並列実行、provider利用制限からの延期再開は、いずれも順序・排他・監査・再実行を誤ると成果物または状態の整合性を損なうため、最大5件の重要フローとして採用した。sysd-agent-settingsは共通責務と子設計へのhubへ縮小し、規範はsysd-cross-cutting-policy、CLI更新手順はopr-agent-cli-updateへ移設した。- 4providerに加えて、既にhubから参照され同じrulebookを使用する
sysd-orchestrator-agent-settingsを個別設計トピックとしてdeliverables catalogへ追加した。 - rulebook作成では
rulebook-authoring-standard、rulebook.instructions.md、類似するtsd-rulebook・cdfd-rulebook・opd-rulebookを参照した。upsert-rulebook Skillが指定するdocs-contents-guide.mdはリポジトリに存在しないため、個票とdeliverables catalogを内容根拠として補完した。 npm run -s validate:catalog: 成功。未作成成果物に対する既存warningはあるが、dct-system-design.yamlを含む全catalogがOKとなった。- 変更対象ファイルのMarkdown lint: 成功。
npm run docs:build: 成功。sysd-critical-flows.mdのMermaid 5図を含めてVitePress buildが完了した。npm run -s lint:md: 成功。生成元のPJR-0053で*CAPITAL_CASE*をコード表記へ修正し、派生登録簿のMD049を解消した。npm run -s lint:fm: 成功。結論確定済みのPJR-1F46へ確定コミット時刻のcompleted_atを追加した。- 状態遷移の監査記録: 本対応は着手時に
specdojo register startを実行せず、作業完了後にspecdojo register closeでdoneへ遷移した。このためGit履歴上はopenからdoneへの遷移となる。実態と異なる遡及遷移は作成せず、現在のdoneを維持する。後続の登録項目は着手前にregister start、審査移行時にregister review、終了時にregister closeを実行する。
5. 関連ドキュメント
- prj-0001:dct-architecture:
tsd-index／tsd-rulebookの先例 - specdojo:tsd-index-rulebook: hub側rulebookの参照先例
- specdojo:tsd-rulebook: 個別トピックrulebookの参照先例
- specdojo:sysd-index-rulebook:
sysd-indexのCode as Spec方針・カテゴリ別書き分け方針 - specdojo:sysd-cross-cutting-policy-rulebook: 横断ルールの記述形式（Rule ID・カテゴリ）
- specdojo:kata-guide: rulebook / recipe / sample / template の役割分担