This repository is a small collection of developer puzzles built around binary artifacts and narrative clues.
Each puzzle gives you a story and one or more files to inspect. Your job is to interpret the artifacts, write your own solver in any language you like, and unscramble the binary data back into its original form.
The puzzles are intentionally open-ended:
- You can use any programming language or tooling.
- You can solve each puzzle however you want.
- You should submit your work as code, not as a written reveal of the answer.
- Puzzle 1 unscrambles to readable English text.
- Puzzle 2 unscrambles to playable media.
The repository does not document the solving method. The challenge is in finding that for yourself from the provided materials.
.
├── puzzles/
│ ├── 01-sorting-of-souls/
│ └── 02-war-commander/
Each puzzle folder contains the public challenge artifacts plus an answers/ directory for submissions.
- Pick a puzzle.
- Read the story and inspect the provided files.
- Build your own solver.
- Place your solution inside that puzzle's
answers/directory. - Open a pull request.
See CONTRIBUTING.md for the submission format.
Warning: When reading text files, be careful to get rid of carriage returns (
\r).