diff --git a/agents/global/AGENTS.md b/agents/global/AGENTS.md index 46fc5cf..7d426b8 100644 --- a/agents/global/AGENTS.md +++ b/agents/global/AGENTS.md @@ -66,6 +66,13 @@ question (see Questions). Effective 2026-08-31. - 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. +## 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 - 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 ⏳.