Skip to main content
Glama

SpecPilot

SpecPilot: next onboarding questions

specpilot_next_questions

Returns the still-unanswered SpecPilot onboarding questions of the next incomplete step, gated by the answers supplied so far - questions that do not apply to this kind of project are omitted, and options are filtered, badged or flagged the same way the SpecPilot web chat would. Stateless: send every answer collected so far on each call.

Procedure: (1) Decide whether the repository already has real source code and set isNewBuild accordingly - it changes which onboarding analysis is generated at the end. (2) Infer what the repo already answers rather than asking: platforms from the dependency manifests and layout, languageOverride, ideAgent (you are the IDE - claudecode, cursor, copilot, codex, windsurf), handle from git config or the origin remote, projectName from the package manifest or folder name, and projectDescription from the README only if it plainly says what the project is. (3) Call this tool with what you have; answer what the repo makes obvious and ask the developer the rest, a whole step per message. Send an empty value for an optional question the developer declines, or it will be asked again; send todoSentinel verbatim when they do not know yet. For projectDescription, sending one of the returned chip labels exactly is what infers projectCategory and gates every later question - free prose infers nothing. Confirm any pre-seeded value rather than accepting it silently. (4) Loop until done is true, then call specpilot_generate_specs and follow its nextSteps for where each file goes.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
answersNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 schema fields changed
    • addedInput schema / properties / answers / properties / accessControl / description
      Added value: +"The access control model. Drives the security spec auth/authorization section and the permission model."
    • addedInput schema / properties / answers / properties / accessibilityNotes / description
      Added value: +"Anything further on accessibility or constraints, in free text."
    • addedInput schema / properties / answers / properties / activeUsers / description
      Added value: +"Roughly how many active users are expected, as a range."
    • addedInput schema / properties / answers / properties / apiResponseTime / description
      Added value: +"Target API response time."
    • addedInput schema / properties / answers / properties / apiStyle / description
      Added value: +"API style - REST, GraphQL, gRPC or tRPC. Shapes how the architecture spec documents client-server communication."
    • addedInput schema / properties / answers / properties / authStrategy / description
      Added value: +"Auth approach - a protocol built in-house (JWT/OAuth/SAML) or a managed service (Clerk, Auth0, Firebase). Feeds the security spec."
    • addedInput schema / properties / answers / properties / availability / description
      Added value: +"Availability SLA target as a fraction of uptime; higher percentages allow far less downtime per year."
    • addedInput schema / properties / answers / properties / buildTimeline / description
      Added value: +"How long the build is expected to take."
    • addedInput schema / properties / answers / properties / cicd / description
      Added value: +"CI/CD practices - automatically running tests and deploying on every change."
    • addedInput schema / properties / answers / properties / compliance / description
      Added value: +"Compliance regimes that apply - GDPR, HIPAA, SOC 2. Pick by the actual situation (EU users, health data, payments), since getting it wrong has legal consequences."
    • addedInput schema / properties / answers / properties / constraintDescription / description
      Added value: +"More detail on whatever was named in technicalConstraints."
    • addedInput schema / properties / answers / properties / customUserType / description
      Added value: +"A user type in free text, when none of the userTypes options fit."
    • addedInput schema / properties / answers / properties / dataSyncStrategy / description
      Added value: +"How conflicting local and server state gets reconciled once the device is back online."
    • addedInput schema / properties / answers / properties / databases / description
      Added value: +"Database kinds in use - SQL, NoSQL, cache/key-value, vector. As many as apply."
    • addedInput schema / properties / answers / properties / deploymentTargets / description
      Added value: +"Where this ships - cloud hosting, a package registry, a browser store. The option list depends on the project type."
    • addedInput schema / properties / answers / properties / handle / description
      Added value: +"The developer GitHub handle. Optional; it namespaces generated task IDs (e.g. CD-jsmith-001). Infer from git config or the origin remote."
    • addedInput schema / properties / answers / properties / ideAgent / description
      Added value: +"The editor or AI IDE in use - claudecode, cursor, copilot, codex, windsurf. You are the IDE, so set this yourself; it decides which rules and config files are generated."
    • addedInput schema / properties / answers / properties / integrations / description
      Added value: +"Third-party integrations keyed by category, e.g. { payments: [\"stripe\"] }. Only categories relevant to the project type apply."
    • addedInput schema / properties / answers / properties / isNewBuild / description
      Added value: +"True for a greenfield project, false when adding onto an existing codebase. Decides which onboarding analysis is generated at the end."
    • addedInput schema / properties / answers / properties / languageOverride / description
      Added value: +"Primary language, when it should override what SpecPilot infers from the repo."
    • addedInput schema / properties / answers / properties / localDatabases / description
      Added value: +"On-device stores backing offline support. Leave empty when offline is not needed."
    • addedInput schema / properties / answers / properties / nonGoals / description
      Added value: +"What this project explicitly will NOT do. Becomes the non-goals section of the specs."
    • addedInput schema / properties / answers / properties / offlineSupport / description
      Added value: +"Whether this has to work offline. Set automatically when localDatabases is non-empty."
    • addedInput schema / properties / answers / properties / otherApis / description
      Added value: +"External APIs or services not covered by integrations."
    • addedInput schema / properties / answers / properties / platforms / description
      Added value: +"Platforms this should run on, e.g. web, ios, android, desktop. Infer from the dependency manifests and repo layout."
    • addedInput schema / properties / answers / properties / projectCategory / description
      Added value: +"Project archetype. Normally inferred from projectDescription when it exactly matches a returned chip label - send it only if you already know it."
    • addedInput schema / properties / answers / properties / projectDescription / description
      Added value: +"One line saying what the project is. Required by specpilot_generate_specs. Sending one of the chip labels returned by specpilot_next_questions verbatim is what infers projectCategory and gates every later question; free prose infers nothing."
    • addedInput schema / properties / answers / properties / projectName / description
      Added value: +"Short name for the project. Required by specpilot_generate_specs. Infer from the package manifest or the folder name."
    • addedInput schema / properties / answers / properties / realtimeEnabled / description
      Added value: +"Whether anything updates live without a refresh. Set automatically when realtimeTypes is non-empty."
    • addedInput schema / properties / answers / properties / realtimeTypes / description
      Added value: +"Realtime transports - WebSockets, SSE, polling. Leave empty when nothing needs to update live."
    • addedInput schema / properties / answers / properties / scaleTier / description
      Added value: +"Expected scale of the system. Drives infrastructure and architecture choices."
    • addedInput schema / properties / answers / properties / securityConcerns / description
      Added value: +"Security measures to plan for - encryption, rate limiting, audit logging."
    • addedInput schema / properties / answers / properties / specialConsiderations / description
      Added value: +"Cross-cutting concerns that apply, such as accessibility, internationalisation or offline support."
    • addedInput schema / properties / answers / properties / systemPattern / description
      Added value: +"Architecture pattern - monolith, modular monolith, or microservices."
    • addedInput schema / properties / answers / properties / teamSize / description
      Added value: +"How many people are building this."
    • addedInput schema / properties / answers / properties / technicalConstraints / description
      Added value: +"Hard constraints - budget, existing infrastructure, legacy systems, a fixed deadline."
    • addedInput schema / properties / answers / properties / testingStrategy / description
      Added value: +"Testing approaches this project will use."
    • addedInput schema / properties / answers / properties / userTypes / description
      Added value: +"Who is going to use this system, e.g. end users, admins, internal staff."
  2. First observed

