# Paca Roadmap This document outlines the planned development trajectory for Paca. It is updated as priorities shift and milestones are reached. > **Legend:** βœ… Done  Β·  🚧 In progress  Β·  πŸ“‹ Planned  Β·  πŸ’‘ Exploring --- ## Phase 1 β€” Foundation (Alpha) _Goal: a working, self-hostable core that a small team can actually use._ ### Infrastructure & Deployment - βœ… Docker Compose single-command setup - βœ… Interactive install script for Linux servers - βœ… PostgreSQL + Valkey bundled by default - βœ… Caddy gateway with service routing - βœ… Environment-based configuration (`.env`) ### Core Platform - βœ… User authentication (JWT) - βœ… Project and workspace management - βœ… Task CRUD with custom fields and task types - βœ… Backlog management - βœ… Sprint creation and lifecycle (start, complete) - βœ… Scrumban board with drag-and-drop - βœ… Real-time board updates via Socket.IO - βœ… Task comments and activity feed - βœ… File attachments - βœ… Board view customization (swimlanes, grouping) ### Documentation - βœ… Living document editor per project - βœ… AI agent contributions to documents (diagram suggestions, component descriptions) - βœ… Document version history and diff view - βœ… Link document sections to tasks and epics ### Plugin System - βœ… WASM sandbox for backend plugins - βœ… Frontend module bundles - βœ… Capability-based permission declaration - βœ… Plugin Marketplace UI (Settings β†’ Plugins β†’ Marketplace) - βœ… Local plugin install script - βœ… Plugin SDK and developer documentation - βœ… GitHub plugin (PR status on task cards, branch linking) - βœ… BDD plugin (Gherkin scenario editor, AI-assisted scenario generation) - βœ… Checklist plugin (sub-task checklists on any task card) - βœ… Host version compatibility checks for plugin install and upgrade ### AI Agent Integration - βœ… Agent membership in projects and sprints - βœ… Agent task assignment and status updates - βœ… OpenHands SDK integration (isolated sandbox containers) - βœ… Agent activity feed and progress reporting on task cards - πŸ“‹ Reduce AI agent sandbox container image size and improve startup/runtime performance ### MCP Server - βœ… `@paca-ai/paca-mcp` npm package - βœ… Core tool set: projects, tasks, sprints, docs, members - βœ… Claude Desktop quick-setup guide - βœ… Agent-mode: scoped identity, project-bound context - βœ… Plugin tools registered at runtime by installed plugins ### Agent Skills - βœ… `/paca` Agent Skills for Claude Code, Gemini CLI, Cursor, and AGENTS.md-reading tools β€” served live from the running instance's own API, always in sync with the installed version - βœ… One-command install script that detects and installs to every supported client on the machine - βœ… Full command set: `/paca`, `/paca-epic`, `/paca-clarify`, `/paca-breakdown`, `/paca-sprint`, `/paca-estimate`, `/paca-prioritize`, `/paca-do`, `/paca-test`, `/paca-doc`, `/paca-review`, `/paca-triage`, `/paca-retro`, `/paca-feedback`, `/paca-board`, `/paca-team`, `/paca-automation` (replaces `/paca-workflow`), `/paca-setup` - βœ… Plugin-contributed skills installed alongside core skills --- ## Phase 2 β€” Beta _Goal: deliver the features that make Paca meaningfully different from standard project tools._ ### Infrastructure & Deployment - βœ… ARM64 Docker image support - βœ… Helm chart for Kubernetes β€” see [deploy/helm](deploy/helm/README.md), including a Kubernetes-Job-per-conversation AI agent sandbox backend ### Core Platform - βœ… Keyboard shortcuts and command palette - βœ… i18n foundation for the web UI - βœ… In-app notifications β€” notification bell with read/unread state - βœ… Activity diff & revert β€” visual before/after diff for every field change in the activity pane, one-click revert (tasks and docs) - βœ… Custom branding β€” admin-configurable brand name, logo, favicon, and accent color (light/dark presets), applied across the app shell and login screen ### Planning & Task Management - βœ… Task linking β€” link related tasks (blocked by, blocks, related, duplicate, parent/child) - βœ… Timeline / Gantt view β€” epics as bars from start β†’ due date with Day–Year zoom, `blocks` dependency arrows that flag scheduling conflicts, and drag-to-reschedule; selectable alongside Board/Table on any interaction - βœ… Advanced view settings β€” per-view column grouping, swimlanes, sort, field visibility/ordering, slicing, and field aggregation across built-in and custom fields - βœ… Interactions sidebar β€” quick nav to Timeline, Product Backlog, and Sprints, with drag-and-drop to reassign a task's sprint ### Automation - βœ… Event-driven automation engine β€” visual, n8n-style graph builder for Trigger β†’ Condition β†’ Action flows, with multi-branch switch logic and an `Else` fallback path - βœ… Nine-plus built-in trigger types, including UTC cron schedules, due-date offsets, task-dependency gates, and inbound webhooks with secret-token auth - βœ… Actions that retarget linked tasks (parent, children, blockers, or explicit picks) with automatic fan-out, dispatch AI agents with custom prompts, or call external APIs (SSRF-safe outbound networking) - βœ… Run History panel β€” step-by-step trace of every automation run - βœ… Project-wide Dependency Map visualizing cross-task automation relationships - βœ… Plugin-contributed automation node types β€” plugins can add custom trigger, condition, and action nodes via WASM ### AI Agent Collaboration - βœ… In-app chat with agents β€” send messages directly to an agent on a task, get replies in the activity feed - βœ… Agent-to-human handoff workflow (agent flags tasks it cannot complete, notifies assignee with context) - βœ… ACP agent support β€” connect Claude Code, Codex, Gemini CLI, or any custom Agent Client Protocol server as a Paca agent via a local bridge (`paca-acp-bridge`), streaming over an authenticated WebSocket using your own local auth and git/`gh` credentials - βœ… Global agents β€” agents not bound to a single project, managed from Admin β†’ Agents - βœ… Agent-scoped MCP API keys and identity verification for programmatic agent authentication - βœ… PM / business analyst agent β€” discusses requirements in plain or technical terms, reads the code, and drafts tasks in Refinement that only a human can approve (`paca-analyst` skill + Analyst role) - βœ… Unified Conversations β€” direct, task-triggered, and automation-triggered agent conversations, with project-scoped and global views ### AI Agent Environments - βœ… Static environments β€” named, long-lived containers that agents attach to instead of a fresh disposable sandbox, so files on disk and background processes persist across conversations, on both Docker Compose and Kubernetes/Helm - βœ… In-browser terminal and real SSH (per-environment authorized keys, managed from the environment's own settings) for pairing inside an environment - βœ… User-managed port forwards to preview a running dev server from an environment - βœ… `provider_cli` agent type β€” drive a CLI you're already logged into (Claude Code, Codex, Gemini CLI, Cursor CLI) inside a static environment, syncing configured MCP servers into its config - βœ… Browser extension for page annotations β€” comment directly on an element of an environment's live preview page and turn the comment into a Paca task in one click, authenticated via the existing Paca session ### Official Plugins - βœ… Webhook plugin (outgoing webhooks for task and sprint events, configurable per project) - βœ… Time logging plugin (track time spent per task, per sprint) - βœ… Dashboard plugin - πŸ“‹ Calendar plugin β€” a `view` extension that renders tasks on a month/week calendar by start and due date, selectable alongside Board/Table/Gantt on any interaction, with drag-to-reschedule and sprint boundaries shown ### Security & Access Control - βœ… Global RBAC β€” admin-managed global roles with granular, per-domain permission control - βœ… User administration β€” admin-created accounts, forced password change on first login, password reset, account deletion - βœ… Personal API keys β€” Settings β†’ API Keys for human users - βœ… SSO / OIDC support (connect to your IdP) ### Observability & Operations - βœ… Backup and restore tooling for PostgreSQL data --- ## Beyond v1.0 β€” Exploring _These are ideas we find compelling but have not yet committed to._ - πŸ’‘ Team chat & meetings β€” built-in messaging and voice/video, combining Slack-style channels and threads with Discord-style voice rooms, so people can talk and handle tasks on one platform - πŸ’‘ Channels, threads, direct messages, mentions, and reactions, scoped to workspaces and projects - πŸ’‘ Task-aware chat β€” link, create, and update tasks from a conversation, with task and sprint context shown inline - πŸ’‘ Voice and video rooms that people can drop into, with screen sharing - πŸ’‘ Agents as first-class participants β€” agents can join chat conversations and meetings, respond to mentions, and take notes, summarize, and turn discussion into tasks - πŸ’‘ Multi-agent orchestration β€” agents that delegate sub-tasks to other agents - πŸ’‘ Hosted cloud option (opt-in, for teams that don't want to self-host) --- ## How to Influence the Roadmap This is an open-source project β€” the roadmap is shaped by the community. - **Vote on issues** β€” πŸ‘ existing GitHub issues to signal priority - **Open a discussion** β€” propose a feature or share how you use Paca in [GitHub Discussions](https://github.com/Paca-AI/paca/discussions) - **Contribute** β€” see [CONTRIBUTING.md](CONTRIBUTING.md) to get started Items marked πŸ“‹ are not in any fixed release order. If something here matters to your team, open an issue or pull request β€” that moves it forward.