| name | daily-report |
| description | Manage today's daily manager report file. Use when the user asks to generate, update, or finalize their standup or manager update, or when a meaningful unit of work should be logged into today's report. |
"I'm using the daily-report skill to update today's manager report."
<file_location>
One file per day at manager-reports/<YYYY-MM-DD>-manager-report.md, relative to the PM workspace root. The root is resolved at call time by walking up from cwd for a .pm/HEARTBEAT.md marker; the helper errors out when no marker is found. Multiple sessions may write the same file concurrently.
</file_location>
<helper_script>
All reads and writes go through scripts/daily-report.py; run --help for subcommands. Pass --date YYYY-MM-DD to target a non-today date. Never Edit/Write the file directly: direct writes bypass the fcntl.flock and silently drop concurrent entries from parallel sessions.
</helper_script>
<file_format>
Three sections, in order: Blockers: <value-or-None>, Today:, Next:. Bullets are four-space indented then - . No headers, separators, or commentary lines; the file is sent to the manager as-is.
</file_format>
<entry_writing_rules>
Prefix every bullet with the ticket id (CAFE-529:); it anchors the entry for the manager. Write in plain manager-readable English: no file paths, function names, hook names, class names, internal modules, or stack-trace jargon. One bullet captures one outcome; merge investigation, implementation, and verification of the same fix into one bullet. Never reference an MR or PR by number alone; use the <short description> MR (!<number>) so the manager understands without opening GitLab. When summarising an MR, read its description via glab mr-view <id> and lift the user-facing impact, not the implementation detail. Outcomes over activities. No em dashes and no hyphen-dash used as a sentence dash; use a comma, a colon, or rewrite. Keep each bullet to roughly one screen line. The Next section lists concrete handoffs (ask the team to review, monitor X reaching QA, kick off Y), not aspirations.
</entry_writing_rules>
<tone_anchor>
The user's accepted canonical tone reference:
Blockers: None
Today:
- CAFE-529: fixed the underlying bug breaking active users every 15 minutes, added activity-aware silent refresh so the modal only opens for truly idle users (stay signed in / sign out with 30s countdown)
- CAFE-529: rebased the session-timeout MR (!100) onto develop, full end-to-end tested all the flows
- CAFE-522: merged the post-deploy follow-ups MR (!101), duplicate-code field error in the restaurant modal, lambda timing out on Secrets Manager, Quebec city rename so the 21 Québec restaurants stop being skipped on each sync
Next:
- CAFE-529: ask the team to review the session-timeout MR (!100)
- CAFE-522: monitor the post-deploy follow-ups MR (!101) reaching QA and ask Vlad for the log dump
- CAFE-534: kick off the DPS 2.0 equivalent
Match this register: declarative, outcome-led, light on adjectives, no engineering nouns the manager would not recognize.
</tone_anchor>
<workflow_log_during_the_day>
When a meaningful unit of work finishes in any session: 1) show the file to avoid duplicates; 2) if an existing bullet on the same ticket can absorb the new fact, remove-today + add-today a merged bullet instead of creating a second bullet for the same ticket; 3) pull MR or ticket context before writing the bullet; 4) append via add-today/add-next; use set-blockers only for a real blocker the user named.
</workflow_log_during_the_day>
<workflow_generate_full_report>
When the user asks for the day's report: 1) show the current file as the working draft; 2) gather activity from every source, treating authored commits as only one slice of the work: git log --since=midnight --author=<user> and working-tree status across mandate repos, glab user-events including MRs the user reviewed, approved, or commented on and not only the ones he authored, jira ticket transitions, the in-progress work commits never show (manual testing, local verification, debugging a teammate's problem), and any chat or message the user pastes; 3) decide Today vs Next and the owning date for each item from its own source timestamp, appending via the helper and passing --date for an item that happened on an earlier day; 4) re-show and present the file verbatim. The file stays on disk as the day's archive.
</workflow_generate_full_report>
<decide_do_not_gate>
Resolve every answer the sources hold and proceed; do not hand the user confirmations he did not ask for. Never ask whether work he already reported belongs in the report, which day an item lands on (its source timestamp decides that), or whether an investigation earns a line. Pasted private messages, DMs, and chat logs are a valid optional input the user shares by choice: read them for activity and never refuse, hedge, or gate on work-exposure or confidentiality grounds.
</decide_do_not_gate>
<concurrency_trap>
fcntl.flock serializes writers but does not merge intent: two sessions appending "CAFE-529: fixed X" produce two near-duplicate bullets. Always show before add-*, and prefer remove-* + add-* to consolidate when a parallel session left a duplicate.
</concurrency_trap>
