Back to Tags

#documentation

Commit Message and PR Description — What Changed and Why

Turn a diff into a clear commit message and pull request description: what changed, why, how it was tested, the risks and what reviewers should look at first.

Nigel Yoshida

Project Rules File — A CLAUDE.md or AGENTS.md for Your Repo

Write a rules file that gives AI coding agents the context they keep missing: stack, commands, structure, conventions and the things they must never do, kept short enough to actually be read.

Nigel Yoshida

Architecture Decision Record — Write Down the Why

Write an architecture decision record (ADR) from your notes: the context, the options you weighed, the decision and its consequences, so the next developer knows why and doesn't reopen it.

Nigel Yoshida

README Writer — Setup That Works on the First Try

Write a README a new developer can follow on the first try: what the project does, prerequisites, setup and run commands, configuration, common problems and how to contribute.

Nigel Yoshida