architecture-check
Skill1 starsChanged 2 months agoMITView on GitHub
コードベース全体を見直すとき、「アーキテクチャを見直して」「設計負債をチェックして」と言われたときに必ず使う。
2 other projects use a version of this.
Adopted by
Most recently taken up by
- nhat092005/skillstheir own version, first seen Oct 13, 2026
- joris887/exosuittheir own version, first seen Aug 20, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- joris887/exosuit★ 9same name
- nhat092005/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- adrSkill
- brainstormSkill
- branch-namingSkill
- codex-delegateSkill
- config-explainSkill
- config-setSkill
- cross-reviewSkill
- design-interviewSkill
- diagnosing-bugsSkill
- fix-ciSkill
- handoffSkill
- leakage-checkSkill
- literature-reviewSkill
- mlflow-logSkill
- multi-seedSkill
- mutation-testSkill
- paper-writingSkill
- pre-mortemSkill
- property-testSkill
- python-standardsSkill
- refactor-scoutSkill
- regression-suiteSkill
- retrospectiveSkill
- security-reviewSkill
- spec-checklistSkill
- tddSkill
The file
Files
アーキテクチャ健全性チェック
AIによる実装は変更速度が速い分、設計の腐敗(コードの複雑化)も 速く進みやすい。定期的にコードベース全体を見直し、リファクタ候補を 提案する。
チェック観点
| 観点 | 具体的に見ること |
| 肥大化したファイル | 極端に行数が多いファイル、責務が混在しているファイル |
| 重複 | 似た処理が複数箇所に散らばっていないか |
| 浅いインターフェース/深い実装 | 呼び出し側が内部詳細を知りすぎていないか |
| 命名の一貫性 | CONTEXT.md の用語と実際のコードの命名が一致しているか |
進め方
- 作業スコープ配下の CONTEXT.md があれば読む。
- 作業スコープ配下のコードをディレクトリ単位でざっと確認する。
- 見つかった問題を重大度別(HIGH/MEDIUM/LOW)に整理する。
.claude/plans/architecture-report-YYYYMMDD.mdにレポートとして保存する。- ユーザーに、対応するなら Planner に渡す準備がある項目を伝える。
注意
- このスキル自体はコードを変更しない(レポートのみ)。実際の改善は ユーザーが選んだ項目を Planner に渡してから行う。
- 研究の実験スクリプトは書き捨てられることも多いため、明らかに使い捨て 用途と分かるコードは指摘の優先度を下げる。
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
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.

