architecture-review
プロジェクト構造の監査、リファクタリング計画、コード体系の改善、依存関係とモジュール境界の分析、構造的な問題の特定に使用できます。TypeScript/JavaScriptを主軸としながら、言語に依存しないパターンに対応しています。
description の原文を見る
Use when auditing project structure, planning refactors, improving code organization, analyzing dependencies and module boundaries, or identifying structural issues. TypeScript/JavaScript-primary with language-agnostic patterns.
SKILL.md 本文
アーキテクチャレビュー
プロジェクト構造を分析、監査、改善します。
主要原則
- 変更前に測定する — 構造をマップして具体的な問題を特定してから、変更を提案する
- 明確な境界 — UI、ロジック、データなどのレイヤーを分離し、一貫した依存方向を保つ
- コロケーション — 関連するコードを同じ場所に配置し、機能を容易に検索・変更・削除できるようにする
- 段階的マイグレーション — 段階的にリファクタリングし、各ステップをテストで検証する
クイック評価
- 循環依存がない
- 一貫性のあるディレクトリ命名とグループ化（機能別またはタイプ別）
- ファイル/モジュールごとに単一責任、妥当なファイルサイズ（500行未満）
- 外部依存関係は隔離され、共有コードが適切に抽出されている
- 新しい開発者が簡単にコードを探索でき、任意の機能のコードを見つけられる
クイックスタートチェックリスト
- 現在の構造をマップする：ディレクトリツリー、依存グラフ、モジュール境界
- 問題を特定する：循環依存、ゴッドモジュール、抽象化の漏洩、深いネスト
- 重大度を分類する：緊急（開発を阻害）、高（保守負担）、中/低（摩擦）
- ターゲット構造とマイグレーション計画を提案する
- 段階的に実行し、各移動後にテストで検証する
...
詳細情報
- 作者
- zagarlucas
- ライセンス
- unknown
- 最終更新
- 2026/3/25
Source: https://github.com/zagarlucas/zagarlucas.github.io / ライセンス: unknown
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。