Imported from aaronlord/.dotfiles (
AGENTS.md). Install upstream withnpx skills add aaronlord/.dotfiles. Copyright stays with the author.
Investigating test failures
When running test suites to investigate failures, run the command bare (no shell redirection), capture output from the bash result, then write it to a temp file (e.g. /tmp/test-results.txt) using the write tool. Then read or grep that file. Never run the suite multiple times with different grep patterns against live output.
Bash command habits
Do not prepend cd <project-dir> && to bash commands — the shell is already in the correct working directory.
Run one command per bash tool call. Do not chain commands with &&. Wait for the result before running the next command.
Directory traversal
Use tree or find to explore directory structures instead of chaining multiple ls commands.
Code comments
Keep comments terse — caveman-style, few words, no restating the obvious. One line for guard/edge-case comments, not multi-sentence prose. State only the non-obvious why.