thinkhard.SI

Prompt repository Engineering & code

Write an onboarding guide to your codebase for new engineers

New engineers keep asking the same questions, and you want a guide that gets them running the system and shipping a first change.

Registry no.
ENG-039
Collection
Engineering & code
Laid out for
Any chat model
Score
10 out of 10
Blanks to fill
8
Added

Engineering & codeAny chat

The prompt

Score 10 of 10, Excellent

Use it when New engineers keep asking the same questions, and you want a guide that gets them running the system and shipping a first change.

  • {{team}}
  • {{folder_tree}}
  • {{docs}}
  • {{setup_steps}}
  • {{how_we_work}}
  • {{contacts}}
  • {{first_tasks}}
  • {{terms}}
Full prompt and why it works
Prompt
Write an onboarding guide to our codebase for engineers in their first two weeks on {{team}}, so that a new engineer can run the system, find their way around the code and ship a first small change without having to ask the basic questions.

The repository's folder tree, two levels deep:
"""
{{folder_tree}}
"""

The README and any architecture notes:
"""
{{docs}}
"""

Setup steps that work today, as the team runs them:
"""
{{setup_steps}}
"""

How we work (branches, reviews, tests, deploys): {{how_we_work}}
Who to ask about what, by area (handles as the team uses them, or roles): {{contacts}}
Good first tasks, if we keep a list: {{first_tasks}}
Internal terms a newcomer will hear: {{terms}}

Use these sections, with Markdown headings:
1. What the system does, in 3 or 4 sentences.
2. Architecture: the main parts and how a typical request or job moves through them, as a short text diagram followed by one line per part.
3. Where things live: a table with the columns Folder, What is in it, How often new engineers touch it.
4. Run it locally: numbered steps, only from the setup steps above, with the commands in code blocks.
5. How we work: branches, reviews, tests and deploys, from what I gave.
6. Your first week: up to 5 first tasks from my list, smallest first.
7. Who to ask: a table with the columns Area, Who, Where.
8. Glossary: up to 10 internal terms, one line each.

Keep it under 1,200 words, not counting code and tables. A good guide is one a new engineer still keeps open in their second week, because it is short and every command in it works.

Do not invent folders, commands, services, people or rules; describe only what the material shows. Do not include passwords, tokens or internal links that are not in the material. Leave out general advice such as "ask lots of questions".

If the purpose of a folder is not clear from the tree and the docs, list it in the table with [ASK: purpose] rather than guessing from its name. If the setup steps and the README disagree, follow the setup steps and note the difference at the end for the team to fix.

Variables

{{team}}
The team or product, for example "the payments team" or "the mobile app".
{{folder_tree}}
The output of a tree command two levels deep, or a hand-written list of top folders.
{{docs}}
The README and any architecture or design notes, pasted.
{{setup_steps}}
The steps that actually work today to run the system locally, with commands.
{{how_we_work}}
For example "short-lived branches off main, one approval, CI must pass, deploys every weekday at 2 pm".
{{contacts}}
Areas and who to ask, for example "billing: the billing channel; infrastructure: the on-call platform engineer".
{{first_tasks}}
Starter tickets or kinds of task, or "none".
{{terms}}
Internal words and what they mean, or "none".

Why it works

  • What to avoid. Folders, commands and people come only from your material, so the guide never sends a newcomer to a script or a person that does not exist.
  • If unsure. A folder with an unclear purpose is marked [ASK: purpose] instead of being described from its name.
  • Length. Fixed sections, a 1,200-word limit and up to 5 first tasks keep the guide short enough to stay open during the first weeks.

How to use it

  1. Press Fill in blanks and type your details into each blank. What you type stays in this browser.
  2. Copy the filled prompt into the AI tool you already use, such as ChatGPT, Claude or Gemini, or open it in the Grader or the Prompt Tester here.
  3. Before you rely on it, try it on three or four real examples. The Prompt Tester runs them all at once and shows which ones go wrong.
Use it from code

Get this prompt as JSON from the free REST API, with your own text in the blanks, or let an AI assistant fetch it through the MCP server. No key.

curl -s https://thinkhard.si/api/v1/prompts/codebase-onboarding-guide

With the MCP server added to Claude, ChatGPT, Cursor or VS Code, call get_prompt with {"prompt": "codebase-onboarding-guide"}, or just ask for it by name.