agentleFS
takayoshitoyoda05takayoshitoyoda05/claude-ml-template/.claude/skills/architecture-check/SKILL.md

architecture-check

Skill1 starsChanged 2 months agoMITView on GitHub

コードベース全体を見直すとき、「アーキテクチャを見直して」「設計負債をチェックして」と言われたときに必ず使う。

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

アーキテクチャ健全性チェック

AIによる実装は変更速度が速い分、設計の腐敗(コードの複雑化)も 速く進みやすい。定期的にコードベース全体を見直し、リファクタ候補を 提案する。

チェック観点

観点具体的に見ること
肥大化したファイル極端に行数が多いファイル、責務が混在しているファイル
重複似た処理が複数箇所に散らばっていないか
浅いインターフェース/深い実装呼び出し側が内部詳細を知りすぎていないか
命名の一貫性CONTEXT.md の用語と実際のコードの命名が一致しているか

進め方

  1. 作業スコープ配下の CONTEXT.md があれば読む。
  2. 作業スコープ配下のコードをディレクトリ単位でざっと確認する。
  3. 見つかった問題を重大度別(HIGH/MEDIUM/LOW)に整理する。
  4. .claude/plans/architecture-report-YYYYMMDD.md にレポートとして保存する。
  5. ユーザーに、対応するなら Planner に渡す準備がある項目を伝える。

注意

  • このスキル自体はコードを変更しない(レポートのみ)。実際の改善は ユーザーが選んだ項目を Planner に渡してから行う。
  • 研究の実験スクリプトは書き捨てられることも多いため、明らかに使い捨て 用途と分かるコードは指摘の優先度を下げる。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.