- Foundation
- 90 min for a first pass
- 8 min read
After this lesson you can
- List every outside tool or service the product depends on.
- Map each integration to the company function it serves.
- Say what breaks if each integration stops, and who owns it.
- Keep secrets out of the register: names and methods only.
Read these first
You can fill in this template on the page. Go to the form.
The integrations register is the second Week 1 template. It lists every outside tool, vendor or service your product relies on, and shows which part of the company each one serves.
Download the blank template
- Excel file (original format): template-4-integrations-register.xlsx
- Markdown copy, to keep in git: template-4-integrations-register.md
Make your own copy first. In git, keep it as map/integrations-register.md. The workbook has three sheets: Cover, Integrations register and Function map.
Why it matters
Modern products are built from other people’s products. A payment provider, an email sender, an analytics tool, a login service, a customer database. Each one is a promise from someone else, and each one can change its price, its rules or its availability without asking you. If no one has written the list, then no one knows what your product depends on. The first time an integration fails, the whole team learns the list the hard way.
The register is also a map of the company. Every integration serves a function: sales, marketing, finance, support, operations, identity and security, product and data, legal, people. When one function has no integration, a manual spreadsheet is probably doing the work. When one function has ten, you may have overlap. When an integration has no owner, you have a risk.
Key ideas
- Integration: a link between your product and an outside tool or service.
- Function: the part of the company the tool serves.
- Data in and out: what you send and what you receive. This is where privacy and security questions begin.
- Owner: a person responsible for the account, the cost and the relationship.
- How we log in (method only): for example “single sign-on”, “shared team login in the password manager”, “API key held in the secrets vault”. Never the secret itself.
- What breaks if it stops: the sentence that shows how important the tool is.
How to fill it: steps
- Start from the repository map. Every row of type Integration, Payments, CRM and many of Ops hides an outside tool.
- Look at invoices, the company card statement and the domains the product calls. Real bills and real network calls find tools nobody remembers.
- Write one row per tool. Use the tool’s name in the first column.
- Fill the company function it serves. If it serves two, pick the main one and mention the other in the “what it does” cell.
- In “Product parts it connects”, use the names from your repository map. This links the two sheets.
- Describe data in and out in plain words. “Email addresses go in; delivery reports come out.”
- Write the owner, the cost or contract, and how you log in (method only).
- Write what breaks if it stops, and the status: live, trial, planned, being removed.
- Fill the Function map sheet. Count integrations per function and write a short check: ok, none, too many, no owner.
Every field explained
| Column | What to write | TrailMug example (fictional) |
|---|---|---|
| Integration / tool | The product’s name | Payment provider (example) |
| Vendor | The company behind it | A well-known payment company |
| What it does for us | One plain sentence | Takes the deposit and pays refunds |
| Company function it serves | One of the functions in the list | Finance |
| Product parts it connects (repo map names) | Names from the repository map | trailmug-pay, trailmug-app |
| Data in and out | What goes in and out | Amounts and card tokens go in; payment status comes out. We never hold card numbers. |
| Owner | A person | Finance lead |
| Cost or contract | Price model and renewal date | Per-transaction fee; annual review in May |
| How we log in (method only, never secrets) | The method | Company single sign-on with two-step check |
| What breaks if it stops | The impact in one sentence | No new sign-ups; refunds stop |
| Status | Live, trial, planned, removing | Live |
The Function map sheet has one row for each function:
| Function | Count | Check |
|---|---|---|
| Sales | 1 | OK |
| Marketing | 2 | OK |
| Finance | 1 | One payment provider, no backup |
| Support | 1 | OK |
| Operations | 2 | OK |
| Identity and security | 1 | Owner unknown, look again |
| Product and data | 1 | OK |
| Legal and compliance | 0 | No tool found: terms live in a shared folder |
| HR and people | 0 | Not part of this product |
A filled example in short
| Tool | Function | Connects | Breaks if it stops | Owner |
|---|---|---|---|---|
| Email sender | Marketing and support | trailmug-int-email, trailmug-svc-returns | No refund or welcome emails | Marketing lead |
| Analytics tool | Product and data | trailmug-site, trailmug-app | No funnel numbers; the roadmap review has no evidence | Product |
| CRM service | Sales | trailmug-crm, trailmug-site | Café leads are lost | Sales |
| Login service | Identity and security | trailmug-app | Nobody can log in | NOBODY |
The last row is the most useful. A login service with no owner is a risk written on paper, and a candidate for an epic.
Working with AI agents
- May: search the repositories for the names of outside services, so you find tools you forgot. You check each result. Explain a vendor term.
- May not: decide what an integration is worth, write the “what breaks” sentence for you, or invent a vendor.
- Never: paste a password, key or token into an agent, a chat or the register.
- Disclose: one line in your weekly note.
- A safe brief: “Search these repositories for outbound web addresses and library names that look like outside services. List each with the file path. Do not open any secrets file.”
Common mistakes
- A secret in the register. Names and methods only. If you pasted one, rotate it and tell your coach. Leaking a secret is serious, even in a practice repository.
- No owner. Write NOBODY so that someone can act.
- Missing the free tools. A free plan is still a dependency.
- “What breaks” left empty. If you cannot say, you do not yet understand the dependency.
- Functions with zero count and no check. A zero is a finding. Write it down.
- One row for a whole suite. If a vendor gives you three products, write three rows.
Practice
- Check the last three months of invoices and list every vendor you find.
- Fill the register for five tools. Ask a classmate to name one thing you missed.
- Fill the function map. Pick one function with a zero and write what is doing that job today.
- For one integration, write the “what breaks if it stops” sentence in front of someone who does not work in engineering. Ask if they understand.
Checklist
- Every outside tool has a row.
- Every row names the function and the repository map parts it connects.
- Data in and out is written in plain words.
- Every owner is a person, or NOBODY.
- Login entries show the method only.
- The function map is complete with a check for every function.
- No secret appears anywhere.
The 2030 Product Development Manager lens
- You decide: which dependencies are acceptable, which need a backup and which need an owner now.
- You delegate to agents: scanning repositories for outside service names, comparing the list with invoice lines you paste in, checking that every row is filled.
- A sample brief: “Read the register. For each row, tell me if any cell is empty. Do not fill the empty cells.”
- You verify by: checking two vendors on the list against real invoices.
- Disciplines involved: finance, legal, security, operations, procurement and engineering.
- On the agent ladder: use. Later, when you delegate work to agents, the register tells you which outside systems they may and may not touch.
Further learning
Continue with Week 1 and Deck 5. The register links to the repository map through the “product parts it connects” column.
Fill it in here
This is a form version of the template. What you type is saved as a draft only in this browser, on this device. Nothing is sent anywhere and there is no account. It is not a grade and not a certificate. Write the answers yourself, in your own words. Do not type passwords, keys or real customer data. When you are ready, copy the Markdown at the end into a file in your own repository.
Integrations register
Week 1. One row per outside tool or service. Fill this in YOUR OWN words from what you really see in the repos, systems and conversations. Do not ask an AI agent to fill it in. Never write passwords, keys or tokens here. Names and methods only.
You can remove the last row when it is empty.
Function map
Copy this text into a file in your own repository. If copying does not work in your browser, select the text in the box and copy it yourself.
Go deeper
Further learning
Free or low-cost material from other publishers. We opened every link; check the cost label before you start.
Atlassian
Atlassian: IT service catalogs (opens the publisher's site in a new tab)
- Free
- Article
- Intermediate
Explains what a service catalogue is and what an entry usually contains. It is written for classic IT teams, so compare it with a catalogue kept as files in git. Use it to understand why owners and support details matter.
Atlassian
Project dependencies (opens the publisher's site in a new tab)
- Free
- Article
- Intermediate
Explains the kinds of dependency between pieces of work and how to track them. Read it before you order your epics.
OWASP
Secrets Management - OWASP Cheat Sheet Series (opens the publisher's site in a new tab)
- Free
- Docs
- Intermediate
- about 30 minutes
Practical rules for storing, handing out and rotating passwords, keys and tokens. Read it before you let an agent touch configuration, CI or deployment.
Google
Google SRE Book: Embracing risk (opens the publisher's site in a new tab)
- Free
- Book
- Intermediate
A chapter that explains why perfect reliability is the wrong goal and how error budgets balance speed and safety. It is the base for the service level ideas in this program. Read it slowly; the ideas matter more than the maths.
GOV.UK Service Manual
4. Make the service simple to use (opens the publisher's site in a new tab)
- Free
- Docs
- Beginner
Point 4 of the Service Standard: make the common tasks simple. Use it as a test for every screen in your mockups.
Backstage
Backstage Software Catalog (opens the publisher's site in a new tab)
- Free
- Docs
- Intermediate
Explains how a catalogue of services can be kept as files in the same repositories as the code. This is the same idea as catalogue entries in git. Read the overview to see what an entry holds.



