# Directory structure

Takomo project's directory structure looks like this.

```bash
.
├─ stacks
├─ templates
├─ helpers
├─ partials
├─ resolvers
├─ hooks
├─ schemas
├─ deployment
├─ config-sets
└─ organization
```

There are two mandatory directories: **stacks** and **templates**. The stacks directory will contain all configuration files for your stacks, and the templates directory is where you'll place template files for the stacks.

You can find the purpose of each directory from the table below.

| Directory    | Description                                                                                                                                                                                                                                                              |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| stacks       | Configuration files for stacks. You can create subdirectories to organize stacks and to provide common configuration. Takomo treats each subdirectory as a stack group, You can provide configuration for a stack group by placing a config.yml file into its directory. |
| templates    | CloudFormation template files that can be referenced from the stack configuration files. You can use subdirectories to organize template files.                                                                                                                          |
| helpers      | Custom Handlebars helpers. You can use helpers in stack configuration and template files.                                                                                                                                                                                |
| partials     | Handlebars partial files. You can include partial files in stack configuration and template files.                                                                                                                                                                       |
| resolvers    | Custom resolvers.                                                                                                                                                                                                                                                        |
| hooks        | Custom hooks.                                                                                                                                                                                                                                                            |
| schemas      | Custom Joi schemas.                                                                                                                                                                                                                                                      |
| deployment   | Configuration for [deployment targets](broken://pages/-MXR3PIS38_5jTTCimTt).                                                                                                                                                                                             |
| organization | Configuration for [AWS organization management](https://organizations.takomo.io).                                                                                                                                                                                        |
| config-sets  | Config sets                                                                                                                                                                                                                                                              |


---

# 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.takomo.io/configuration/directory-structure.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.