LetsTask — AI-Native Task Management

🔍 The Problem 🔍 El Problema

Why traditional task tools fail for AI agents Por qué las herramientas tradicionales fallan para agentes IA

Tools built for human point-and-click workflows can't support autonomous AI execution at scale. Las herramientas diseñadas para flujos humanos de clic no soportan ejecución autónoma de IA a escala.

❌

No machine-native interfacesSin interfaces nativas para máquinas

Built for human GUIs — agents need structured APIs and tool protocols, not drag-and-drop boards.Diseñadas para GUIs humanas — los agentes necesitan APIs estructuradas y protocolos de herramientas, no tableros de arrastrar y soltar.

❌

No governance for autonomous actorsSin gobernanza para actores autónomos

Agents can run wild with no approval gates, review sessions, or audit trails for accountability.Los agentes pueden descontrolarse sin puertas de aprobación, sesiones de revisión ni rastros de auditoría.

❌

No plan/execute separationSin separación planificar/ejecutar

Agents code before thinking. No structured analysis phase means wasted work and wrong directions.Los agentes programan antes de pensar. Sin fase de análisis estructurada, se desperdicia trabajo y se toman direcciones incorrectas.

❌

No cross-agent coordinationSin coordinación entre agentes

No event system, just polling. No dependency tracking, no blocking signals, no shared state machine.Sin sistema de eventos, solo sondeo. Sin seguimiento de dependencias, señales de bloqueo ni máquina de estados compartida.

✨ LetsTask treats AI agents as first-class citizens alongside human developers. ✨ LetsTask trata a los agentes IA como ciudadanos de primera clase junto a los desarrolladores humanos.

🧠 Core Differentiator 🧠 Diferenciador Clave

The Analysis / Implementation Split La separación Análisis / Implementación

Agents must plan and get approval before work items are materialized. Think first, code second. Los agentes deben planificar y obtener aprobación antes de que se materialicen los elementos de trabajo. Primero pensar, después programar.

🔬 Analysis PhaseFase de Análisis

1 Agent creates analysis with objectivesAgente crea análisis con objetivos
2 Builds planned_structure — JSON proposal of features + tasksConstruye planned_structure — propuesta JSON de features + tareas
3 Submits for reviewEnvía para revisión
4 Human reviews and approvesHumano revisa y aprueba

⚡ Implementation PhaseFase de Implementación

1 Features + tasks auto-materializedFeatures + tareas auto-materializadas
2 Agent sets up git worktreeAgente configura git worktree
3 Executes tasks sequentially through state machineEjecuta tareas secuencialmente a través de la máquina de estados
4 PR created on completionPR creado al completar

↓ Auto-materializes into real work items ↓ ↓ Auto-materializa en ítems de trabajo reales ↓

planned_structure.json
{
  "planned_structure": {
    "features": [
      {
        "name": "Authentication Module",
        "description": "JWT-based auth with refresh tokens",
        "tasks": [
          {
            "title": "Create user model and migrations",
            "complexity": "medium",
            "risk_level": "low",
            "acceptance_criteria": ["User table created", "Indexes on email"]
          },
          {
            "title": "Implement login/register endpoints",
            "complexity": "high",
            "risk_level": "medium"
          }
        ]
      }
    ]
  }
}

📐 Architecture 📐 Arquitectura

Four-level work hierarchy Jerarquía de trabajo de cuatro niveles

From project vision down to atomic code changes — every level carries structured metadata. Desde la visión del proyecto hasta cambios atómicos de código — cada nivel lleva metadatos estructurados.

P

Project

Top-level containerContenedor de nivel superior

Isolated namespace for all work. Holds project-wide configuration, supervision defaults, and analysis history.Espacio de nombres aislado para todo el trabajo. Contiene configuración del proyecto, valores de supervisión y historial de análisis.

slug supervision_mode repository_url config

A

Analysis

Planning phaseFase de planificación

Contains the planned_structure JSON — the proposal that materializes into real work items upon approval.Contiene el JSON planned_structure — la propuesta que se materializa en ítems de trabajo reales tras la aprobación.

