4weird.com/docs/remastery/time-tracking · Wave 1

Time tracking, in plain English

Clock org work to the second at /timer. Tracked seconds can invoice into debts — but Ghost (👻) is a hypothetical ruler for debts with no monetary value: it measures, stores nothing, buys nothing.

What exists today at /timer

• Second-precision work clock with activity-beat presence proof.
• Ghost records: hypothetical, centrally-controlled, no legal value — a ruler for who-owes-whom, not money.
• Work-diary CSV export for bookkeeping; shift notes attach proof in the Vault; contracts live under /business/contracts and clients in the CRM.
• Business cross-links: tracked time flows toward real invoices from the Business Hub.

Planned: pro clock (/timer/pro)

The remastery blueprint upgrades the clock into a drift-proof pro tracker. Status: planned — none of these exist yet:

• Background-tick engine: ticks keep running accurately even when the tab is minimized.
• Projects with rates & budgets: hourly rate plus budget-hours per project so teams see burn.
• Kanban-linked entries: attach a time entry to a sprint card to compare logged vs estimated hours.
• 1-click invoice conversion: aggregate unbilled entries into a pre-filled draft invoice.

Data shapes (planned schema)

Entries are yours only (planned per-user RLS). Marking time billable never moves coins by itself — settlement happens only in guarded checkout flows.

Worked example: clock in to invoice

1. Start the clock with context. A contributor opens /timer, picks the GraveGain project, links the raid lobby card, and writes a one-line description such as "presence callbacks".
2. Work, then stop. After 2.5 focused hours the entry records start time, end time, and 9,000 duration seconds, marked billable and not yet invoiced.
3. Convert on Friday. The lead aggregates the week's unbilled entries into a pre-filled draft invoice: client, line items, totals in coins with the USD equivalent beside them. Full lifecycle in the invoicing and trash guide.
4. Settle in checkout. Coins move only inside the guarded checkout flow; the entries then flip to invoiced. Tracked seconds plan the bill, checkout pays it.

Reading the burn

Each project pairs an hourly rate with a budget in hours. Compare logged against budgeted every Friday:

Attach entries to a sprint card to compare logged versus estimated hours side by side; see the kanban sprints guide.

Troubleshooting

• Seconds went missing? The current clock can drift when the tab sits backgrounded. Keep /timer in a visible tab for long sessions, or split work into shorter entries until the drift-proof engine lands.
• Entry missing from the draft? Check the two flags: non-billable entries never convert, and already invoiced entries never convert twice. Fix the flags before aggregating.
• Wrong project on an entry? Correct the project before conversion. Invoices snapshot whatever the entries say at draft time.
• Seconds versus coins confusion? Tracked seconds measure effort; coins settle value. The two meet only inside checkout, at 100 Vibe Coins to exactly $1.00.

FAQ

• Can Ghost pay an invoice? No — Ghost records never settle an invoice; invoices are memoranda, not tax invoices.
• Coins vs USD? 100 Vibe Coins = exactly $1.00 wherever totals appear.
• Does minimizing the tab lose seconds today? The current /timer clock can drift when backgrounded — the drift-proof engine is the planned fix.
• Who sees my entries? You do, plus leads reviewing shared squad project rollups. Per-user RLS keeps anyone else out.
• Can I track non-billable work? Yes. Mark the entry non-billable: it counts toward burn and never toward invoices.
• What links time to sprints? The optional card id on each entry, compared against the card's estimate on the board.

Next: Invoicing & trash · Kanban sprints · Open /timer · All docs