commit.md

 1Please do the following.
 2
 3- Always follow Conventional Commits.
 4- Only stage files you've directly changed during this conversation.
 5- Trailer references
 6  - Issue/bug trailer options
 7    - Fixes:
 8    - Implements:
 9    - References:
10    - Closes:
11  - Include yourself in the `Co-authored-by` trailer.
12  - _Always_ look for a number in the branch name, like `3-new-feature` or `user/fix-thing_36`. Only if there is,
13    - Run `git remote -v` and notice whether any of the remotes include 'soprani.ca', 'sopranica', 'singpolyma', or 'sgx-XXX' where XXX is an arbitrary string (for example, sgx-jmp, sgx-bwmsgsv2, sgx-endstream, etc.). If any of those keywords are found, run `hut todo -t '~singpolyma/soprani.ca' ticket show NUMBER-FROM-BRANCH-NAME` to see the ticket we're working on and surrounding discussion.
14    - Depending on commit contents and bug contents, ask me which trailer to use. Format the trailer value like `https://todo.sr.ht/~singpolyma/soprani.ca/TICKET_NUM`. If there is no number in the branch name or the remotes don't contain any of the keywords, _do not_ include a trailer.
15  - _Always_ look for a short hash in the branch name, like `40cd4d1-sort-branches-by-updatedat` or `user/9ebc998_pin-default-branch` or `horizontal-navbar-on-mobile/6016e27` and so on. Only if there is,
16    - Run `git-bug bug show HASH` to see the bug we're working on and surrounding discussion.
17    - Depending on commit contents and bug contents, ask me which trailer to use. Format the trailer value like `bug-HASH`. If there is no hash in the branch name, _do not_ include a trailer.
18    - _After_ creating the commit, ask whether to close the bug. If I say yes, close it with `git-bug bug status close HASH`.
19- Check whether there are already staged changes.
20  - If no, look at the `git status`, then look at our conversation above.
21    - If you do _not_ notice View/Edit-related activity for the files/dirs referenced in the `git status` output, STOP and ask me which changes you should stage, analyse, then commit. Present the changes as per-file bullets with summaries.
22    - If you _do_ notice View/Edit activity for the changed files, `git add` them, then STOP and ask me whether to stage any of the other files. Present the changes as per-file bullets with summaries.
23  - If yes, analyse the changes and craft your commit message.