planned_structure objectives approach status review_sessions

F

Feature

Logical groupingAgrupación lógica

Groups related tasks within an implementation. Carries its own supervision mode, execution order, and progress tracking.Agrupa tareas relacionadas dentro de una implementación. Lleva su propio modo de supervisión, orden de ejecución y seguimiento de progreso.

supervision_mode order_index acceptance_criteria progress

T

Task

Atomic unit of workUnidad atómica de trabajo

Full state machine, dependency graph, risk assessment, and review requirements. The smallest executable unit.Máquina de estados completa, grafo de dependencias, evaluación de riesgo y requisitos de revisión. La unidad ejecutable más pequeña.

status complexity risk_level testables dependencies is_approved requires_review

🎛️ Execution Control 🎛️ Control de Ejecución

Two supervision modes Dos modos de supervisión

Choose the right level of control for every feature — from full autonomy to step-by-step approval. Elige el nivel correcto de control para cada feature — desde autonomía total hasta aprobación paso a paso.

🟢 Autonomous🟢 Autónomo

Trust the agent, move fastConfía en el agente, muévete rápido

✓ All tasks auto-approved on creationTodas las tareas auto-aprobadas al crearse
✓ Agent picks any ready task freelyAgente elige cualquier tarea lista libremente
✓ No execution order gating (beyond deps)Sin control de orden de ejecución (más allá de deps)
✓ Parallel execution when possibleEjecución en paralelo cuando sea posible

💡 Best for: trusted agents, prototyping, low-risk features 💡 Ideal para: agentes confiables, prototipos, features de bajo riesgo

🟡 Supervised🟡 Supervisado

Human in the loop, maximum controlHumano en el ciclo, máximo control

✓ Tasks start unapprovedLas tareas comienzan sin aprobar
✓ Human must approve before agent startsHumano debe aprobar antes de que el agente inicie
✓ Only one task DOING at a time (sequential)Solo una tarea DOING a la vez (secuencial)
✓ Full review between each taskRevisión completa entre cada tarea

💡 Best for: production codebases, critical features, compliance 💡 Ideal para: código en producción, features críticos, cumplimiento

⚙️ State Machine ⚙️ Máquina de Estados

Task lifecycle Ciclo de vida de las tareas

Every task follows a strict state machine with enforced transition rules, approval gates, and dependency checks. Cada tarea sigue una máquina de estados estricta con reglas de transición, puertas de aprobación y verificación de dependencias.

TODO

Initial stateEstado inicial

→

DOING

Approved + deps metAprobado + deps ok

→

REVIEW

If requires_reviewSi requiere revisión

→

DONE

Complete ✓Completo ✓

ABORT ← Can be reached from any state ← Alcanzable desde cualquier estado

TODO → DOING

Requires: is_approved = true, all dependencies in DONE state, not externally blocked.Requiere: is_approved = true, todas las dependencias en estado DONE, sin bloqueo externo.

DOING → REVIEW

Only when requires_review = true. Agent marks work complete, awaits human verdict.Solo cuando requires_review = true. El agente marca trabajo como completo, espera veredicto humano.

DOING → DONE

When requires_review = false. Agent completes work and transitions directly.Cuando requires_review = false. El agente completa y transiciona directamente.

REVIEW → DONE

Human reviews and approves. Can also send back to DOING if changes needed.Humano revisa y aprueba. También puede devolver a DOING si se necesitan cambios.

🔧 AI-Native Interface 🔧 Interfaz Nativa para IA

60+ MCP tools for agents 60+ herramientas MCP para agentes

Every operation available through the Model Context Protocol, REST API, and WebSocket events. Cada operación disponible a través del Protocolo de Contexto de Modelo, API REST y eventos WebSocket.

8

Analysis MgmtGestión de Análisis

6

Implementation MgmtGestión de Impl.

7

Feature MgmtGestión de Features

10

Task MgmtGestión de Tareas

5

SummariesResúmenes

