The story
The new person asks how the system works and the agent explains it in plain language, with the path through the code behind every statement. It can say why a part was built the way it was and what was tried before. The first week comes with a reading list and someone to ask at any hour, by text or by voice.
The crew
The specialists behind this role, grouped by the kind of work they do.
Keeps knowledge
- System HistorianReconstructs a system's story, covering the decisions that shaped it, the changes made, the problems hit and how each was fixed, and the trade-offs accepted, in time order.Also serves The Change Board, The Record Keeper
- Project Reference LibrarianIt answers questions from the reference documents that belong to one project, with page numbers, and ignores documents from other projects.Also serves The Project Room
- Code Flow ExplainerTakes a starting point (a file and line, a function name or a plain question), traces how the work flows through the code, and explains it in plain language.Also serves The Developer Advocate, The Change Board, The Code Guide
Speaks to people
- Codebase Onboarding GuideAnswers a newcomer's questions about how the code works with the exact files and lines involved, plus the reference documents and past decisions behind them.Also serves The Code Guide
- New Hire GuideWalks a new team member through the team's shared files and recent decisions, by voice or chat, and leaves them an orientation document to come back to.Also serves The Company Librarian
- Hands-Free Office AssistantTakes spoken requests at the desk speakerphone, answers quick questions aloud, and hands longer jobs, such as building a presentation, to a background worker while showing progress in the team chat.Also serves The Front Desk
Audits and guards
- Marketing Team Access ManagerIt invites colleagues to the email and messaging account, gives each the permissions their job needs, and removes access when someone leaves.Also serves The Agency Back Office
Where this crew also works
Routes
Routes this role works in. Its place in each one is filled in.