Skip to Content

Is your team lost in folders? Discover how to structure Odoo projects with an efficient template

Learn how to organize your Odoo projects with root folders, README files and AI agents to optimize teamwork and avoid document chaos.
April 27, 2026 by
Is your team lost in folders? Discover how to structure Odoo projects with an efficient template
Wilfredo Fernando Pastor Avila
| No comments yet

The chaos of searching for files: a story you will recognize

Imagine you arrive at an industrial kitchen for the first time. You need to make a stew, but you don't know where the pots, the strainers or the ingredients are. You open drawers, check cupboards, and lose a valuable hour. That is how it feels to work on an Odoo project without a clear structure. At Ganemo, we have seen entire teams lose productivity for not having a defined folder template. That is why we created an organization system that turns chaos into flow.

What root folders are and why they matter

Root folders are the first level of folders you see when you open a project. They define the entire organization structure. If your team doesn't know them, each member will search blindly. For example, at a client company, they had a shared drive with dozens of subfolders and no order. When we introduced root folders such as agents, addons, addonativos and docs, we cut search time by 70%. Once everyone knows what goes in each folder, work flows. At Ganemo, we help define these folders for your Odoo project, so your team works in harmony.

The README: your roadmap

A README file explains the purpose and structure of a folder. It is like the sign that says "pots here". At Ganemo, every project includes a README at the root, detailing what each folder does and what should not be saved there. For example, a development team had an addons folder where they mixed native and custom modules. After adding a README specifying that only custom modules go there, dependency errors dropped. Ganemo provides ready-to-use README templates.

Configuration files: deploy and secrets

At the project root, files such as odo_deploy.yaml and odo_deploy_secrets.yaml store variables to deploy automatically to Odoo.sh. For example, a client publishing modules to the Odoo store had to remember the URLs and keys every time. With these files, their AI agent performs the deployment without human intervention. Ganemo sets up these files with the required variables, saving you time and errors.

The .agents folder: the brain of your project

Following Google Antigravity guidelines, the .agents folder contains rules, skills and workflows. The rules are laws the agent must not break; skills are abilities such as "create a rule"; and workflows are sequences of instructions. For example, a workflow can create a module icon and banner and update the manifest, all in a single command. At Ganemo, we design these workflows so your agent works autonomously while you focus on other tasks. Don't waste time giving step-by-step instructions.

Addons: custom modules

In addons we keep Ganemo's custom modules. When starting a project, we only include the modules needed. If you need dependencies, our agent downloads them automatically from GitHub thanks to the MCP integration. For example, a client needed the fsm_geofencing_control module and all its dependencies. With a single instruction, the agent cloned and added everything to the addons folder. Ganemo optimizes this process so your project is ready in minutes.

With Ganemo, your team works organized from day one

Our Odoo project template, developed and refined through continuous retrospectives, removes friction from teamwork. Whether you are a developer or a manager, a clear structure saves time and reduces errors. Implement today, with Ganemo, the template that will transform the way you work.

Related video

Is your team lost in folders? Discover how to structure Odoo projects with an efficient template
Wilfredo Fernando Pastor Avila April 27, 2026
Share this post
Tags
Archive
Sign in to leave a comment
Your agent can build you auth. And that's the problem.
When you ask an AI agent to set up social login, you win on day 1 and start losing on day 400. When to let it build it and when not to.