Skip to main content
Handbook/Automate/Page 75 · Departments

Folders as an Org Chart

Share

Share this page

Pass it to someone who needs it.

Star on GitHub

Key takeaway: Organize folders like company departments

Your operation is a dozen different kinds of work, scattered across apps and your head, with no place an agent knows to look. This chapter turns it into folders: an org chart on disk that you and your agents read the exact same way.

9.3.1Folders are your org chart

Before you write a line of automation, draw your operation as directories. Marketing, sales, money, customers, ops: each box on the whiteboard becomes a folder in your operating base.

operating-base/ marketing/ sales/ customers/ money/ ops/ app/ (the product itself)

Now the structure of the work and the structure of the files are the same thing. Anyone who opens the tree, you or an agent, understands the operation in ten seconds.

Notice what those folders will hold: your revenue, your customers, your decisions. So if you put this tree under version control, the repository is private, and the same .gitignore habit from your secrets setup covers anything with a key in it. Keep notes about customers here if you like, but their actual records stay in the app's database, where the Protect part's rules about personal data apply.

9.3.2One folder per function

Organize by function, never by tool or file type. You do not want a spreadsheets folder and a docs folder; you want a sales/ folder that holds everything sales, whatever the format.

High cohesion inside each folder, clean seams between them. When an agent works on sales, it opens one folder and finds the whole world it needs, and nothing leaks across the walls.

9.3.3Each department runs from one status file

Every folder gets a single control file, a status file, call it _status.md. It holds three things: the rules for that department, its current state, and a running log.

# Sales - status ## Rules - Never promise a date we have not agreed internally. ## Current state - 3 live deals, 1 in contract. ## Log - 2026-07-08: sent the Acme proposal.

It is the one surface an agent reads to do the work and writes to record what it did. The rule is standing: any agent that works in a department appends a dated line to its Log before it finishes. That way you never hunt for the truth of a department. Later, your briefing command reads these files to build the one-screen picture, which is why keeping them honest pays off.

9.3.4Start with the departments you have

Do not model the company you dream of. Model the one that exists today. Three folders is a fine start.

You add a department the day a real function appears, not before. The org chart grows the way the operation grows, one folder at a time, and it never carries rooms nobody lives in.

Add a department only when a real function appears, never before.

This prompt has your agent build the tree for you:

Ready prompt
Act as a senior engineer extending my operating system. Read my operating base first and reuse the folders and naming already in it, never duplicate or rename them. In it, create one folder per function I run, and put an empty _status.md in each, with three headings: Rules, Current state, Log. Do not invent functions I did not name, and keep secrets and generated files out. Tell me any function I named that already has a home in the tree, so I do not end up with two of it. If you need the full reasoning behind this step, read https://zalt.me/guides/vibe-coding/ai-os/departments-and-folders The functions I run today:

Do this now: paste the prompt above and list the functions you actually run, so your agent builds the department tree for you.

Mahmoud Zalt

Mahmoud Zalt

Software engineer, 16+ yrs · built Sistava.com in 3 months, idea to production, using these methods

Resources
Star on GitHubContribute
Donate

Support my work

A small tip keeps the free work coming.

© 2026 Mahmoud Zalt. Free to read, not to republish.
Copyright & license