Skip to main content
Glama
Repo Test Architect

Repo Test Architect

Get Plan Execution Hints

get_plan_execution_hints
Read-onlyIdempotent

Derive provider-neutral execution, context, parallel-safety, and repository-reasoning hints from an existing test plan or repository root, without invoking models or subagents.

Instructions

Derive provider-neutral execution, context, parallel-safety, and repository-reasoning hints from a plan without invoking models or subagents. Pass an existing plan/v1 or project-test-plan/v1 artifact, or pass repoRoot to derive hints for the project-aware plan of that repository.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_plan_execution_hints"
  }
}

Input Schema

NameRequiredDescriptionDefault
planNoA plan/v1 or project-test-plan/v1 artifact. Omit it and pass repoRoot to plan the repository instead.
itemIdNoOptional stable plan item or project item id to select.
goTargetNo
repoRootNoRepository root to audit and plan instead of passing plan.
changedPathsNoOptional repository-relative source paths to limit target selection.
excludeProjectRootsNoOptional project roots or subtree patterns such as examples/** to exclude before planning.

Output Schema

NameRequiredDescriptionDefault
itemsYes
sourceYes
summaryYes
schemaVersionYes
failedProjectsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv1.2.0
    • addedInput schema / properties / changedPaths
      Added value: +{
      +  "description": "Optional repository-relative source paths to limit target selection.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / excludeProjectRoots
      Added value: +{
      +  "description": "Optional project roots or subtree patterns such as examples/** to exclude before planning.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / goTarget
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "goarch": {
      +      "description": "Explicit GOARCH for bounded Go build-constraint evaluation.",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "goos": {
      +      "description": "Explicit GOOS for bounded Go build-constraint evaluation.",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "tags": {
      +      "description": "Optional custom Go build tags passed to the target-aware verification command.",
      +      "items": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "goos",
      +    "goarch"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / plan / description
      Previous value: -"A plan/v1 or project-test-plan/v1 artifact."New value: +"A plan/v1 or project-test-plan/v1 artifact. Omit it and pass repoRoot to plan the repository instead."
    • addedInput schema / properties / repoRoot
      Added value: +{
      +  "description": "Repository root to audit and plan instead of passing plan.",
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "plan"
      -]New value: +[]
  2. Changed12 schema fields changedv1.1.0
    • removedOutput schema / $id
      Removed value: -"https://repo-test-architect.local/schemas/plan-execution-hints-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/plan-execution-hints-v1.schema.json in the published package."
    • addedOutput schema / properties / failedProjects
      Added value: +{
      +  "type": "array"
      +}
    • removedOutput schema / properties / items / items
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "action": {
      -      "enum": [
      -        "add-test",
      -        "extend-test",
      -        "defer"
      -      ]
      -    },
      -    "adapterId": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "complexity": {
      -      "enum": [
      -        "low",
      -        "medium",
      -        "high"
      -      ]
      -    },
      -    "contextScope": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "includeBuildConfiguration": {
      -          "type": "boolean"
      -        },
      -        "includeRepositoryInstructions": {
      -          "const": true
      -        },
      -        "mode": {
      -          "enum": [
      -            "target-only",
      -            "target-and-tests",
      -            "project-boundary"
      -          ]
      -        },
      -        "paths": {
      -          "items": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "minItems": 1,
      -          "type": "array",
      -          "uniqueItems": true
      -        }
      -      },
      -      "required": [
      -        "mode",
      -        "paths",
      -        "includeBuildConfiguration",
      -        "includeRepositoryInstructions"
      -      ],
      -      "type": "object"
      -    },
      -    "parallelizable": {
      -      "type": "boolean"
      -    },
      -    "path": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "planItemId": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "projectId": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "projectRoot": {
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "reasons": {
      -      "items": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "recommendedAgentRole": {
      -      "enum": [
      -        "implementation",
      -        "repository-reasoning",
      -        "review"
      -      ]
      -    },
      -    "requiresRepositoryReasoning": {
      -      "type": "boolean"
      -    },
      -    "target": {
      -      "minLength": 1,
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "planItemId",
      -    "action",
      -    "target",
      -    "path",
      -    "complexity",
      -    "contextScope",
      -    "parallelizable",
      -    "recommendedAgentRole",
      -    "requiresRepositoryReasoning",
      -    "reasons"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / properties / source / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / source / properties
      Removed value: -{
      -  "itemCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "root": {
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "schemaVersion": {
      -    "enum": [
      -      "plan/v1",
      -      "project-test-plan/v1"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / source / required
      Removed value: -[
      -  "schemaVersion",
      -  "itemCount"
      -]
    • removedOutput schema / properties / summary / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / summary / properties
      Removed value: -{
      -  "highComplexityCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "itemCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "lowComplexityCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "mediumComplexityCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "parallelizableCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "repositoryReasoningCount": {
      -    "minimum": 0,
      -    "type": "integer"
      -  }
      -}
    • removedOutput schema / properties / summary / required
      Removed value: -[
      -  "itemCount",
      -  "lowComplexityCount",
      -  "mediumComplexityCount",
      -  "highComplexityCount",
      -  "parallelizableCount",
      -  "repositoryReasoningCount"
      -]
    • removedOutput schema / title
      Removed value: -"Repo Test Architect Plan Execution Hints"
  3. Changed1 schema field changedv1.0.0
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$id": "https://repo-test-architect.local/schemas/plan-execution-hints-v1.schema.json",
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "items": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "action": {
      +            "enum": [
      +              "add-test",
      +              "extend-test",
      +              "defer"
      +            ]
      +          },
      +          "adapterId": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "complexity": {
      +            "enum": [
      +              "low",
      +              "medium",
      +              "high"
      +            ]
      +          },
      +          "contextScope": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "includeBuildConfiguration": {
      +                "type": "boolean"
      +              },
      +              "includeRepositoryInstructions": {
      +                "const": true
      +              },
      +              "mode": {
      +                "enum": [
      +                  "target-only",
      +                  "target-and-tests",
      +                  "project-boundary"
      +                ]
      +              },
      +              "paths": {
      +                "items": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array",
      +                "uniqueItems": true
      +              }
      +            },
      +            "required": [
      +              "mode",
      +              "paths",
      +              "includeBuildConfiguration",
      +              "includeRepositoryInstructions"
      +            ],
      +            "type": "object"
      +          },
      +          "parallelizable": {
      +            "type": "boolean"
      +          },
      +          "path": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "planItemId": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "projectId": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "projectRoot": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "reasons": {
      +            "items": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "recommendedAgentRole": {
      +            "enum": [
      +              "implementation",
      +              "repository-reasoning",
      +              "review"
      +            ]
      +          },
      +          "requiresRepositoryReasoning": {
      +            "type": "boolean"
      +          },
      +          "target": {
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "planItemId",
      +          "action",
      +          "target",
      +          "path",
      +          "complexity",
      +          "contextScope",
      +          "parallelizable",
      +          "recommendedAgentRole",
      +          "requiresRepositoryReasoning",
      +          "reasons"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "schemaVersion": {
      +      "const": "plan-execution-hints/v1"
      +    },
      +    "source": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "itemCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "root": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "schemaVersion": {
      +          "enum": [
      +            "plan/v1",
      +            "project-test-plan/v1"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "schemaVersion",
      +        "itemCount"
      +      ],
      +      "type": "object"
      +    },
      +    "summary": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "highComplexityCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "itemCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "lowComplexityCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "mediumComplexityCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "parallelizableCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "repositoryReasoningCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "itemCount",
      +        "lowComplexityCount",
      +        "mediumComplexityCount",
      +        "highComplexityCount",
      +        "parallelizableCount",
      +        "repositoryReasoningCount"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "schemaVersion",
      +    "source",
      +    "summary",
      +    "items"
      +  ],
      +  "title": "Repo Test Architect Plan Execution Hints",
      +  "type": "object"
      +}
  4. First observedv0.1.0

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered; the description nonetheless adds a meaningful behavioral fact: no model or subagent invocation, i.e. cheap deterministic derivation. It does not elaborate on cost, limits, or failure behavior, and it does not need to explain return values since an output schema exists.

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?

Two front-loaded sentences with no filler: capability and non-invocation caveat first, invocation modes second. Dense but every clause carries information.

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?

Given an output schema that documents return values and a schema with high description coverage, the description supplies the essential frame: what is derived, that no models are invoked, and the two entry paths. Minor incompleteness around when this is preferred over sibling analysis tools, but nothing needed to call it correctly is missing.

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?

With 83% schema description coverage, the schema carries most parameter meaning, including the plan-vs-repoRoot alternative and the goTarget fields. The description restates the two top-level modes but adds no syntax, defaults, or selection rules for itemId, changedPaths, excludeProjectRoots, or goTarget, so a baseline 3 applies.

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

Purpose4/5

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

Uses a specific verb ('Derive') with a well-enumerated resource ('provider-neutral execution, context, parallel-safety, and repository-reasoning hints from a plan'), and the 'without invoking models or subagents' clause separates it from generation-oriented siblings like generate_test_plan. It stops short of naming a sibling or stating which analysis tool it replaces, so the differentiation is implicit.

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

Usage Guidelines3/5

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

The description tells the agent how to invoke it in two modes (pass a plan artifact, or pass repoRoot) but gives no when-to-use versus when-not guidance and no explicit alternatives among the many analyze_/generate_ siblings. Usage is implied by the invocation modes rather than stated as a selection rule.

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