Repository

ProcessTier 2 · build and shipPhase 6 · Run it like a company

The shared home of a project's code and its full history, usually hosted on GitHub or GitLab.

A project's code, its history, and its collaboration all need a single home that everyone syncs with, or scattered copies drift apart. A repository exists as that shared store of the code and its full history, the one place a team clones from and pushes to.

A repository ("repo") holds all of a project's code plus its complete Git history. Hosted services like GitHub keep the shared copy everyone syncs with, and add tools around it: reviews, issue tracking, and automation.

When someone says "it's in the repo," they mean it's in the project's shared codebase. A company has many repos, often one per service or product.

A junior PM, stuck

I asked the backend engineer where the delivery-fee logic is tracked and he said "it's in the repo, check the README." The link dropped me on a GitHub page full of folders I have never opened, and I do not even know if I am allowed to be in here. I do not want to go back and ask him to screen-share over something this basic.

That page is the front door of the codebase, a map of the system, not the code itself, and reading a map is not the same as reading code. You can learn to orient on any repo home page in about five minutes, and you will know where things live and whether you can touch them. This is the actual front page of tiffinbox-api, trimmed to the parts that answer your question. Read it top to bottom once, then take the steps with me.

tiffinbox-api repository home page
Files
src/routes/ the API endpoints: products, search, orders, auth
src/workers/ background jobs: receipt emails, order SMS
.env.example the list of config keys the app needs, no real secrets
README.md how to run it locally and who owns each area
Recent commits
a1b3c9f Rafi ship v2.4.2 checkout fix behind 10% canary 2026-03-06
9d4e2a1 Nadia roll back to v2.4.0 2026-03-06
5f1c0b8 Rafi add missing index on search query 2026-03-03
Access
Visibility: private. Only invited members can see the code.
Default branch: main, protected. Merges need one review.
Backend team: write. Product (you): read. Deploys: CI only, from main.

Click a step to see the lines it points at.

Asking an engineer to walk you through the repo before reading the folder names yourself. The layout answers most of "where does X live" in two minutes, and you look sharper for having looked first.
Confusing read access with the code being fair game to change. You can browse a private repo you have read on and still have no ability to merge; knowing which one you have avoids promising a change you cannot make.
Treating the repo as one undifferentiated pile of code. It is a labeled map: routes, workers, config, docs, each folder a part of the system, and once you see that, "check the repo" stops being scary.
Ignoring the visibility and access settings because they look like plumbing. Who can see and change the code is a real security surface, and a public repo that should be private is exactly the kind of thing a PM is well placed to catch.

Reply in the thread: "Found it, the delivery-fee logic is under src/routes with the orders endpoint, and I can see it with my read access. I will follow the README to run it locally." You just oriented on a repo home page by its map instead of its code, which works on every repository you will ever be handed a link to.

Repos are where code, and often issues and documentation, live; knowing this helps you navigate where work is tracked.
Access to a repo is access to the code; who can see and change it is a security matter.

"That script's in a separate repo, I'll link it."

Appears in Phase 6, Run it like a company.