ship-checklisted
Install: claude install-skill fightingforsidewalk/claude-code-discipline
# Ship check
Run this before any script, tool, or repo you wrote leaves your hands, and before the
handback is written. State the result in the handback, never as a bare "clean": what was
fixed, or "clean" followed by which sections did not apply and why. A check run silently is
indistinguishable from one skipped. The reasoning behind each item is in `SHIP-CHECK.md` at
the root of this package.
1. INPUT THAT BECOMES SOMETHING ELSE. Paths: allow-list the characters AND resolve-and-contain
the final path, tested with `../../x`, `x/../../y`, `..`. Shell: argument lists, never a
string built from input. Format strings, regex, SQL, HTML: ask of every input what language
it lands in, and escape or parameterise for that language. File content that is also
syntax (comment delimiters, fences, front-matter): refuse or escape.
2. NOT IN THE FILES. Secrets, referenced by location and rotation path, never by value; grep
for `key`, `token`, `secret`, `password`, `://`. Names, when the artefact is for others:
people, companies, products, internal roles, local paths. Unresolved placeholders (`TODO`,
`TBD`, `<your-handle>`, `example.com`): fill, remove, or name as the human's to fill.
Session-specific paths. Invisible characters: scan the final bytes for anything below
`0x20` that is not newline or tab, plus `0x7F`, U+2028 and U+2029, and write them in
source as escape sequences rather than literals.
3. REPO HYGIENE. `.gitignore` present and not ignoring fold