toga-ai 1.0.987 → 1.0.988

package/knowledge/standalone/apps/claude/workflows/clickup-ticket-workflow.md

@@ -49,7 +49,9 @@ writes, and agents until the session has a ticket. These replaced `/kickoff`, `/
 4. **`/finish`** — always writes the team KB first. Then one approval list for ticket fields
    (Application, Stakeholders, Task Type, title, Has UI Changes). If the ticket is done: push each
    repo with work, open or update a PR per repo, post a PM comment, set status
-   `development finished`.
+   `development finished`. The PM comment is plain bullets for a non-technical PM: "What
+   changed" always; "Manual steps", "Still open", "Ticket fields changed by Claude" only when
+   they have content. No Apps/Clients/PRs sections. Template: `skills/finish/SKILL.md` Step 15.
 
 ### Ticket branch at /start
 
@@ -164,6 +166,8 @@ All tested 2026-10-08:
   `development finished` only. (jcardinal)
 - 2026-10-09 — TRUE-82605: `clickup_update_task` and `clickup_create_comment` no longer ask;
   the gate is the limit, field changes need the dev's yes in chat. (jcardinal)
+- 2026-10-09 — PM feedback: PM comment is plain bullets for a non-technical PM; Apps, Clients,
+  PRs removed; empty sections left out; field changes as plain sentences with the reason. (jcardinal)
 
 ## Related
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.987",
+  "version": "1.0.988",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",

package/skills/finish/SKILL.md

@@ -482,7 +482,7 @@ No session notes at all → under WHY write `not recorded — this work was not
 Never copy a key, token, or password into the body — write `a secret (redacted)` and list it
 under TEAM RULE CHECK.
 
-Keep every PR url for Steps 15 and 17.
+Keep every PR url for Step 17.
 
 **Secret scan** (PR body and PM comment, before posting):
 
@@ -496,19 +496,43 @@ could not be read — fix the path. Never post until it prints `{ok:true}`.
 
 ## Step 15 — PM comment (Claude writes and posts it — no approval)
 
-Draft a short comment for the PM and release notes. Plain words, no code dumps, no secrets,
-no local paths:
+Draft a short comment for a non-technical project manager (also used for release notes):
 
 ```
-**What changed:** <for users/clients, 1-3 plain lines>
-**Apps:** <Application values>
-**Clients:** <Stakeholders values>
-**PRs:** <one url per repo>
-**Manual steps:** <deploy / SQL file + database + order — or "None">
-**Still open:** <anything left — or "Nothing">
-**Ticket fields changed by Claude:** <from Step 10 — or "None">
+**What changed**
+
+- <plain, PM-friendly point>
+- <...>
+
+**Manual steps**
+
+- <plain point>
+
+**Still open**
+
+- <plain point>
+
+**Ticket fields changed by Claude**
+
+- <plain sentence with the reason>
 ```
 
+Rules:
+
+1. **Write for a PM, not a developer.** Say what users or clients will notice, or what the work
+   achieved. No file names, paths, commands, skill names, code terms, code dumps, or secrets.
+2. **Bullets in every section.** One point per bullet.
+3. **Only "What changed" is always there.** Leave out "Manual steps", "Still open", and
+   "Ticket fields changed by Claude" entirely when they have nothing — never write "None".
+4. **Manual steps in plain words** — e.g. "A database update must run before release", not a
+   SQL file name.
+5. **Ticket field changes (from Step 10) as plain sentences with the reason** — e.g. "The Has
+   UI Changes field was unchecked because this task had no UI changes." / "Added TOGa Desk to
+   Application because the work also changed the Desk app."
+6. **No Apps, Clients, or PRs sections.** Apps and clients are in the ticket fields; PRs link
+   to the ticket through the GitHub integration.
+7. **One blank line between sections**, and between a heading and its bullets.
+
 Do not ask the developer to approve it. Write the text to a temp file
 (`toga-comment-<TICKET>.md` in the OS temp dir), run the **Secret scan** on it, delete the
 file. Stop only on a hit. Then post it, and show the posted text in the Step 17 report: