@yattalo/task-system
v0.5.0
Published
Portable multi-agent task orchestration scaffold for Convex projects
Maintainers
Readme
@yattalo/task-system
Portable multi-agent task orchestration scaffold for Convex projects. Generates a complete task management system with a single command.
Install
npx @yattalo/task-system initOr install globally:
npm install -g @yattalo/task-systemQuick Start
# Scaffold with software preset (Claude + Gemini + Codex agents)
npx @yattalo/task-system init --preset software
# Scaffold with research preset (4 agents, confidence tracking)
npx @yattalo/task-system init --preset research
# Dry run (preview without writing files)
npx @yattalo/task-system init --preset software --dry-runWhat Gets Generated
| Layer | Files | Description |
|-------|-------|-------------|
| Schema | convex/taskSystem/schema.ts | Convex table definitions |
| CRUD | convex/taskSystem/tasks.ts | Queries and mutations |
| Orchestrator | convex/taskSystem/orchestrator.ts | Task lifecycle, auto-blocking |
| HTTP API | convex/taskSystem/http.ts | REST endpoints |
| Dashboard | dashboard.html | Standalone Kanban board |
| Agent-Ops | convex/taskSystem/agentOps.ts + scripts | Job scheduling (optional) |
| Git Hook | scripts/auto-task-tracker.js | Auto-update tasks on commit |
| Skill | .claude/skills/task-orchestrator/SKILL.md | Claude Code integration |
| UCA Core | 10 new files | Full UCA backend (agents, context, drift, hooks, memory, skills, etc.) |
| Dashboard SPA | dashboard-app/ | React Kanban + context browser + drift timeline |
| mgrep | Setup + skill | Semantic multi-repo search integration |
Commands
| Command | Description |
|---------|-------------|
| init | Scaffold task system into a project |
| seed | Import task definitions into Convex |
| status | Show task stats in terminal |
| kanban | Show Kanban board in terminal |
| dashboard | Serve HTML dashboard in browser |
| report | Generate markdown report |
Operational Commands (v0.4.0+)
UCA orchestration commands for managing context tiers, drift detection, and multi-agent coordination.
| Command | Subcommand | Description |
|---------|------------|-------------|
| context | list [--tier draft\|reviewed\|curated] | List context entries, optionally filtered by tier |
| context | add --type <type> --content "..." --by <agent> | Add a new context entry |
| context | promote <entryId> --by <agent> --reason "..." | Promote entry to next tier |
| drift | list [--status open] [--severity high] | List drift events with optional filters |
| drift | create --agent <id> --type <type> --severity <level> --desc "..." | Create a drift event |
| drift | acknowledge <eventId> --by <agent> | Acknowledge a drift event |
| agent | list [--status active] | List registered agents |
| agent | status <agentId> --set <status> | Update agent status |
| day | [--agent <id>] [--date YYYY-MM-DD] | Show daily summary for an agent |
What's New in v0.5.0
v0.5.0 transforms task-system from a task scaffold into a full UCA (Unified Context Accelerator) orchestration platform — complete backend, React dashboard, and multi-repo search.
UCA Backend Generation
The init command now generates a complete UCA backend with 10 new Convex modules:
| File | Purpose |
|------|---------|
| convex/taskSystem/agents.ts | Agent registry CRUD |
| convex/taskSystem/contextEntries.ts | Context tier management (draft → reviewed → curated) |
| convex/taskSystem/driftEvents.ts | Scope creep & drift detection |
| convex/taskSystem/heartbeats.ts | Agent heartbeat monitoring |
| convex/taskSystem/hooks.ts | Event hooks for task lifecycle |
| convex/taskSystem/memory.ts | Agent memory & learning persistence |
| convex/taskSystem/sessionBridge.ts | Inter-agent session handoff |
| convex/taskSystem/skills.ts | Skill registry for agents |
| convex/taskSystem/cronManager.ts | Cron job management |
| convex/taskSystem/ucaTasks.ts | Extended task operations |
Dashboard SPA
The dashboard command now serves a bundled React SPA with Kanban board, agent status panel, context browser, and drift timeline — replacing the simple HTML file from v0.4.0.
mgrep Integration
New mgrep-setup generator adds semantic multi-repo search via Mixedbread. Includes a Claude Code skill for cross-project code search.
Presets
Software
3 agents (Claude, Gemini, Codex), 7 categories, 5 phases. Extensions: commit tracking, scope creep detection, code review findings, agent-ops.
Research
4 agents (Claude, Codex, Gemini, Antigravity), 6 categories, 5 phases. Extensions: confidence tracking, evidence tracker, handoff log, checkpoint log.
License
MIT
