diff --git a/README.md b/README.md index 5a1aba8dd6..2d5fa69f58 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,8 @@ Open source, multi-provider, no telemetry, not tied to any cloud. - **Parallel task execution** – start and manage multiple tasks from different sources simultaneously, boosting productivity with AI agents - **Integrated workspace** - Built-in terminal, code editor with LSP, git changes panel, embedded vscode and chat in one IDE-like view - **Kanban task management** - Drag-and-drop boards, columns, and workflow automation -- **Agentic workflows** - Multi-step pipelines that chain agents through automated task routing. See [docs/workflows.md](docs/workflow-tips.md) +- **Agentic workflows** - Multi-step pipelines that mix-and-match agents per step - for example, Claude Code Opus to design a plan, GitHub Copilot Sonnet to implement it, and Codex GPT 5.4 to review the changes. See [docs/workflows.md](docs/workflow-tips.md) +- **Sub-tasks** - Agents can spawn sub-tasks that resume from the parent task's session. Useful for splitting a task that has grown too big, or producing several PRs from the same starting point. - **CLI passthrough** - Drop into raw agent CLI mode for direct terminal interaction with any supported agent, leverage the full power of their TUIs - **Workspace isolation** - Git worktrees prevent concurrent agents from conflicting - **Flexible runtimes** - Run agents as local processes, in isolated Docker containers or in remote executors like sprites.dev diff --git a/docs/roadmap.md b/docs/roadmap.md index 823cbb3d98..6cbd95e715 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -4,18 +4,17 @@ High-level direction for the project. This is not a commitment - priorities shif ## Now -- Stability and bug fixes across all agent integrations -- Improved plan mode - richer plan editing, version history, plan diffs +- Stability and bug fixes across all agent integrations - current primary focus ## Next -- Github integration - link tasks to GitHub issues, PRs -- Workflow templates sharing - import/export workflows -- Mobile-friendly UI - orchestrate and review from your phone -- Remote SSH runtime - run agents on remote servers over SSH -- Linear / Jira integration - sync tasks and workflows with popular project management tools +- Multi-repo task support - a single task can span multiple repositories +- Coordinator mode - have an agent coordinate sub-tasks executed by other agents +- Improved mobile UI - polish the existing mobile view for orchestrating and reviewing from your phone ## Later +- Issue tracker integration - import issues from GitHub, Linear, and Jira as tasks +- Remote SSH runtime - run agents on remote servers over SSH - Kubernetes operator - auto-scaling agent workloads in a cluster - Analytics dashboard - agent performance, cost tracking, success rates diff --git a/docs/workflow-tips.md b/docs/workflow-tips.md index 8aa713a3d2..4b0b30a1fa 100644 --- a/docs/workflow-tips.md +++ b/docs/workflow-tips.md @@ -1,6 +1,6 @@ # Workflows -Kandev ships with four workflow templates. Each defines a sequence of steps with automated transitions - agents start, stop, and move between steps based on events like entering a step, sending a message, or an agent completing its turn. +Kandev ships with five workflow templates. Each defines a sequence of steps with automated transitions - agents start, stop, and move between steps based on events like entering a step, sending a message, or an agent completing its turn. You can use these as-is or **create custom workflows** tailored to you or your team. @@ -69,6 +69,30 @@ Focused on design and architecture. The agent creates technical designs for you --- +### Feature Dev + +Full development lifecycle with quality gates between phases - spec, implementation with TDD, automated review, QA, draft PR, and CI fixup. Each phase runs a fresh agent turn so context stays focused on the task at hand. + +**Steps:** Todo → Spec → Work → Review → QA → PR → CI Fixup → Done + +| Step | What happens | +|:------:|-------------| +| **Todo** | Tasks ready to be picked up. | +| **Spec** | Agent analyzes the task, explores the codebase, proposes approaches, and saves a detailed plan via MCP tool. Runs in plan mode and stops for your review - you can edit the plan in the UI before moving on. | +| **Work** | Agent retrieves the plan (including edits), acknowledges modifications, and implements using a TDD loop - failing test → minimum code → refactor → commit, one behavior at a time. | +| **Review** | Agent context is reset, then a fresh review pass checks the diff for security, correctness, performance, and code quality. Fixes trivial issues directly; reports the rest with file:line. | +| **QA** | Agent verifies the feature end-to-end - traces wiring, runs the happy path, tries to break it with boundary values and error paths, and checks test coverage. | +| **PR** | Agent runs formatters/linters, commits and pushes remaining changes, picks up the repo's PR template if present, and creates a draft PR. | +| **CI Fixup** | Agent polls CI, fetches failed logs, fixes lint/test/type errors, pushes, and re-polls until checks go green. | +| **Done** | Final state. | + +**When to use it:** +- Features that need quality gates between phases +- Changes that warrant a dedicated review + QA pass before the PR goes up +- When you want a single task to carry a feature from idea to mergeable PR + +--- + ### PR Review Track pull requests through automated code review. The agent reviews changed files and produces structured findings.