Skip to main content
Glama
Repo Test Architect

Repo Test Architect

Analyze Repository

analyze_repository
Read-onlyIdempotent

Audits repository test architecture and returns the full evidence bundle: per-target test findings, rankings, and a native test plan. Use it when the complete bundle is needed.

Instructions

Return the complete repository-analysis/v1 bundle: every project audit with per-target test evidence plus the derived summary, findings, ranking, plan, execution hints, and stats. The result grows with repository size and can exceed client limits on large monorepos, so prefer review_repository first and use this only when the complete bundle is explicitly needed or the repository is small.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "repoRoot": "<repoRoot>"
    },
    "name": "analyze_repository"
  }
}

Input Schema

NameRequiredDescriptionDefault
goTargetNo
repoRootYesRepository root path.
changedPathsNoOptional repository-relative source paths to limit target selection.
excludeProjectRootsNoOptional project roots or subtree patterns such as examples/** to exclude before analysis.

Output Schema

NameRequiredDescriptionDefault
rootYes
statsYes
summaryYes
findingsYes
testPlanYes
auditSummaryYes
projectAuditsYes
schemaVersionYes
executionHintsYes
candidateRankingYes
verificationCommandsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.2.0
    • changedInput schema / properties / changedPaths / description
      Previous value: -"Optional repository-relative source paths to limit target selection inside detected projects."New value: +"Optional repository-relative source paths to limit target selection."
    • changedInput schema / properties / excludeProjectRoots / description
      Previous value: -"Optional exact project roots or subtree patterns such as examples/** to exclude before analysis."New value: +"Optional project roots or subtree patterns such as examples/** to exclude before analysis."
  2. Changed24 schema fields changedv1.1.0
    • removedOutput schema / $defs
      Removed value: -{
      -  "auditSummary": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-audit-summary/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "candidateRanking": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-candidate-ranking/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "executionHints": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "plan-execution-hints/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "findings": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-findings/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "projectAudits": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-audits/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "stats": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-stats/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  "testPlan": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "schemaVersion": {
      -        "const": "project-test-plan/v1"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  }
      -}
    • removedOutput schema / $id
      Removed value: -"repository-analysis-v1.schema.json"
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / description
      Added value: +"Top-level shape of this artifact. The complete contract is schemas/repository-analysis-v1.schema.json in the published package."
    • removedOutput schema / properties / auditSummary / $ref
      Removed value: -"#/$defs/auditSummary"
    • addedOutput schema / properties / auditSummary / type
      Added value: +"object"
    • removedOutput schema / properties / candidateRanking / $ref
      Removed value: -"#/$defs/candidateRanking"
    • addedOutput schema / properties / candidateRanking / type
      Added value: +"object"
    • removedOutput schema / properties / executionHints / $ref
      Removed value: -"#/$defs/executionHints"
    • addedOutput schema / properties / executionHints / type
      Added value: +"object"
    • removedOutput schema / properties / findings / $ref
      Removed value: -"#/$defs/findings"
    • addedOutput schema / properties / findings / type
      Added value: +"object"
    • removedOutput schema / properties / projectAudits / $ref
      Removed value: -"#/$defs/projectAudits"
    • addedOutput schema / properties / projectAudits / type
      Added value: +"object"
    • removedOutput schema / properties / root / minLength
      Removed value: -1
    • removedOutput schema / properties / stats / $ref
      Removed value: -"#/$defs/stats"
    • addedOutput schema / properties / stats / type
      Added value: +"object"
    • removedOutput schema / properties / summary / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / summary / properties
      Removed value: -{
      -  "auditCoverage": {
      -    "enum": [
      -      "complete",
      -      "partial",
      -      "none"
      -    ]
      -  },
      -  "auditedProjectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "blockerCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "candidateCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "findingCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "planItemCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "projectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "unsupportedProjectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "verificationCommandCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  }
      -}
    • removedOutput schema / properties / summary / required
      Removed value: -[
      -  "projectCount",
      -  "auditedProjectCount",
      -  "unsupportedProjectCount",
      -  "auditCoverage",
      -  "blockerCount",
      -  "findingCount",
      -  "candidateCount",
      -  "planItemCount",
      -  "verificationCommandCount"
      -]
    • removedOutput schema / properties / testPlan / $ref
      Removed value: -"#/$defs/testPlan"
    • addedOutput schema / properties / testPlan / type
      Added value: +"object"
    • removedOutput schema / properties / verificationCommands / items
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "command": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "projectCount": {
      -      "minimum": 1,
      -      "type": "integer"
      -    }
      -  },
      -  "required": [
      -    "command",
      -    "projectCount"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / title
      Removed value: -"Repository Analysis Artifact"
  3. Changed1 schema field changedv1.0.0
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "auditSummary": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-audit-summary/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "candidateRanking": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-candidate-ranking/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "executionHints": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "plan-execution-hints/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "findings": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-findings/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "projectAudits": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-audits/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "stats": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-stats/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "testPlan": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "schemaVersion": {
      +          "const": "project-test-plan/v1"
      +        }
      +      },
      +      "required": [
      +        "schemaVersion"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "$id": "repository-analysis-v1.schema.json",
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "auditSummary": {
      +      "$ref": "#/$defs/auditSummary"
      +    },
      +    "candidateRanking": {
      +      "$ref": "#/$defs/candidateRanking"
      +    },
      +    "executionHints": {
      +      "$ref": "#/$defs/executionHints"
      +    },
      +    "findings": {
      +      "$ref": "#/$defs/findings"
      +    },
      +    "projectAudits": {
      +      "$ref": "#/$defs/projectAudits"
      +    },
      +    "root": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "schemaVersion": {
      +      "const": "repository-analysis/v1"
      +    },
      +    "stats": {
      +      "$ref": "#/$defs/stats"
      +    },
      +    "summary": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "auditCoverage": {
      +          "enum": [
      +            "complete",
      +            "partial",
      +            "none"
      +          ]
      +        },
      +        "auditedProjectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "blockerCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "candidateCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "findingCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "planItemCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "projectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "unsupportedProjectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "verificationCommandCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "projectCount",
      +        "auditedProjectCount",
      +        "unsupportedProjectCount",
      +        "auditCoverage",
      +        "blockerCount",
      +        "findingCount",
      +        "candidateCount",
      +        "planItemCount",
      +        "verificationCommandCount"
      +      ],
      +      "type": "object"
      +    },
      +    "testPlan": {
      +      "$ref": "#/$defs/testPlan"
      +    },
      +    "verificationCommands": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "command": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "projectCount": {
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "command",
      +          "projectCount"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "schemaVersion",
      +    "root",
      +    "summary",
      +    "verificationCommands",
      +    "projectAudits",
      +    "auditSummary",
      +    "findings",
      +    "candidateRanking",
      +    "testPlan",
      +    "executionHints",
      +    "stats"
      +  ],
      +  "title": "Repository Analysis Artifact",
      +  "type": "object"
      +}
  4. First observedv0.1.0

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, so the safety profile is covered; the description adds a genuinely non-obvious behavioral trait — that result size scales with repository size and can exceed client limits on large monorepos. It stops short of describing failure/pagination behavior, so not a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with what is returned and immediately followed by the size caveat and the sibling routing. The enumeration of bundle contents is dense but every item carries routing information; nothing is padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need no elaboration, and annotations cover safety. The description supplies the size-limit risk and the alternative path, which is what an agent needs to choose correctly; only per-parameter guidance for changedPaths/excludeProjectRoots is left thin.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 75%, so the schema already documents repoRoot, changedPaths, excludeProjectRoots and the nested goTarget fields. The description adds no meaning about any parameter — 'small' vs 'large monorepos' only loosely gestures at excludeProjectRoots — so the baseline applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource ('Return the complete repository-analysis/v1 bundle') and enumerates its payload: project audits with per-target test evidence, summary, findings, ranking, plan, execution hints, stats. It clearly separates this from the lighter-weight sibling by contrasting the 'complete bundle' with review_repository.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit default ('prefer review_repository first') and two concrete conditions that override it: when the complete bundle is explicitly needed, or when the repository is small. When-to-use, when-not-to-use, and the named alternative are all present.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.