TSYSGroupCorporate/TSYSGroupAIOS
Template
7
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Commit-message house style: short bodies, meat in Redmine notes

Browse Source 
Commits stay a few wrapped lines and link their Redmine comment
(clickable URL) instead of carrying the detail; all human-facing
markdown wrapped and clickable. Worked example:
https://projects.knownelement.com/issues/610#note-3334

💘 Generated with Crush

Assisted-by: Crush:glm-5.2

[#610]
This commit is contained in:
mrcharles
2026-09-01 07:35:16 -05:00
parent 86d8565d87
commit 6d11690932
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agents/global/AGENTS.md
+7
View File
@@ -66,6 +66,13 @@ question (see Questions). Effective 2026-08-31.
- Per work item: ticket ↔ Discourse doc ↔ PR/commit ([#NNN] in subject or body). - Per work item: ticket ↔ Discourse doc ↔ PR/commit ([#NNN] in subject or body).
- Links are created AT BIRTH of any artifact and updated in the same turn the work lands. Anyone landing on ANY of the three must reach the other two in one click. An artifact without its links is not done. - Links are created AT BIRTH of any artifact and updated in the same turn the work lands. Anyone landing on ANY of the three must reach the other two in one click. An artifact without its links is not done.
## Commit messages (ruling 2026-09-01)
- SHORT: subject <=72 chars; body a FEW lines max, wrapped at 72. NEVER cram a paragraph into one long line.
- The MEAT (detail: what/why/how/verification) goes in a Redmine ticket COMMENT on the work item, in the same turn the work lands — not in the commit body.
- The commit body carries a CLICKABLE full URL to that comment: https://projects.knownelement.com/issues/NNN#note-M
- All markdown written for humans (Redmine comments, Discourse posts, commit bodies) uses real clickable links and human formatting (headings, bullets, short wrapped lines) — no walls of text, no unclickable references.
## Working style ## Working style
- ROLLING TABLE HUD (every client — crush, openwebui): ONE markdown table, updated IN PLACE at each significant checkpoint (step done, blocker, pivot). Never append a second table. Max 10 rows. States: done ✅ / doing 🔄 / blocked ⛔ / next ⏳. - ROLLING TABLE HUD (every client — crush, openwebui): ONE markdown table, updated IN PLACE at each significant checkpoint (step done, blocker, pivot). Never append a second table. Max 10 rows. States: done ✅ / doing 🔄 / blocked ⛔ / next ⏳.