๐Ÿ“ˆ Tracking Workflows

Logging, status checks, wrap-ups, and velocity. Keeping the system and the human oriented.

Overview

Tracking workflows handle the observability layer: what was done, how long it took, and what's the current state. They're the glue between work sessions and the portal's historical views.

Commands

/log

Create Session Log

Writes a log entry for the current session. Uses the dual-write pattern: local markdown file + D1 API POST.

What it does:

Summarize session work โ†’ Write to logs/YYYY-MM-DD.md โ†’ POST to /api/logs โ†’ Visible in portal Logs page
Required fields: The POST /api/logs body must include date (YYYY-MM-DD), workspace, and content. Missing date returns 400 silently.

/status

Quick Daily Status

Read-only check of current state. Shows active tasks, recent logs, velocity, and any open feedback. Useful for morning orientation or mid-day check-ins.

What it reads:

  • clara/ongoing.md โ€” what's active across all workspaces
  • D1 tasks with status active
  • Recent velocity entries
  • Open feedback items
  • Today's log (if any)

/ongoing

Sync Ongoing Files

Synchronizes ongoing.md files across all four workspaces. Each workspace has its own ongoing tracker that lists active tasks for that workspace.

FileScope
e:\Agentic\clara\ongoing.mdMaster โ€” all workspaces combined
e:\Dev\mipos-dev-context\ongoing.mdDev workspace tasks
e:\Work\ops\ongoing.mdWork workspace tasks
e:\Life\adrian-life-context\ongoing.mdLife workspace tasks

/wrapup

End of Session / Day

The comprehensive session-close workflow. Commits outstanding changes, writes log and velocity, updates ongoing, and optionally posts to #dev channel.

What it does (in order):

Git commit โ†’ Write log โ†’ Record velocity โ†’ Update ongoing โ†’ Post session-end

/commit

Git Commit

Creates a git commit using the conventional commits format. Analyzes staged changes and generates an appropriate commit message.

Format: type(scope): description

TypeWhen
featNew feature or capability
fixBug fix
refactorCode restructuring (no behavior change)
docsDocumentation only
choreMaintenance, config, dependencies
logSession log entry
ASCII only: Commit messages must be ASCII-only. No emojis or unicode characters in the message body (shell encoding issues on Windows).

/align

Personal Strategic Alignment

Life-level alignment check. Reviews personal goals, values, and priorities. Different from Clara's /clara align which focuses on task prioritization.

/logarchive

Archive Old Logs

Moves log files older than a threshold into yearly archive folders (e.g., logs/2026/). Keeps the main logs/ directory manageable.

Velocity Tracking

Velocity is measured in minutes, never hours. Each session records:

FieldExample
Date2026-03-16
Workspaceagentic
Task IDA94
Minutes45
NotesDocs expansion โ€” features + workflows

Velocity is dual-written to clara/velocity.md (local) and POST /api/velocity (D1). The portal Logs page aggregates velocity data for trend visualization.