🧹 Clara Workflows

Secretary and project manager. Processes inbox, classifies tasks, manages priorities, maintains clarity.

What Clara Does

Clara is the dispatching layer of the Agentic Hub. She reads brain dumps, feedback, and inbox items, then classifies and routes them to the correct workspace and task. She operates in 5 distinct modes, each triggered by a slash command.

Clara is not a separate agent. She is a mode of the same Claude Code agent, activated by the /clara command. Her identity file at .agent/rules/identity/clara.md defines her tone and operating constraints.

Modes

Sweep (Default)

/clara or /clara sweep

The primary mode. Pulls open feedback items from D1, classifies each one, and routes them.

What it does:

GET /api/feedback?status=open → Classify each item → Create/update tasks → PATCH feedback as processed → Commit + deploy

Classification categories:

CategoryAction
taskCreates a new task in D1 (or updates an existing one)
feedbackLinks feedback to an existing task
needs-shapingToo vague — Clara notes what's missing, marks as processed
questionRoutes to the right person/context for answering
doneMarks related task as done

Tidy

/clara tidy

Scans for stale or done tasks and syncs the ongoing tracker.

What it does:

  • Query D1 for tasks with status done that haven't been archived
  • Check ongoing.md for entries that no longer match D1 state
  • Update ongoing.md to reflect current reality
  • Flag stale tasks (active but no recent velocity) for review

Archive

/clara archive

Moves completed tasks from active to archive. Updates D1 and local files.

What it does:

Find done tasks → Move folder to archive/ → PATCH status=archived in D1 → Update ongoing.md → Log the archive
Soft-delete only: Clara never physically deletes D1 records. She PATCHes status to archived. The task folder moves to tasks/archive/ but the D1 record persists.

Focus

/clara focus

Picks the highest-priority ready task and presents a focused brief.

What it does:

  • Query D1 for tasks with status ready or backlog
  • Rank by priority and recency
  • Load task context (README, feedback, comments)
  • Present a brief: what to do, why it matters, suggested first step

Align

/clara align

Weekly priority review. Cross-checks ongoing work against strategic priorities.

What it does:

  • Read clara/priorities.md and clara/ongoing.md
  • Cross-reference with D1 task states
  • Flag misalignments (active tasks not in priorities, priority items with no progress)
  • Ask Adrian about timeline and stress (wellness awareness)
  • Update priorities.md with revised rankings

Running Clara Remotely

Clara can run without VS Code via Bifrost:

Portal Inbox → Clara mode → POST to Bifrost → Bifrost spawns Claude CLI → Clara executes, commits

This is useful for running sweeps on a schedule or from mobile. The Clara job type in Bifrost passes the mode (sweep/tidy/focus/align) as part of the prompt.

Key Files

FilePurpose
.agent/workflows/clara.mdClara workflow prompt template
.agent/rules/identity/clara.mdClara's identity, tone, constraints
clara/ongoing.mdActive tasks across all workspaces
clara/priorities.mdStrategic priority rankings
clara/velocity.mdVelocity ledger (date, task, minutes)
clara/inbox/Local inbox folder (legacy, mostly replaced by D1 feedback)
Portal Documentation v3 · April 2026 · Home · Portal