Card anatomy

A card in Ideafy is not just a title and a description. It's a container with enough context to be executable — plan, tests, AI opinion, git branch, dev server port, assignee. Every field exists because, at some point, an AI or a teammate needs it to act on the card without asking you.

Board-Card-Icons

Fields

Identity & content

FieldValuesWhere you edit it
titlestringCard surface (click), modal header
descriptionTiptap HTMLDetail tab
solutionSummaryTiptap HTMLSolution tab (or save_plan from AI)
testScenariosTiptap task listTests tab (or save_tests from AI)
aiOpinionTiptap HTMLOpinion tab (or save_opinion from AI)
aiVerdictpositive | negative | nullSet when AI fills in the opinion

Classification

FieldValuesShown on card as
statusideation / backlog / bugs / progress / test / completed / withdrawnWhich column the card lives in
prioritylow / medium / highThree-bar icon
complexitylow / medium / highComplexity badge
taskNumberintegerCombined with project prefix — e.g. KAN-14
projectIdproject UUIDProject color strip on the card

AI & processing

FieldValuesMeaning
aiPlatformclaude / gemini / codex / nullPer-card override of the global agent choice; null inherits the workspace default
processingTypeautonomous / quick-fix / evaluate / nullWhich background job is currently running on the card, if any

Git & dev server

FieldValuesMeaning
gitBranchNamekanban/PRJ-N-... / nullAuto-generated branch name
gitBranchStatusactive / merged / rolled_back / nullBranch lifecycle
gitWorktreePathpath / null.worktrees/kanban/PRJ-N-...
gitWorktreeStatusactive / removed / nullWorktree lifecycle
devServerPortint / null3031, 3032, … (the main app is 3030)
devServerPidint / nullPID of the running dev server
rebaseConflictbooleantrue if the last merge attempt hit conflicts
conflictFilespath[]Paths of the conflicting files

See Card git workflow for how these fields are driven.

Team & pool

FieldValuesMeaning
poolCardIdUUID / nullLink to the Supabase pool row, if this card is synced
poolOriginpushed / pulled / nullHow the link was created
assignedTouser UUID / nullTeam member currently responsible
assignedToNamestring / nullDisplay-name cache for the UI

Lifecycle

FieldValuesMeaning
createdAtISO timestampCreation time
updatedAtISO timestampLast edit
completedAtISO timestamp / nullWhen it entered Completed — drives the Completed filter

Card icons cheat sheet

The surface of each card packs a lot into very little space. From left to right you'll see:

  • Project strip — a colored tab on the left, matching the project's color
  • Task IDKAN-14 style identifier
  • Title — truncated on narrow columns, full in the modal
  • Priority bars — one, two, or three bars
  • Complexity badge — small "L / M / H"
  • Processing indicator — an animated ring when an AI job is running
  • AI verdict — Brain icon with a green check if positive, red cross if negative
  • Git branch chip — branch name if a worktree is attached
  • Dev server port — port number if a dev server is running
  • Assignee avatar — in the Team edition, the current owner

Editable from the UI

  • title, complexity, priority, status — inline from the card or the modal footer
  • description / solutionSummary / testScenarios / aiOpinion — from the four modal tabs
  • aiPlatform — per-card override selector
  • Everything git-, process-, and pool-related — driven by actions, not fields. You can't set gitBranchStatus directly; you take an action (start work, merge, rollback) and the system writes the field.

Prev: Board views Next: Quick entry flow Up: User guide index

Last updated: 2026-04-13