Stats
Actions
Available In
Tags
Plugin
architecture-toolkit
コードベースのアーキテクチャをレビューし所見を並列・安全に適用し、収束まで再帰反復し、さらに新機能を設計から並列実装まで進める4つのスキル(architecture-review / architecture-fix / architecture-loop / feature-build)を内包するプラグイン。
What's Inside
Skills4
architecture-fix
/architecture-fix
architecture-review が出力した構造化所見(architecture-review.json の findings)を、 衝突しない wave に分けて Workflow で並列適用し、各 wave で検証してグループコミットするスキル。 findings の fix 仕様(before/after/refs/verify)と deps・ファイル重複から衝突しないグループ(wave)を作る。 「(レビューで)出した指摘を適用/反映して」「architecture-review.json を直して」 「findings を並列で一気に修正して」「リファクタ計画を実行して」「レビュー結果を反映して」など、 評価済みの所見をまとめて安全にコードへ反映する実行フェーズで使う。 前提として所見(JSON)が既にあること——まだ評価していなければ先に architecture-review、 review→fix を収束まで繰り返すなら architecture-loop、新機能の実装は feature-build。 単発・1ファイルで明白な修正だけなら本スキルは不要。
architecture-loop
/architecture-loop
architecture-review(評価)と architecture-fix(適用)を1周として、品質ゲート達成・進捗の頭打ち・ 反復予算の消尽まで収束的に繰り返すオーケストレーター・スキル。回帰(検証の赤化)や振動(指摘の出戻り)を 検知して安全に止める。「指摘がなくなるまで繰り返して」「critical/high が 0 になるまでリファクタし続けて」 「review→fix を収束まで自動で回して」「品質ゲートを満たすまで直して」「再帰的に調査と改善して」など、 1回の評価+適用では返しきれない技術的負債を複数周回で段階的に減らす場面で使う。 鍵は反復・収束・自動継続の意図があること——1回だけ評価するなら architecture-review、出した所見を 1回適用するだけなら architecture-fix、新機能開発は feature-build。アーキテクチャ品質の収束が目的で、 テストやCIを通すだけの一般的な反復修正とは異なる。review/fix を再実装せず合成・統御する上位レイヤ。
architecture-review
/architecture-review
既存コードベースのアーキテクチャ・設計を体系的に評価し、改善点を観点別・優先度付きの 構造化所見(findings JSON + 人間向け Markdown)として網羅的に洗い出すスキル。 「アーキテクチャ/設計をレビューして」「技術的負債を棚卸しして」「改善点を網羅的に出して」 「リファクタの方針を立てて」「この設計でいいか」、また漠然と「コードを整理したい/きれいにしたい・ どこから直すべき」と言われたときに使う。新規参画時の把握・設計レビュー準備・大改修前の方針出しにも。 評価と計画づくりが目的で、所見の適用はしない——出した所見をコードに反映するのは architecture-fix、 review→fix を収束まで反復するのは architecture-loop、新機能をゼロから作るのは feature-build。 単発の小修正や対象が1ファイルで明白なケースは対象外。 出力は (1) 根拠付きアーキテクチャ要約 と (2) 観点別の網羅的改善提案(深刻度・労力・直し方・優先順位)。
feature-build
/feature-build
新機能・機能追加を、まずコードベース全体を理解して変更箇所を漏れなく特定し、既存アーキテクチャに整合する 設計を立ててから、衝突しない wave に分けて Workflow で並列実装＋段階検証＋グループコミットするスキル。 「この機能を追加して」「〜を実装して/作って」「新しいエンドポイント/画面/CLI コマンド/ジョブを足して」 「〜できるようにして」「機能を設計して実装まで」など、複数ファイルにまたがる新しい振る舞いをゼロから作る 開発フェーズで使う。既存コードの評価・改善(リファクタ)ではない——構造を評価するなら architecture-review、 出した所見を適用するなら architecture-fix、収束まで反復改善するなら architecture-loop。 単一ファイル・数行で明白な追加(引数1個・ログ1行)だけなら本スキルは不要。
Stats
Version0.3.1
Stars1
MaintenanceExcellent
LicenseMIT
Last Commit
Added
Available In
