Skip to content

Goals

Goals are quarterly objectives that support STAR narratives and quarterly reviews. They connect day-to-day work to measurable outcomes for performance reviews.

Entity Fields

FieldTypeDescription
idGoalIdBranded numeric ID
raw_inputstringOriginal input text
titlestring | nullEnriched title (5-10 words)
statusGoalStatusCurrent status
quarterQuarter | nullQ1, Q2, Q3, Q4
yearnumber | nullCalendar year
kpisstringJSON array of KPI strings
enrichment_statusEnrichmentStatusraw or enriched
created_atstringISO timestamp
updated_atstringISO timestamp

Status Transitions

draft --> active --> completed
                \--> abandoned
FromTo
draftactive
activecompleted, abandoned

completed and abandoned are terminal statuses.

STAR Narratives

Goals support Situation-Task-Action-Result narratives for building performance review evidence over time.

FieldTypeDescription
idnumberNarrative ID
goal_idnumberLinked goal
situationstringContext and background
taskstringWhat needed to be accomplished
actionstringSteps taken
resultstringOutcome and impact

Quarterly Reviews

Aggregate goal data into a quarterly summary for review conversations.

FieldTypeDescription
quarterQuarterQ1, Q2, Q3, Q4
yearnumberCalendar year
what_went_wellstringHighlights and wins
improvementsstringAreas for growth
kpi_summarystringSummary of KPI progress
generated_narrativestringAI-generated review narrative

Interactive TUI

rmbr goal list opens an interactive terminal UI:

  • Arrow keys to navigate, q to quit
  • Status filter: 1 all, 2 draft, 3 active, 4 completed, 5 abandoned
  • Quarter cycle: r to cycle through Q1-Q4
  • Actions: Enter activate (draft), d complete (active), a abandon (active)
  • Color-coded statuses: draft (gray), active (green), completed (cyan), abandoned (red)
  • Use --ai for plain text output (for AI agents or scripts)

CLI Commands

For full syntax details, see the CLI Reference.

CommandDescription
rmbr goal addCreate a new goal from raw input
rmbr goal listInteractive TUI (default) or plain text (--ai, -s, -q)
rmbr goal showShow a single goal by ID
rmbr goal activateTransition a goal to active
rmbr goal completeMark a goal as completed
rmbr goal abandonAbandon a goal
rmbr goal deleteSoft-delete a goal (hidden from lists by default)
rmbr goal restoreRestore a soft-deleted goal
rmbr goal relatedShow all entities linked to a goal (todos, kudos, study, slack)
rmbr goal enrichEnrich a goal with title, quarter, KPIs
rmbr goal starAdd a STAR narrative to a goal
rmbr goal reviewGenerate or view a quarterly review

MCP Tools

ToolDescription
rmbr_goal_createCreate a new goal; accepts optional enrichment fields
rmbr_goal_listList goals with optional status and quarter filters
rmbr_goal_getGet a single goal by ID
rmbr_goal_transitionTransition a goal to a new status
rmbr_goal_deleteSoft-delete a goal
rmbr_goal_restoreRestore a soft-deleted goal
rmbr_goal_relatedGet all entities linked to a goal (todos, kudos, study, slack)
rmbr_goal_enrichEnrich a raw goal with title, quarter, year, KPIs
rmbr_goal_add_star_narrativeAdd a STAR narrative entry linked to a goal
rmbr_goal_get_star_narrativesRetrieve all STAR narratives for a goal
rmbr_goal_quarterly_review_dataGather goal data for a given quarter and year
rmbr_goal_save_quarterly_reviewSave a quarterly review with summary and narrative

Released under the MIT License.