Write repository README

Write repository README in GitHub — with the four heights of help laid out: do it now, make it easier for the next person to accept, work out the right move when you are stuck, and learn the pattern so it stops coming back.

4prompt heights
Open it in the interactive atlas →

The four heights

The same task, four distances: today's deadline, the next reviewer, the stuck moment, the pattern.

Execute — do the immediate task

+
Write a repository README that tells a newcomer how to get the service running locally in five…
Write a repository README that tells a newcomer how to get the service running locally in five minutes. Start with a one-line explanation of what this repo is for, list prerequisites with exact versions, give the three-step quick-start that runs the dev server and seeds demo data, and include the code owner and contribution guidelines links. Use Lina as the contact for questions.

Improve — make it easier to accept

+
Before we publish this README to the public project, make it easy for first-time contributors to…
Before we publish this README to the public project, make it easy for first-time contributors to start: move the troubleshooting tips into a dedicated "Troubleshooting" section, surface the contribution workflow up top with a checklist (Fork, branch, tests, PR), and highlight the expected commit message format and CI conditions that will block a merge.

Decide — diagnose the stuck moment

+
We've had three incoming PRs this month where CI failed immediately because the authors didn't run…

New contributors keep opening incomplete PRs because the README doesn't say how to run tests.

We've had three incoming PRs this month where CI failed immediately because the authors didn't run the test suite locally; they told me the README didn't explain how. I'm worried about discouraging contributors and about review fatigue on the maintainers. What should I add or change in the README right now that will most reduce these failures and save reviewers time?

Become — change the pattern

+
Every time we take on a new intern class the README demands five fixes: environment setup, sample…

We repeatedly rewrite README sections during onboarding spikes.

Every time we take on a new intern class the README demands five fixes: environment setup, sample data, test command, local linting, and who to ask. That pattern costs a day per onboarding wave and creates noisy PRs. What single habit around README maintenance or onboarding should I change so the repository stays newcomer-friendly without constant edits?

Next to this one

Other code hosting work people do in GitHub.

Every task here came from the work, not from a feature list — which is why the prompts name what you want done and never the button that does it. The tool changes; the work does not.
Copyright © LLOS.ai · 2026 — original pedagogy, voice, and design — all rights reserved.

The rest of the map

Same library, five ways in.