{
  "id": "improve-codebase-architecture",
  "handle": "improve-codebase-architecture",
  "canonicalUrl": "https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture",
  "language": "ja",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/improve-codebase-architecture",
    "es": "https://bestskillsforclaude.com/es/skills/improve-codebase-architecture",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture",
    "ja": "https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture"
  },
  "category": {
    "id": "build-and-ship",
    "name": "実装とリリース"
  },
  "publisher": {
    "name": "Matt Pocock",
    "url": "https://github.com/mattpocock"
  },
  "source": "https://github.com/mattpocock/skills",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and agents that support the skills CLI",
  "lastReviewed": "2026-08-05",
  "headline": "エージェントはアーキテクチャの痛点を指摘できるか",
  "summary": "候補は出せます。どれが重要かの判断は依然として人間側です。",
  "verdict": "improve-codebase-architecture スキルは、モジュールを単純化し深くする機会を探してコードベースを走査し、結果をレポートとして提示し、選ばれた候補だけをその後で掘り下げます。この順序が肝で、判断の前に書き換え始めることを拒む診断ツールです。",
  "bestFor": "急速に育ち、モジュール間に詳細が漏れ出しているコードベース。",
  "skipIf": "問題の所在をすでに把握できる規模のプロジェクト。",
  "keyTakeaways": [
    "先にレポート、後で変更。この順序が安全に実行できる理由です。",
    "サブシステムに絞ってください。全体レポートは行動に移すには大きすぎます。",
    "指摘は候補であって判定ではありません。チームだけが知る事情で間違っているものもあります。",
    "根拠を検証したいときは grill-me と組み合わせます。"
  ],
  "quickStart": [
    "mattpocock/skills から skills CLI 経由で MIT ライセンスで導入します。",
    "リポジトリ全体ではなく 1 領域に対して実行し、レポートをレビュー可能な量に保ちます。",
    "候補を 1 つか 2 つ選びます。30 件の一覧は、何も選ばないための方法です。"
  ],
  "sections": [
    {
      "heading": "実務で何が変わるか",
      "paragraphs": [
        "アーキテクチャの改善は技術的というより社会的な理由で止まります。どこから始めるか合意できず、結果として何も始まりません。理由付きの具体的な候補一覧は、その議論を意思決定に変えます。",
        "レポート形式は、エージェントができる最も危険なこと、つまり目の前で複数モジュールを同時に書き換える行為も防ぎます。"
      ]
    },
    {
      "heading": "期待に届かない点",
      "paragraphs": [
        "見ているのはコードであって経緯ではありません。不格好な境界の一部は、どこにも書かれていない制約のために存在しており、スキルは自信をもって撤去を提案します。",
        "長いレポートは範囲の膨張も招きます。候補を 1 つに絞る規律は完全に人間側の仕事です。"
      ]
    }
  ],
  "faq": [
    {
      "question": "コードを自動で書き換えますか",
      "answer": "まずレポートを出し、選ばれた候補だけを掘り下げます。見つけ次第の書き換えはしません。"
    },
    {
      "question": "どのくらいの規模まで扱えますか",
      "answer": "サブシステム単位に絞ってください。リポジトリ全体のレポートは扱いきれないことが多いです。"
    },
    {
      "question": "誰が保守していますか",
      "answer": "Matt Pocock が公開する skills リポジトリで、ライセンスは MIT です。"
    }
  ],
  "sources": [
    {
      "label": "GitHub の mattpocock/skills",
      "url": "https://github.com/mattpocock/skills",
      "kind": "repository"
    },
    {
      "label": "エージェントスキルのディレクトリ",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture/content.md",
    "json": "https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}