Skip to main content
Glama
Repo Test Architect

Repo Test Architect

Detect Projects

detect_projects
Read-onlyIdempotent

Discover project roots, support status, and matching adapters from local repository markers, without auditing source targets, to define boundaries before a specialized workflow.

Instructions

Discover project roots, support status, and matching adapters without auditing source targets. Use this when project boundaries are needed before a specialized workflow; use review_repository for a general review. Reads local repository markers and returns project-detection/v1 without executing tests or writing files.

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": "detect_projects"
  }
}

Input Schema

NameRequiredDescriptionDefault
repoRootYesReadable repository directory whose project markers should be inspected.
excludeProjectRootsNoOptional exact project roots or subtree patterns such as examples/** to exclude before returning detected projects.

Output Schema

NameRequiredDescriptionDefault
rootYes
summaryYes
projectsYes
schemaVersionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changedv1.1.0
    • removedOutput schema / $id
      Removed value: -"project-detection-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/project-detection-v1.schema.json in the published package."
    • removedOutput schema / properties / projects / items
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "absoluteRoot": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "adapterIds": {
      -      "items": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "adapterMatches": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "adapterId": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "matchedEcosystems": {
      -            "items": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "matchedLanguages": {
      -            "items": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "maturity": {
      -            "enum": [
      -              "supported",
      -              "experimental",
      -              "planned"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "adapterId",
      -          "maturity",
      -          "matchedEcosystems",
      -          "matchedLanguages"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "ecosystems": {
      -      "items": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "id": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "languages": {
      -      "items": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "markerFiles": {
      -      "items": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "root": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "supportStatusReason": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "supported": {
      -      "type": "boolean"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "root",
      -    "absoluteRoot",
      -    "ecosystems",
      -    "languages",
      -    "markerFiles",
      -    "adapterIds",
      -    "adapterMatches",
      -    "supported",
      -    "supportStatusReason"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / properties / root / minLength
      Removed value: -1
    • removedOutput schema / properties / summary / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / summary / properties
      Removed value: -{
      -  "projectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "supportedProjectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "unsupportedProjectCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  }
      -}
    • removedOutput schema / properties / summary / required
      Removed value: -[
      -  "projectCount",
      -  "supportedProjectCount",
      -  "unsupportedProjectCount"
      -]
    • removedOutput schema / title
      Removed value: -"Project Detection Artifact"
  2. Changed2 schema fields changedv1.0.0
    • changedInput schema / properties / repoRoot / description
      Previous value: -"Repository root path."New value: +"Readable repository directory whose project markers should be inspected."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$id": "project-detection-v1.schema.json",
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "projects": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "absoluteRoot": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "adapterIds": {
      +            "items": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "adapterMatches": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "adapterId": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "matchedEcosystems": {
      +                  "items": {
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "matchedLanguages": {
      +                  "items": {
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "maturity": {
      +                  "enum": [
      +                    "supported",
      +                    "experimental",
      +                    "planned"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "adapterId",
      +                "maturity",
      +                "matchedEcosystems",
      +                "matchedLanguages"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "ecosystems": {
      +            "items": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "id": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "languages": {
      +            "items": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "markerFiles": {
      +            "items": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "root": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "supportStatusReason": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "supported": {
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "root",
      +          "absoluteRoot",
      +          "ecosystems",
      +          "languages",
      +          "markerFiles",
      +          "adapterIds",
      +          "adapterMatches",
      +          "supported",
      +          "supportStatusReason"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "root": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "schemaVersion": {
      +      "const": "project-detection/v1"
      +    },
      +    "summary": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "projectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "supportedProjectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "unsupportedProjectCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "projectCount",
      +        "supportedProjectCount",
      +        "unsupportedProjectCount"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "schemaVersion",
      +    "root",
      +    "projects",
      +    "summary"
      +  ],
      +  "title": "Project Detection Artifact",
      +  "type": "object"
      +}
  3. First observedv0.1.0

TDQS

A4.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered structurally. The description adds useful context beyond that: it reads local repository markers and returns project-detection/v1, with no test execution or file writes, which reassures an agent about side effects.

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

Conciseness4/5

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

Three sentences, front-loaded with the capability before the routing guidance. There is mild redundancy between "without auditing source targets" and "without executing tests or writing files," but each sentence still contributes a distinct point.

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

Completeness5/5

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

Complete for a read-only discovery tool: it explains what is inspected, what is produced, what is avoided, and where to go for a general review. Annotations and the output schema handle safety and return-shape details, so no critical gap remains.

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

Parameters4/5

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

Schema coverage is 100%, so both parameters are fully documented in the schema and the baseline is 3. The description adds the concept that project markers are inspected within a repository root, which reinforces but does not significantly extend what the schema already explains.

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?

Uses a specific verb ("discover") with a concrete output set: project roots, support status, and matching adapters. The scope exclusions ("without auditing source targets") and the named sibling (review_repository) make it distinguishable from alternatives at a glance.

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?

Explicitly states the use case ("when project boundaries are needed before a specialized workflow") and routes the general-review case to review_repository. It also implicitly excludes audit-style tools by saying it does not audit source targets.

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