# Introduction

Specgen allows developers to write specification of HTTP API and/or JSON models.

Specgen provides good quality code generation for HTTP service, client and models code. This is full implementation of API-first approach. API creation/changes happens first in the formal API specification and then these changes automatically reflected in the code.

The documentation is split into following sections:

## spec

Section [spec](https://docs.specgen.io/spec/format) describes spec format language and all aspects of it.

## specgen

Section [specgen](https://docs.specgen.io/specgen/overview) describes code generation features. It also includes documentation for all build plugins.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.specgen.io/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.