swe-hiring/README.md

Omukk — Software Engineer Work Sample

Welcome! This is a small, time-boxed work sample made of four independent parts. It is not a puzzle hunt and there are no algorithm brainteasers — each part looks like a slice of ordinary engineering work.

Ground rules

• Time budget: about 1-1.5 hour total. It is fine to leave things imperfect. If you run out of time, write down what you would do next in NOTES.md — that counts as part of your submission.
• Use your normal tools. AI assistants (Claude, Copilot, ChatGPT, etc.) are explicitly allowed, the same way they would be on the job.
• Work in this repository. git init and commit as you go — small commits with honest messages. The commit history is part of your submission.
• Don't modify the test suites. Fix code, not tests.
• NOTES.md is yours. Decisions, observations, anything you would raise with a teammate at work — write it there. We read it carefully.
• If anything in this repository seems wrong, surprising, or contradictory, treat it the way you would at work: make a call and document it.

The parts

Do them in order. Each part has its own README with the actual task.

Part	Directory	Language	What it is
1	part1-pricing/	Python	Implement a billing rule against an existing test suite
2	part2-logstats/	Python	Debug a small CLI tool until its tests pass
3	part3-taskcli/	Go	Fix three failing tests in a language you may not know
4	part4-debrief/	—	A short written debrief (no code)

Several test suites fail out of the box — that is the starting state, not a packaging mistake.

Running things

Python parts (from inside the part's directory):

pip install -e ".[dev]"     # or: uv run --extra dev python -m pytest
python -m pytest

Go part (from inside part3-taskcli/):

go test ./...

Submitting

1. Zip this whole folder, including the .git directory.
2. Upload the zip to a Google Drive folder and make the folder publicly viewable ("Anyone with the link can view").
3. Submit the folder link through the form linked in your email.

Before you zip, make sure NOTES.md, part3-taskcli/WRITEUP.md, and part4-debrief/DEBRIEF.md reflect your final state of mind, not your first.

Good luck — and remember, we are more interested in how you decide than in how much you type.