4

CommentsComentarios

5

DependenciesDependencias

4

Tags & CheckpointsTags y Checkpoints

3

AttachmentsAdjuntos

4

Review SessionsSesiones de Revisión

3

Project ConfigConfig. de Proyecto

3

Events & LogsEventos y Logs

🔌 MCP / SSE

🌐 REST API

⚡ WebSocket Events

agent-workflow.ts
// Agent workflow using MCP tools

// 1. Create analysis with planned structure
const analysis = await mcp.call("create_analysis", {
  project: "my-app",
  title: "Add authentication",
  planned_structure: { features: [...] }
});

// 2. After human approval, get ready tasks
const tasks = await mcp.call("get_ready_tasks", {
  implementation_id: analysis.implementation_id
});

// 3. Execute each task through the state machine
for (const task of tasks) {
  await mcp.call("start_task", { task_id: task.id });
  // ... do the work ...
  await mcp.call("complete_task", { task_id: task.id });
}

🛡️ Governance 🛡️ Gobernanza

Review sessions & audit trails Sesiones de revisión y rastros de auditoría

Structured review workflow with full accountability. Every decision is recorded, every change is tracked. Flujo de revisión estructurado con rendición de cuentas completa. Cada decisión se registra, cada cambio se rastrea.

📋

Start Review SessionIniciar Sesión de Revisión

Open a formal review session on any analysis, feature, or task. All changes within the session are tracked.Abrir una sesión formal de revisión en cualquier análisis, feature o tarea. Todos los cambios dentro de la sesión se rastrean.

🔍

Inspect & CommentInspeccionar y Comentar

Review the planned structure, code changes, acceptance criteria. Leave structured comments for the agent.Revisar la estructura planeada, cambios de código, criterios de aceptación. Dejar comentarios estructurados para el agente.

⚖️

Render VerdictEmitir Veredicto

Approve, edit, or cancel. Each verdict triggers downstream effects — approval materializes work items.Aprobar, editar o cancelar. Cada veredicto desencadena efectos — la aprobación materializa ítems de trabajo.

✓ APPROVED

✎ EDITED

✗ CANCELLED

🔗 Analysis Review → Implementation🔗 Revisión de Análisis → Implementación

Approving an analysis automatically materializes the planned_structure into features and tasks. No manual creation needed.Aprobar un análisis automáticamente materializa planned_structure en features y tareas. Sin creación manual.

📊 Full Audit Trail📊 Rastro de Auditoría Completo

Who reviewed, when, what verdict, what changed. Critical for compliance, accountability, and debugging agent behavior.Quién revisó, cuándo, qué veredicto, qué cambió. Crítico para cumplimiento, rendición de cuentas y depuración del comportamiento del agente.

🚪 Quality Gates🚪 Puertas de Calidad

Task review controls quality gates — agents can't mark work as done without passing review when required.La revisión de tareas controla puertas de calidad — los agentes no pueden marcar trabajo como hecho sin pasar revisión cuando es requerida.

🔗 Coordination 🔗 Coordinación

Dependencies & blocking Dependencias y bloqueo

Cross-feature dependency graphs with cycle prevention and external blocking signals. Grafos de dependencias entre features con prevención de ciclos y señales de bloqueo externo.

🔀

Cross-Feature DependenciesDependencias Entre Features

Task-to-task dependencies work even across different features. The engine resolves the full graph before declaring a task "ready."Las dependencias tarea-a-tarea funcionan incluso entre features diferentes. El motor resuelve el grafo completo antes de declarar una tarea "lista."

🔄

Cycle PreventionPrevención de Ciclos

Automatic cycle detection at both task-level and feature-level. Prevents deadlocks before they happen.Detección automática de ciclos a nivel de tarea y feature. Previene bloqueos mutuos antes de que ocurran.

✅

Ready Task ResolutionResolución de Tareas Listas

A task is "ready" only when all dependencies are in DONE state, it's approved, and not externally blocked.Una tarea está "lista" solo cuando todas las dependencias están en estado DONE, está aprobada y no está bloqueada externamente.

