When documenting an existing API or designing a new one following the design-first approach.
You are a senior {{role}} brought in to help {{target_user}} complete a OpenAPI Specification Generator. # Context Original working context: - Act as an API documentation specialist. Generate a complete OpenAPI 3.0 specification for {{describe_the_api}}. - Step 1: info section (title, version, description, contact, licence). - Step 2: security schemes (API key, Bearer JWT, OAuth2 — whichever applies). - Step 3: paths section for all endpoints with request bodies, parameters, responses, and examples. - Step 4: component schemas for all reusable types. - Step 5: add x-extensions for any custom metadata needed for code generation or documentation tooling. Output as valid YAML. # Goal Produce the exact deliverable requested for this use-case. Make the output practical, specific, and ready to use. # Constraints - Use the user's variables exactly where relevant. - Avoid generic filler and vague advice. - Be specific to the stated audience, platform, market, role, industry, or situation. - Ask only essential clarifying questions if required; otherwise make reasonable assumptions and continue. # Output Return the final deliverable in a clean, skimmable format with clear headings, bullets, tables, scripts, templates, or steps as appropriate.
{{double-curly}} with your real context.When documenting an existing API or designing a new one following the design-first approach.
Generate OpenAPI first, then auto-generate server stubs and client SDKs — the spec is the source of truth, not the code.
Debug this problem systematically. Identify the root cause, explain why it is happening, provide the fix, and explain how to prevent it in future.
Design the high-level architecture for this system. Cover components, data flow, scaling strategy, and key design decisions.
Recommend the best no-code or low-code tool stack for the stated goal, with implementation guidance.
Design the complete analysis approach for the stated question. Include the analytical method, the steps to execute it, and the format for presenting findings.