adapt-architecture
について
このスキルは、ストラングラー・フィッグのようなパターンを用いて、システムアーキテクチャを段階的に進化させる構造化された手法を提供します。モノリスからマイクロサービスへの移行など大規模な変更において、段階的な移行、並行稼働、安全なロールバックを可能にし、リスクを最小限に抑えます。リスキーな「ビッグバン」方式の置き換えではなく、制御された段階的変革が必要な場合にご利用ください。
クイックインストール
Claude Code
推奨npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/adapt-architectureこのコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
變構
形變不輟運也。絞榕、蛹、護介為法。
用
assess-form判 READY→用- 須變構而不停→用
- 整→微服或反→用
- 換核而依者續行→用
- 數模演而存後容→用
- 凡變宜漸非驟→用
入
- 必:今形評(自
assess-form) - 必:標構
- 必:運續之要(不可斷者)
- 可:變預(時、人、算)
- 可:退求(退至何處)
- 可:並行之久
行
一:謀
繪自今至標之路。
- 列中間諸形:今→中一→…→標
- 各中形必可運(受流、過驗)
- 中形不得難於今
- 識縫:何處可剖以入新
- 自然縫:介、模界、數分
- 人工縫:為剖而設之介(防腐層)
- 擇變式:
- 絞榕:新繞舊漸代
- 蛹:包舊以新殼,內換而殼存外介
- 芽:新與舊並,流漸移(見
scale-colony) - 遞變:依序代之(葉先根後)
- 設護介層:
- 外用者不擾
- API 版、後容、配器
- 護介乃暫——預其去
Metamorphosis Patterns:
┌───────────────┬───────────────────────────────────────────────────┐
│ Strangler Fig │ New code intercepts routes one by one; │
│ │ old code handles everything else until replaced │
│ │ ┌──────────┐ │
│ │ │ Old ████ │ → │ Old ██ New ██ │ → │ New ████ │ │
│ │ └──────────┘ │
├───────────────┼───────────────────────────────────────────────────┤
│ Chrysalis │ Wrap old system in new interface; replace │
│ │ internals while external shell stays stable │
│ │ ┌──────────┐ ┌──[new]───┐ ┌──[new]───┐ │
│ │ │ old core │ → │ old core │ → │ new core │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │
├───────────────┼───────────────────────────────────────────────────┤
│ Budding │ New system runs in parallel; traffic shifts │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │ │ Old │ │ New │ → │ Old │ │ New │ │
│ │ │ 100% │ │ 0% │ │ 0% │ │ 100% │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │
└───────────────┴───────────────────────────────────────────────────┘
得:藍圖明中形、縫、式、護介,步皆具體可驗。
敗:無縫→先 dissolve-form 以造縫。中形不可運→步太大,析之為小增。
二:搭架
築變所賴之暫構。
- 造防腐層:
- 新舊間之薄譯層
- 按遷態路請求至應者
- 譯舊新之數式
- 此層即護蛹
- 設並行:
- 新舊可同部
- 旗控何流入何
- 比機驗新舊果同
- 立退點:
- 各中形驗可退前
- 退須速於進
- 數遷可逆,或過渡時雙寫
- 建驗夾:
- 自動驗各中形運續
- 性能基準察退化
- 數整驗捕遷誤
得:防腐層、並行、退、驗皆備而後變起。架本身已驗。
敗:架太貴→簡之:最小架=旗+退法。防腐與並行加安但小變不必。
三:漸換
逐部自舊遷新。
- 排部之序:
- 始自最鬆最輕者(建信)
- 進至要而緊者
- 最緊要者末(時隊已熟)
- 各部: a. 新版於防腐層後 b. 並行:新舊同入 c. 比果——應同(異則預期且記) d. 信則翻旗移流 e. 監異(換後加感) f. 穩期後撤舊
- 全程持續交付:
- 各換為常部,非特事
- 系恆於知、驗、運態
- 換致誤→退前態(仍可運)
得:功逐部遷,各步皆驗。系恆運。各換育次信。
敗:並行見異→新有蟲,先修。換致退化→新部宜優或防腐層過重。隊失信→停而穩,半遷之系勝倉促全遷。
四:理蛹
度最脆之期——形之間。
- 認蛹實:
- 遷時系半舊半新
- 此雜態本繁於純態
- 繁峰於遷之中,後減
- 蛹律:
- 蛹期無新功(唯變)
- 外變最少(凍非要部)
- 加監加值
- 日察進與健
- 中蛹評:
- 半時評:標仍對乎
- 市、需、隊有變影標乎
- 續、停、改向
- 護蛹:
- 退路恆通
- 厚記今雜態(後人除錯需)
- 抗除暫架之誘——遷未畢
得:蛹期為自覺、限時之期,律加監加。隊知暫繁乃安變之代。
敗:蛹拖久→雜態為新常,劣於兩端。設限。至限則速畢餘遷或受雜為新形而穩。
五:畢變而穩
成變、撤架。
- 末換:
- 末部遷新
- 全驗套行新系
- 性能驗於擬產之載
- 撤架:
- 撤防腐層(無需矣)
- 去遷之旗
- 清並行設
- 存(勿刪)舊碼以參
- 後變穩:
- 新形運 2-4 週加監
- 解實況下新症
- 更文以反新構
- 回顧:
- 何處善
- 何處難於預
- 下次何改
- 更隊變譜
得:變畢。系於新形運。架已撤。文已更。隊得學以備後變。
敗:換後新形不穩→存退路續穩。穩過期→新構恐有設誤,考定修或部退最劣者。
驗
- 藍圖示中形可運
- 架(防腐、退、驗夾)於遷起前已備
- 部按低至高險之序遷
- 並行各步驗同
- 蛹期限時且凍新功
- 變畢架皆撤
- 後變穩期無大症
- 回顧得學
忌
- 驟遷:欲一舉變盡。棄漸換之安,最大爆域。必漸遷
- 架不撤:防腐層、旗久存→技債。撤架預入變謀,非後想
- 否蛹:偽稱雜為常→於不穩築新功。認蛹期、行其律
- 執標:執新構而忽更佳之兆。中蛹評即為此
- 變疲:久遷耗隊。步小至日畢,非週。記里程以續勢
參
assess-form— 前置評:判系可變否dissolve-form— 系剛不可直變者:溶之以造縫repair-damage— 變致損之復技shift-camouflage— 表變或足無須深構變coordinate-swarm— 群協告分散系變之序scale-colony— 長壓常為構變之發implement-gitops-workflow— GitOps 為漸換之部設review-software-architecture— 評標構之伴技
GitHub リポジトリ
関連スキル
executing-plans
デザインexecuting-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。
requesting-code-review
デザインこのスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。
connect-mcp-server
デザインこのスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。
web-cli-teleport
デザインこのスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。
