with one click
telemetrylog-work
Generates a U.Work record for an action (Pattern A.15.1).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
Generates a U.Work record for an action (Pattern A.15.1).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | telemetry/log-work |
| description | Generates a U.Work record for an action (Pattern A.15.1). |
| license | Apache-2.0 |
| metadata | {"fpf_id":"A.15.1","fpf_title":"U.Work: The Record of Occurrence","family":"telemetry"} |
| allowed-tools | ["write_to_file","run_command"] |
Implementation note (local tooling): When
POSTHOG_API_KEYandPOSTHOG_DISTINCT_IDare set, the reference implementation emits a PostHog event namedu_work_loggedwith spec/context metadata. SetPOSTHOG_INCLUDE_ACTION=1to include the action text and role. Implementation note (local tooling): Whenagent_session,agent_model, oragent_typeinputs are provided, the reference implementation adds anagent_metadatablock to the U.Work record.
After we have agreed who is assigned (via Role assignment), what they can do (via Capability), and how in principle it should be done (via Method/MethodDescription), we still need a precise concept for what actually happened in real time and space.
That concept is U.Work: the dated runâtime occurrence of enacting a MethodDescription by a specific performer under a Role assignment, with concrete parameter bindings, resource consumption, and outcomes, anchored to a domain referent that actually changes (asset/product/dataset) â not merely the manipulation of records about that referent. Managers care about Work because it is the only place where cost, time, defects, and evidence are real. Architects care because Work ties plans and specs to accountable execution.
| Force | Tension we resolve |
|---|---|
| Universality vs. domain detail | One Work notion for surgery, welding, ETL, proofs, lab cyclesâwhile letting each keep its vocabulary. |
| Granularity vs. aggregation | Atomic runs vs. composite operations; we need rollâup without doubleâcount. |
| Concurrency vs. order | Parallel/overlapped activities need clear part/overlap semantics. |
| Identity vs. retries | A failed attempt, a retry, and a resumed episodeâwhat is âthe sameâ work? |
| Time realism vs. simplicity | We need intervals and coverage but cannot bury users in temporal logic notation. |
U.Work as the accountable, dated occurrenceU.Work is a 4D occurrence holon: a dated runâtime enactment of a U.MethodDescription by a performer designated through a U.RoleAssignment, executed within a concrete U.System/SubSystem, inside a U.BoundedContext, that binds concrete parameters, consumes/produces resources, and leaves an auditable trace.
Each U.Work is a morphism Î on a declared stateâplane (StatePlaneRef), mapping âšpreâstate, inputsâ© to âšpostâstate, outputsâ© for one or more affected referents.
Memory aid: Work = âhow it went this timeâ (dated, resourced, accountable).
When you describe a Work instance in a review, answer these prompts:
isExecutionOf â U.MethodDescription (the description actually followed; edition pinned if applicable).performedBy â U.RoleAssignment (which holder#role:context acted).affected â {referent(s)} + preâstate anchor and postâstate anchor (or a declared Îâpredicate evaluated on evidence) on the declared stateâplane (StatePlaneRef).executedWithin â U.System (the operational system/subâsystem accountable for the occurrence; mandatory).| You are pointing at⊠| The right FPF concept | Litmus |
|---|---|---|
| The recipe/code/diagram | MethodDescription | Is it knowledge on a carrier? |
| The semantic âway of doingâ | Method | Same Standard across notations? |
| The assignment (âwho is being whatâ) | Role â RoleAssigning | Can be reassigned without changing the system? |
| The ability (âcan do within boundsâ) | Capability | Would remain even if not assigned? |
| The dated occurrence with logs, resources | Work | Did it happen at (tâ, tâ), consume resources, produce outcomes? |
| The state change caused this time | Work.Î | Did the referent move from preâpost on the declared stateâplane? |
U.Work) â normativePublication of U.Work across MVPK faces must be a typed projection that does not mutate intensional semantics (A.7; E.17). Concretely:
U.Work intensional arrow; they project presenceâpins only (time window, performer, spec, parameterâbinding occurrence, resource ledger presence, acceptance verdict presence). Numeric/comparable content appears only with pins (see 4.4â4.5 below); âsignatureâ is banned on faces.U.Work face presents any comparison or ranking across runs (e.g., acceptance classes, parity/benchmark inserts), the face must: (i) compare after mapping via a declared ComparatorSet; (ii) return sets (Pareto/Archive) when order is partial; (iii) forbid hidden scalarization/ordinal means (cf. G.9).U.Work face MUST pin the CGâSpec/ComparatorSet edition(s) and, where scale/plane conversion occurs, the UNM.TransportRegistry edition (Ί/Ί^plane policyâids). Crossâcontext/plane crossings route penalties to Râlane only (Bridge id + Ί) (cf. E.17; G.9).U.Work face (different DesignRunTag, ReferencePlane, or CtxState.locus) MUST carry BridgeCard + UTS row (with locus/plane notes and CL routing).U.Work instances that meet Îâanchoring in §4.2/§8.U.Work is a run-time occurrence (DesignRunTag = run). Any face that cites design-time artefacts (e.g., ComparatorSet, CG-Spec editions, TransportRegistryΊ) is making a cross-stance/cross-Context reference and therefore MUST publish a BridgeCard + UTS row and record Ί(CL)/Ί^plane policy-ids; penalties reduce R_eff only.We adopt a 4D extensional stance for occurrences: a Work is identified primarily by its spatiotemporal extent and its execution anchors (spec used, performer, parameterization). This avoids doubleâcounting and keeps aggregation sound. FPF adapts insights from BORO/constructive ontologies to Work while staying practical.
TemporalPartOf_work). A proper timeâslice of a Work (e.g., the first 10 minutes of a 2âhour run). Useful for monitoring and SLAs.EpisodeOf_work). A resumption fragment after an interruption (same run identity if policy deems it one episode; see 5.5).OperationalPartOf_work). A subârun that enacts a factor of the Method/Spec (e.g., âincisionâ run within âappendectomyâ run), possibly overlapping with others in time.ConcurrentPartOf_work). Two subâruns that overlap in their windows, coordinated by the same higherâlevel run.Didactic rule: Method composition â proof of Work decomposition. Subâruns often map to method factors, but retries, batching, pipelining, and failures make the mapping nonâisomorphic.
precedes/happensBefore â strict partial order on Work windows.overlaps â intervals intersect but neither contains the other.contains/within â one Workâs window contains anotherâs.causedBy/causes â pragmatic causal links (e.g., a rework caused by a failed inspection run).retryOf â a new Work instance reâattempting the same MethodDescription with revised parameters.resumptionOf â a Work episode that continues an interrupted run (policy decides identity; see 5.5).These relations are runâtime facts, not design assumptions.
Temporal coverage â Î_time(S)
For a set S of Work parts, returns a coverage interval set (union of intervals) or, when required, the convex hull [min tâ, max tâ]. Use union for utilization; use hull for lead time.
Properties: idempotent, commutative, monotone under set inclusion.
Resource aggregation â Î_work(S)
For a set S of Work parts, returns the aggregated resource ledger (materials, energy, time, money) with deâduplication rules for shared/overlapped parts (contextâdeclared).
Properties: additive on disjoint parts; requires overlap policy otherwise (e.g., attribute costs to the parent once, not to each child).
Managerâs tip: Pick the coverage operator that matches your KPI: union for machine utilization; hull for calendar elapsed; never mix silently.
Two Work records refer to the same Work iff, in the relevant context:
MethodDescription,U.RoleAssignment), andIf any of these differ (or the context declares equivalence absent), they are distinct Work instances (e.g., a retry).
retryOf.causedBy.Why it matters: plans, costs, and quality stats depend on whether you treat a disruption as one episode or a new run. Declare the policy in the bounded context.
For any Work with parts, the effect of the whole must be the rulesâdeclared composition of the effects of its parts plus any declared overheads/residuals. Composition must align with the overlap rules used by Î_work (e.g., no doubleâcount of shared fixed costs, and consistent attribution of variable deltas).
Appendectomy_Case#2025â08â10T09:05â11:42.Appendectomy_v5 (MethodDescription).OR_Team_A#SurgicalTeamRole:Hospital_2025 (RoleAssigning).Incision (09:15â09:22), Exploration (overlaps with monitoring), Closure (11:10â11:35).ETL_Nightly_2025â08â11T01:00â01:47.ETL_v12.bpmn.ETL_Runtime#TransformerRole:DataOps_2025.Extract_A â Extract_B; Transform starts when either completes (overlap).Load failed at 01:36; retried with batch size â â new Work linked via retryOf.Carnot_Cycle_Run#2025â08â09T13:00â13:06.Carnot_Cycle_Spec (MethodDescription with Dynamics model).LabRig_7#TransformerRole:ThermoLab.Prag, Arch, Did, Epist.U.BoundedContext.U.RoleAssignment / Role Enactment (A.2.1; A.15) and with 4D extensional thinking, so that costing, quality, and audit rest on runs, not on plans or recipes.CCâA15.1â1 (Strict distinction).
U.Work is a dated runâtime occurrence. It is not a U.Method (semantic way), not a U.MethodDescription (description), not a U.Role/RoleAssigning (assignment), and not a U.WorkPlan (plan/schedule).
CCâA15.1â2 (Required links).
Every U.Work MUST reference:
(a) isExecutionOf â U.MethodDescription (the spec followed; edition pinned),
(b) performedBy â U.RoleAssignment (the assigned performer in context), and
(c) executedWithin â U.System/SubSystem (the operational system accountable for the occurrence).
CCâA15.1â3 (Time window).
Every U.Work MUST carry a closed interval [t_start, t_end] (or an explicitly marked open end for inâflight work) and, where relevant, location/asset.
CCâA15.1â4 (Context anchoring & judgement).
A U.Work MUST be judged inside a declared U.BoundedContext (the judgement context).
performedBy references a RoleAssigning in a different context, there MUST exist an explicit Bridge (U.Alignment) or policy stating crossâcontext acceptance. Otherwise, the Work is nonâconformant in that context.CCâA15.1â4b (Stateâplane anchoring).
Each U.Work MUST declare a StatePlaneRef for its Îâjudgement.
CCâA15.1â5 (RoleAssigning validity).
The performedBy RoleAssigningâs timespan MUST cover the Work interval. If it does not, the Work is invalid or must be reâjudged in a context that allows retroactive assignments.
CCâA15.1â6 (Parameter binding). Parameters declared by the MethodDescription MUST have concrete values bound at Work creation/start and recorded with the Work. Defaults in the spec do not satisfy this requirement.
CCâA15.1â7 (Capability check).
All capability thresholds stated by the Method/MethodDescription MUST be checked against the holder in performedBy at the time of execution (or at defined checkpoints). Violations must be flagged on the Work outcome.
CCâA15.1â8 (Acceptance criteria). Success/failure and quality grades MUST be determined by the acceptance criteria declared (or referenced) by the MethodDescription/CGâSpec in the judgment context. The verdict is recorded on the Work.
CCâA15.1â9 (Resource honesty).
All consumptions and costs (energy, materials, machineâtime, money, tool wear) SHALL be booked only to U.Work (not to Method, MethodDescription, Role, or Capability). Estimates may live in specs; actuals live in Work.
CCâA15.1â10 (Mereology declared). If a Work has parts, the chosen part relation(s) must be declared (temporalâpart, episodeâpart, operationalâpart, concurrentâpart). Ambiguous mixtures are forbidden.
CCâA15.1â11 (Î_time selection). For any rollâup, the judgement context MUST declare which temporal coverage operator applies: union (utilization) or convex hull (lead time). Silent mixing is prohibited.
CCâA15.1â12 (Î_work aggregation). Aggregation of resource ledgers across Work parts MUST specify an overlap policy (e.g., âattribute shared machineâtime to parent onlyâ) to prevent doubleâcounting.
CCâA15.1â13 (Identity & retries).
A retry MUST be modeled as a new Work linked via retryOf. Interruptions that are treated as the same run must be modeled as episodes (resumptionOf) per a contextâdeclared episode policy.
CCâA15.1â14 (Concurrency & ordering).
Overlaps and precedences among Work MUST use interval relations (overlaps, precedes, contains/within). Implicit âstep orderâ claims are not admissible evidence.
CCâA15.1â15 (Crossâcontext evidence). If a Work is to be accepted in multiple contexts (e.g., regulatory + operational), either: (a) reâjudge it in each context, or (b) provide Bridges that map acceptance criteria/units/roles; never assume crossâcontext identity by name.
CCâA15.1â16 (Spec changes during run). If the MethodDescription version changes midârun, the Work MUST either: (a) split into episodes bound to respective specs, or (b) record an explicit spec override event in the judgement context. Silent substitution is forbidden.
CCâA15.1â17 (Distributed performers). If multiple RoleAssignings jointly perform the same topâlevel Work (e.g., multiâagent orchestration), the Work MUST either: (a) designate a lead RoleAssigning and list others as concurrent parts, or (b) be modeled as a parent Work with child Works per RoleAssigning.
CCâA15.1â18 (Logs â Work by themselves). Logs/telemetry are evidence for a Work; they do not constitute a Work unless bound to (spec, performer, time window) and judged in a context.
CCâA15.1â19 (Affected referent). Each U.Work MUST name at least one affected referent (e.g., U.Asset, product/batch, dataset/document) via affected â {âŠ}.
CCâA15.1â20 (Stateâchange witness). Each U.Work MUST carry either (a) explicit preâstate/postâstate anchors on the declared stateâplane or (b) a Îâpredicate that can be evaluated on evidence. Trivial ânoâopâ runs MUST be flagged as such.
CCâA15.1â21 (World anchoring vs. recordâhandling). A run whose only effect is copying/reformatting records does not qualify as U.Work unless the judgment context declares those records to be the product referent (e.g., dataâproduct manufacture).
CCâA15.1â22 (System anchoring). Each U.Work MUST declare executedWithin â U.System/SubSystem; if different from the asset of change, keep affected explicit.
CCâA15.1â23 (Compositionality of Î). For composite Work, the parent effect MUST be the declared composition of child effects under the same overlap policy as Î_work.
CCâA15.1â24 (No new claims on faces). MVPK faces for U.Work SHALL NOT add properties/claims beyond the intensional arrow; numeric/comparable content MUST include unit/scale/referenceâplane/EditionId pins; the term âsignatureâ is banned on faces.
CCâA15.1â25 (No Îâleakage). Faces MUST reference Î operators/policies by id when showing aggregates; they MUST NOT encode aggregation semantics in prose or imply defaults. Î lives in Part B; faces carry pinned references only.
CCâA15.1â26 (No I/O reâlisting). Faces MUST NOT restate intensional I/O; publish presenceâpins and anchors only (per MVPK §5.4).
CCâA15.1â27 (Lawful orders; return sets). Any acrossârun comparison presented on a U.Work face MUST use a declared ComparatorSet (mapâthenâcompare), return sets when order is partial, and forbid hidden scalarization/ordinal means.
CCâA15.1â28 (Comparator/Transport pins). Any numeric/comparable acceptance or KPI on a U.Work face MUST pin ComparatorSet.edition, CGâSpec.edition, and (where conversions occur) TransportRegistry.edition with Ί/Ί^plane policyâids; Bridge ids are mandatory for crossâcontext/plane reuse; penalties â R only.
CCâA15.1â29 (Telemetry hooks, when applicable). If a Work instance feeds G.11 or QD/OEE portfolios, it SHALL cite PathId/PathSliceId and the active policyâid in its evidence; illumination remains reportâonly telemetry unless CAL explicitly promotes it.
Î_timeInput: a finite set S of Work instances or Work parts.
Output: either (a) the union of their intervals, or (b) the convex hull [min t_start, max t_end]âas declared by context and KPI.
Invariants:
Î_time(S âȘ S) = Î_time(S)S â T then coverage(S) â coverage(T) (for union) or hull(S) â hull(T) (for hull)Usage guidance:
Î_workInput: a finite set S of Work instances or parts with resource ledgers.
Output: an aggregated ledger (materials, energy, machineâtime, money, tool wear) with explicit overlap policy.
Invariants:
Typical policies:
When a Work is recorded, perform these three quick checks:
SpecâContext Check. Does isExecutionOf refer to a MethodDescription defined in the judgement context (or bridged to it)?
RoleAssigningâContext Check. Is performedByâs RoleAssigning valid in the same context (or bridged)?
StandardâOutcome Check. Do the Workâs inputs/outputs and metrics satisfy the acceptance criteria from the spec as interpreted in that context?
Managerâs mnemonic: Context, assignment, Standard â CAC. Fail any â the Work is not acceptable here (perhaps acceptable elsewhere).
U.WorkPlan/operationsâsupport.Î_time policy per KPI.isExecutionOf and performedBy.U.WorkPlan; let Work record actuals.| Benefits | Tradeâoffs / mitigations |
|---|---|
| Auditable reality. Costs, time, and quality attach to concrete runs; rootâcause analysis and accountability improve. | More records. You create Work instances; mitigate with templates and automation. |
| Sound rollâups. Î_time/Î_work turn rollâups from handâwaving into declared policy; KPIs become comparable. | Policy discipline. You must choose union vs hull and an overlap policy; write it once. |
| Crossâcontext clarity. CAC checks prevent silent model drift; bridges make acceptance explicit. | Bridge upkeep. Keep mappings short and focused; review at releases. |
| 4D extensional coherence. Parts/overlaps/retries stop doubleâcounting and identity confusion. | Learning curve. Teach episode vs retry; include examples in onboarding. |
U.BoundedContext; U.System; A.2 U.Role; A.2.1 U.RoleAssignment; A.2.2 U.Capability; A.3.1 U.Method; A.3.2 U.MethodDescription.U.WorkPlan â U.Work deltas).Î_time = union (utilization) or hull (lead time); Î_work with a declared overlap policy.Issues a proxy audit verdict for a session.
Verifies Definition of Done checks and generates a DoD report.
FPF Pattern F.18: LocalâFirst Unification Naming Protocol
Initializes a bounded context skeleton under runtime/contexts/<context>.
Mints a new F.18 Name Card with strict Twin-Label and Sense-Seed validation.
Records a formal Design-Rationale Record (DRR) for architectural decisions.