Glossary

Terms used throughout the Ideafy docs and interface. Alphabetical.

Autonomous

A processingType value. When autonomous is running on a card, the agent detects the phase (plan / implement / test) and drives the card through the workflow without interactive prompts.

Card

The primary unit in Ideafy. A container with title, description, plan (Solution), tests, AI opinion, git metadata, conversation history, and more. Lives in one of the seven kanban columns.

Claim

A pool operation. Assigning yourself (or, as admin, someone else) to a pool card without pulling it into your local board. Signals intent without taking ownership of the work.

Completed

The sixth kanban column. Cards with a set completedAt live here. The column has a date filter (Today / Yesterday / This Week / All).

Conversations

Per-section chat threads in the card modal. Stored in the local SQLite conversations table, scoped by (cardId, sectionType). Never synced to the cloud. Backed by a CLI session ID (see Interactive CLI sessions) that resumes via claude --resume <id> on every follow-up message, so threads stay alive across days.

Chat triggers

Three characters that open autocomplete menus in the card chat input: @ for documents, `Card chat & mentions.

Display ID

The {prefix}-{taskNumber} identifier shown on card surfaces (e.g., KAN-14). The prefix comes from the project; the task number is assigned incrementally per project.

Evaluate

A processingType value. Runs only on Ideation cards. Loads the Product Narrative as context, produces an AI opinion with a verdict (positive / negative). Uses save_opinion.

Fire-and-forget sync

The mechanism Ideafy uses to keep pool cards in sync. Every local card mutation fires a POST /api/internal/sync-card call. Failures are silent; the next mutation retries.

Grace period

5-day window after trial expiry, payment failure, or cancellation. Pool writes are blocked but reads still work. After grace, the subscription is expired.

Hook

A .claude/settings.json shell command that runs at a specific agent lifecycle point. Ideafy installs a UserPromptSubmit hook that injects the current card ID into every prompt when $IDEAFY_CARD_ID is set.

Human Test

The fifth kanban column. A card lives here when implementation is done and a human needs to verify acceptance criteria — typically by ticking off the Tests tab checkboxes. Designed so a non-developer (product owner, business analyst, founder) can drive a card from here to Completed using the Tests-tab chat panel, including committing and pushing fixes via --dangerously-skip-permissions.

Ideation

The first kanban column. Raw ideas and rough notes go here before being scoped into the Backlog.

Invite code

A 6-character alphanumeric string used to join a team. Generated once at team creation, doesn't rotate, doesn't expire.

MCP (Model Context Protocol)

Anthropic's protocol for exposing tools to AI agents. Ideafy ships its own MCP server that exposes 14 tools for card management.

My Queue

A UI view showing pool cards assigned to you that you haven't pulled locally yet. Your personal inbox inside the pool.

Narrative (Product Narrative)

A markdown document at docs/product-narrative.md (or configured path) that describes the project's vision, problem, target users, features, non-goals, tech stack, and success metrics. Loaded as context for every evaluate run.

Pool

The shared Supabase table where team members push cards and pull them back. Exists only in the Team edition.

Pool origin

A card field: pushed / pulled / null. Tells you whether a card was pushed to the pool (pushed) or created by pulling a pool card (pulled).

Processing type

A card state: autonomous / quick-fix / evaluate / null. Non-null values indicate a background agent job is running on the card. While set, the card is locked in the UI.

Pull (pool)

A pool operation. Atomically claims a pool card and creates a new local card on your machine with poolOrigin = "pulled". Only one puller wins per card.

Push (pool)

A pool operation. Copies a local card into the team's Supabase pool. Your local copy stays; the pool copy becomes the shared state.

Quick-fix

A processingType value for the Bugs column. Short, targeted fix without plan/test ceremony. Doesn't move the card's status.

Seat

One team member. Billing is per-seat. Trial is capped at 5 seats; paid plans set seats at checkout and enforce them at join time.

Skill

A markdown file loaded by Claude Code (or platform equivalent) that instructs the agent how to handle specific tasks. Ideafy ships three: ideafy.md, human-test.md, product-narrative.md.

Solo mode

The fallback when no auth is configured. Full local functionality, no team features. Default for Public edition; the Team edition falls back to it automatically when Supabase env vars are missing.

Sync-card

The fire-and-forget sync endpoint (POST /api/internal/sync-card) that propagates local card mutations to Supabase pool cards.

Task number

The numeric part of a card's display ID. Assigned incrementally per project from projects.nextTaskNumber.

Verdict

The aiVerdict field on a card: positive / negative / null. Set by save_opinion. Shown on the card surface as a Brain icon with a checkmark or cross.

Withdrawn

The seventh (terminal) kanban column. Cards you decided not to ship are archived here. A negative verdict plus a Withdrawn move is a clean audit trail for "why we said no."

Worktree

A git worktree — an isolated checkout of the repository tied to a branch. Ideafy creates one per card in implementation, at .worktrees/kanban/[PRJ-N-...].

Prev: FAQ Next: Keyboard shortcuts Up: User guide index