TDQS

A4.8/5.0
Behavior5/5

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

No annotations exist, so the description carries the full burden and does so: it declares the tool is stateless and that every answer collected so far must be resent each call (a critical calling convention), that inapplicable questions are omitted, that options are filtered/flaggable, and that projectDescription chips gate all later questions. This is exactly the behavioral context an agent cannot get from the schema.

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?

Purpose is front-loaded, then a four-step numbered procedure, so structure is strong and nothing is decorative. It is long with some dense multi-clause sentences, but the length is largely justified by the tool's multi-step, stateful-by-convention nature.

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?

With no output schema, the description still explains the return-relevant contract: the questions themselves, the chip labels, the omission behavior, and the `done` flag that terminates the loop and triggers specpilot_generate_specs. An agent has everything needed to drive the workflow to completion.

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?

The nested schema documents each field, so the description's job is to add semantics beyond it, which it does for the highest-risk fields: how to infer isNewBuild, platforms, ideAgent, handle, projectName, and the chip-vs-prose distinction for projectDescription. The empty-value and todoSentinel conventions are procedural rules not expressible in the schema. It stops short of describing every field, but the important ones are covered.

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 opening sentence names a specific resource and scope: 'the still-unanswered SpecPilot onboarding questions of the next incomplete step, gated by the answers supplied so far'. It also distinguishes the tool from its sibling by ending the workflow at specpilot_generate_specs, so an agent can tell the two apart without reading either schema.

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?

Explicit numbered procedure covers when to call it (step 3), what to infer before calling (step 2), how to loop (step 4), and the exit condition plus hand-off to specpilot_generate_specs. Edge cases (declined optional answers, todoSentinel, chip labels) each have stated handling.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.