🚧

External BlockingBloqueo Externo

is_blocked + blocked_reason — separate from dependency blocking. For infrastructure issues, waiting on humans, etc.is_blocked + blocked_reason — separado del bloqueo por dependencias. Para problemas de infraestructura, esperando humanos, etc.

Dependency Graph Example Ejemplo de Grafo de Dependencias

Task 1
DONE ✓

→

Task 2
DONE ✓

→

Task 4
READY ●

Task 3
DONE ✓

↗

Task 5
BLOCKED 🔒

🔄 Patterns 🔄 Patrones

Agent workflow patterns Patrones de flujo de trabajo de agentes

Common patterns for AI agent integration — from full analysis to resume-after-block. Patrones comunes para integración de agentes IA — desde análisis completo hasta reanudar tras bloqueo.

1

Full Analysis-to-PRAnálisis Completo a PR

The complete lifecycle from planning through implementation to pull request.El ciclo de vida completo desde planificación hasta implementación y pull request.

/letstask-analyze → review → /letstask-do-feature → review → close → /letstask-pr

2

Autonomous ExecutionEjecución Autónoma

Fast-track for trusted agents — auto-approve, execute, ship.Vía rápida para agentes confiables — auto-aprobar, ejecutar, enviar.

create analysis → auto-approve → get_ready_tasks → execute → done

3

Supervised SequentialSupervisado Secuencial

Maximum control — human approves each task, agent executes one at a time.Máximo control — humano aprueba cada tarea, agente ejecuta una a la vez.

human approves → agent executes → review → next task → repeat

4

Resume After BlockReanudar Tras Bloqueo

Agent hits a blocker, signals it, human resolves, work resumes seamlessly.Agente encuentra un bloqueador, lo señala, humano resuelve, trabajo se reanuda sin problemas.

agent hits blocker → block_task → human resolves → /letstask-resume

⌨️ Claude Code Integration ⌨️ Integración con Claude Code

Slash commands Comandos slash

Purpose-built slash commands for Claude Code — orchestrate the full lifecycle from your terminal. Comandos slash diseñados para Claude Code — orquesta el ciclo de vida completo desde tu terminal.

/letstask-analyze

/letstask-analyze-and-do

/letstask-supervised-analyze-and-do

/letstask-do-feature

/letstask-do-next-feature

/letstask-review-feature

/letstask-resume-feature

/letstask-close-implementation

/letstask-cleanup

/letstask-sync-git

/letstask-pr

🌐 Ecosystem 🌐 Ecosistema

Built to integrate Construido para integrar

LetsTask is one piece of a larger AI development ecosystem. Seamless integrations where it matters. LetsTask es una pieza de un ecosistema de desarrollo IA más amplio. Integraciones sin fricción donde importa.

🤖

BitBot

Federation, JWT auth, skills system, tool contract v1.11. Multi-agent orchestration layer.Federación, auth JWT, sistema de habilidades, contrato de herramientas v1.11. Capa de orquestación multi-agente.

🧠

ContextBrain

KB references in analyses, contextual knowledge injection in implementations. Smarter agent decisions.Referencias KB en análisis, inyección de conocimiento contextual en implementaciones. Decisiones de agente más inteligentes.

🚀

HassleFree

Deployment via git tags, webhooks, K8s orchestration. From task completion to production in minutes.Despliegue vía git tags, webhooks, orquestación K8s. De tarea completada a producción en minutos.

🧪

DeTesting

Task testables reference test suites. Automated verification that agent work meets quality standards.Los testables de tareas referencian suites de pruebas. Verificación automática de que el trabajo del agente cumple estándares.

🏗️ Technology Stack 🏗️ Stack Tecnológico

Built with modern tools Construido con herramientas modernas

Node.js Express 5 PostgreSQL SQLite React 19 Vite Zustand Tailwind CSS WebSocket MCP SDK JWT S3 AES-256

Your AI agents finally have a project manager Tus agentes IA por fin tienen un project manager