Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"answers": {
"type": "object",
"properties": {
"cicd": {
"type": "array",
"items": {
"type": "string"
},
"description": "CI/CD practices - automatically running tests and deploying on every change."
},
"handle": {
"type": "string",
"description": "The developer GitHub handle. Optional. Infer from git config or the origin remote."
},
"apiStyle": {
"type": "string",
"description": "API style - REST, GraphQL, gRPC or tRPC."
},
"ideAgent": {
"type": "string",
"description": "The editor or AI IDE in use - claudecode, cursor, copilot, codex, windsurf. You are the IDE, so set this yourself."
},
"nonGoals": {
"type": "string",
"description": "What this project explicitly will NOT do."
},
"teamSize": {
"type": "string",
"description": "How many people are building this."
},
"databases": {
"type": "array",
"items": {
"type": "string"
},
"description": "Database kinds in use - SQL, NoSQL, cache/key-value, vector. As many as apply."
},
"otherApis": {
"type": "string",
"description": "External APIs or services not covered by integrations."
},
"platforms": {
"type": "array",
"items": {
"type": "string"
},
"description": "Platforms this should run on, e.g. web, ios, android, desktop. Infer from the dependency manifests and repo layout."
},
"scaleTier": {
"type": "string",
"description": "Expected scale of the system."
},
"userTypes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Who is going to use this system, e.g. end users, admins, internal staff."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Compliance regimes that apply - GDPR, HIPAA, SOC 2. Pick by the actual situation (EU users, health data, payments)."
},
"isNewBuild": {
"type": "boolean",
"description": "True for a greenfield project, false when adding onto an existing codebase."
},
"activeUsers": {
"type": "string",
"description": "Roughly how many active users are expected, as a range."
},
"projectName": {
"type": "string",
"description": "Short name for the project. Required by specpilot_generate_specs. Infer from the package manifest or the folder name."
},
"authStrategy": {
"type": "string",
"description": "Auth approach - a protocol built in-house (JWT/OAuth/SAML) or a managed service (Clerk, Auth0, Firebase)."
},
"availability": {
"type": "string",
"description": "Availability SLA target as a fraction of uptime."
},
"integrations": {
"type": "object",
"description": "Third-party integrations keyed by category, e.g. { payments: [\"stripe\"] }. Only categories relevant to the project type apply.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"accessControl": {
"type": "string",
"description": "The access control model."
},
"buildTimeline": {
"type": "string",
"description": "How long the build is expected to take."
},
"realtimeTypes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Realtime transports - WebSockets, SSE, polling. Leave empty when nothing needs to update live."
},
"systemPattern": {
"type": "string",
"description": "Architecture pattern - monolith, modular monolith, or microservices."
},
"customUserType": {
"type": "string",
"description": "A user type in free text, when none of the userTypes options fit."
},
"localDatabases": {
"type": "array",
"items": {
"type": "string"
},
"description": "On-device stores backing offline support. Leave empty when offline is not needed."
},
"offlineSupport": {
"type": "boolean",
"description": "Whether this has to work offline. Set automatically when localDatabases is non-empty."
},
"apiResponseTime": {
"type": "string",
"description": "Target API response time."
},
"projectCategory": {
"anyOf": [
{
"enum": [
"saas",
"api",
"mobile",
"cli",
"pipeline",
"ml",
"static",
"docs",
"extension",
"library",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Project archetype. Normally inferred from projectDescription when it exactly matches a returned chip label - send it only if you already know it."
},
"realtimeEnabled": {
"type": "boolean",
"description": "Whether anything updates live without a refresh. Set automatically when realtimeTypes is non-empty."
},
"testingStrategy": {
"type": "array",
"items": {
"type": "string"
},
"description": "Testing approaches this project will use."
},
"dataSyncStrategy": {
"type": "string",
"description": "How conflicting local and server state gets reconciled once the device is back online."
},
"languageOverride": {
"type": "string",
"description": "Primary language, when it should override what SpecPilot infers from the repo."
},
"securityConcerns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Security measures to plan for - encryption, rate limiting, audit logging."
},
"deploymentTargets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Where this ships - cloud hosting, a package registry, a browser store. The option list depends on the project type."
},
"accessibilityNotes": {
"type": "string",
"description": "Anything further on accessibility or constraints, in free text."
},
"projectDescription": {
"type": "string",
"description": "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."
},
"technicalConstraints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Hard constraints - budget, existing infrastructure, legacy systems, a fixed deadline."
},
"constraintDescription": {
"type": "string",
"description": "More detail on whatever was named in technicalConstraints."
},
"specialConsiderations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Cross-cutting concerns that apply, such as accessibility, internationalisation or offline support."
}
},
"description": "Every SpecPilot onboarding answer collected so far. The server is stateless, so resend the whole object on every call; omit it entirely on the first call to get step 1."
}
}
}