adapt-architecture
À propos
Cette compétence offre une méthode structurée pour faire évoluer progressivement l'architecture d'un système en utilisant des modèles tels que le "strangler fig". Elle permet une migration incrémentale, un fonctionnement parallèle et un retour arrière sécurisé, minimisant ainsi les risques lors de changements majeurs, comme le passage d'une architecture monolithique aux microservices. Utilisez-la lorsque vous avez besoin d'une transformation contrôlée et par étapes, plutôt que d'un remplacement risqué en "big-bang".
Installation rapide
Claude Code
Recommandé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-architectureCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
變構
形變不輟運也。絞榕、蛹、護介為法。
用
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— 評標構之伴技
Dépôt GitHub
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.
