agent build

skills/attendance-analysis.md

@@ -0,0 +1,105 @@
+---
+id: attendance-analysis
+name: Attendance Analysis
+description: Analyse workforce attendance, lateness and absence, and compare people and departments.
+category: workforce
+pages:
+  - analytics
+  - control-center
+status: active
+version: 1
+triggers:
+  - attendance
+  - absence
+  - absences
+  - absenteeism
+  - late arrival
+  - missed shift
+  - missed shifts
+owliver:
+  enabled: true
+  suggestions:
+    - label: How is attendance?
+      capability: summary
+    - label: Compare attendance by person
+      capability: table
+    - label: Attendance over recent periods
+      capability: flow
+  capabilities:
+    - summary
+    - stats
+    - table
+    - progress
+    - flow
+    - insight
+  responses:
+    summary:
+      title: Attendance
+      source: workforce.attendance
+    stats:
+      title: Attendance
+      source: workforce.attendance
+    table:
+      title: Attendance by person
+      source: workforce.attendance
+    progress:
+      title: Attendance by person
+      source: workforce.attendance
+    flow:
+      title: Attendance over time
+      source: workforce.attendance
+      periods:
+        - last-7-days
+        - this-month
+        - previous-month
+    insight:
+      title: Attendance
+      source: workforce.attendance
+---
+
+# Attendance Analysis
+
+## Purpose
+
+- Report how reliably the workforce is turning up.
+- Separate turning up from turning up on time, because they have different causes.
+- Compare people and departments so a problem can be located rather than only counted.
+
+## Capabilities
+
+- Summarize attendance, punctuality and missed shifts.
+- Compare attendance per person, worst first.
+- Show attendance across recent periods.
+
+## Data
+
+Reads `workforce.attendance`, which counts `ShiftRecord` entries — every shift
+scheduled, whether it was worked, how late it started and how long it ran.
+Department is the position's `role_category`, the same field Hired History and
+Analytics group by.
+
+## Analysis
+
+Attendance is the share of scheduled shifts that were **turned up for at all**,
+late or not. Punctuality is reported separately, as the share turned up for on
+time. Folding the two together would make a reliably-late team look absent and
+a genuinely absent one look better than it is.
+
+Minutes lost to lateness are reported alongside the count, because four late
+arrivals says nothing about whether it cost ten minutes or two hours.
+
+## Output
+
+Headline attendance and punctuality rates, missed shifts split into absences and
+no-shows, and a row per person with their record. Over periods, one figure per
+window.
+
+## Limitations
+
+- Only shifts that were scheduled are counted. Unrostered work does not appear.
+- A no-show and an absence are counted separately but both reduce attendance;
+  the distinction is in the detail line, not in the headline rate.
+- The roster is whoever has shift records. This workspace has three, so a
+  department average is one person's record — the per-person view is the more
+  honest read at this size.
+- Excused absence is a recognised status but none is currently recorded.