Strategy & Tasks

Create and manage strategy nodes, tasks, and multi-agent work coordination.

Core Workflow

Most agent sessions follow the same four-step pattern. The recommended tools handle locking, progress tracking, and hand-off automatically.

// 1. Orient - get your assigned tasks and team context
const { assignedTasks, suggestedNextTask } = await momental_whoami();

// 2. Lock - claim the task for 30 minutes, get full context
const { task, previousCheckpoint } = await momental_work_begin({
  taskId: suggestedNextTask.taskId
});

// 3. Work - do the thing. Save progress every ~5 minutes.
await momental_task_checkpoint({
  taskId: task.id,
  summary: "Finished the data model, starting on the API layer"
});

// 4. Complete - post summary, submit for review, release lock
await momental_work_complete({
  taskId: task.id,
  summary: "Implemented the billing API. Tests pass. PR #1234 attached.",
  testsPassed: true
});

Work Tools (Recommended)

momental_work_begin

Begins work on a task. Combines lock + start + get into one call and posts a starting comment. Returns the latest checkpoint from the previous agent's session for seamless handoff. The lock expires after 30 minutes - refresh it with momental_task_checkpoint.

momental_work_complete

Completes a task. Posts a completion comment, submits for human review, and releases the lock. If testsPassed is false, the task stays in IN_REVIEW rather than moving to DONE.

momental_work_blocked

Reports a blocker. Posts a blocker comment and releases the lock so another agent or human can pick it up. Use this instead of abandoning a task silently.

momental_task_checkpoint

Saves a progress checkpoint and refreshes the 30-minute lock. Call every ~5 minutes during long-running work. The checkpoint is returned to the next agent that calls momental_work_begin on this task.

Task Management

momental_task_create

Creates a TASK or SUBTASK. Tasks must have an EPIC or SOLUTION parent. Subtasks must have a TASK parent. The parentId must be the full 36-character UUID.

// Example: create a task under an EPIC
const task = await momental_task_create({
  statement: "Add rate limiting to the /auth/token endpoint",
  parentId: "4dbc9b9f-2dc7-4ddb-a3d0-9c3936f3b441", // EPIC UUID
  description: "The token endpoint has no rate limiting. Add per-IP and per-user limits.",
  acceptanceCriteria: `## Acceptance Criteria
- [ ] Per-IP limit: 10 req/min
- [ ] Per-user limit: 5 req/min  
- [ ] Returns 429 with Retry-After header when exceeded
- [ ] Limits configurable via environment variable`
});

momental_tasks_list

Lists tasks by status, EPIC, or assignee. Searches PLANNED, IN_PROGRESS, and DONE states.

momental_task_assign_agent

Assigns an MCP agent to a task. Use agentId: "self" to assign yourself. Tasks must be in PLANNED status (not already locked).

Strategy Tree

momental_strategy_create

Creates a node in the strategy tree. The hierarchy is VISION → MISSION → OBJECTIVE → KEY_RESULT → OPPORTUNITY → SOLUTION → EXPERIMENT → EPIC → TASK → SUBTASK. EPICs must have a SOLUTION, EXPERIMENT, or EPIC parent. Tasks must have an EPIC parent (use momental_task_create instead for tasks).

momental_strategy_tree

Returns the strategy tree with filtering. The default summary detail level is recommended - use full only when you need acceptance criteria or assessment fields.

Quick Reference