Files
kandev/docs/specs/integrations/README.md
T
2026-09-06 11:36:16 +01:00

107 lines
6.1 KiB
Markdown

---
status: draft
system: integrations
specification_version: 1
migration: in_progress
owners:
- kandev
---
# Integration system
## Purpose
The integration system owns connections to external services and the
provider-specific contracts that synchronize or act on external work.
## Ownership
This system owns provider credentials, provider identity, external issue and
pull-request synchronization, integration settings, provider-aware review
automation, external question or answer flows, and provider-specific UI
outcomes that expose those contracts.
## Exclusions
- Generic authentication belongs to the [auth system](../auth/README.md).
- Durable Kandev tasks belong to the [task system](../tasks/README.md).
- Plugin-owned services belong to the [plugin system](../plugins/README.md).
- Reusable presentation contracts without provider state belong to the
[UI system](../ui/README.md).
## Specification map
### Requirements
- [Azure DevOps Integration](requirements/azure-devops-integration.md)
- [Bitbucket Connector Plugin](requirements/bitbucket-plugin.md)
- [Claude Fork Review Allowlist](requirements/claude-fork-review-allowlist.md)
- [Clickable integration cards](requirements/clickable-integration-cards.md)
- [Integration Enable/Disable Toggle & Nav Visibility](requirements/enable-disable-toggle.md)
- [External MCP Endpoint](requirements/external-mcp.md)
- [External Question Answering — authorized, discoverable, idempotent clarification resolution](requirements/external-question-answering.md)
- [Workspace GitHub Authentication](requirements/github-authentication.md)
- [GitHub PR Auto-Fix Conflicts](requirements/github-pr-auto-fix-conflicts.md)
- [GitHub PR Merge Queue](requirements/github-pr-merge-queue.md)
- [GitHub PR Merge Queue Recovery](requirements/github-pr-merge-queue-recovery.md)
- [GitHub task pull request sync coordination](requirements/github-task-pr-sync-coordination.md)
- [GitLab Integration](requirements/gitlab-integration.md)
- [GitLab MR Status Chip](requirements/gitlab-mr-status-chip.md)
- [GitLab MR Badge on the Sidebar and Tasks-List Rows](requirements/gitlab-mr-task-list-badges.md)
- [GitLab Workflow Sync](requirements/gitlab-workflow-sync.md)
- [Jira Watcher Task Prompts](requirements/jira-watcher-task-prompts.md)
- [Jira Ticket Status Filter](requirements/jira-status-filter.md)
- [Watcher Remote Base Branches](requirements/watcher-remote-base-branches.md)
- [MCP Tool Argument Validation](requirements/mcp-tool-argument-validation.md)
- [Pull request outcome attribution](requirements/pr-outcome-attribution.md)
- [Pull request link copy actions](requirements/pr-link-copy-actions.md)
- [Provider-Aware Review Automation Runtime](requirements/provider-aware-review-automation.md)
- [Slack Integration](requirements/slack.md)
### System design
- [External MCP Saved Prompt Reads](system-design/external-mcp-shared-prompts.md)
- [Azure DevOps Integration System Design Part 1](system-design/azure-devops-integration-01.md)
- [Azure DevOps Integration System Design Part 2](system-design/azure-devops-integration-02.md)
- [Bitbucket Connector Plugin System Design Part 1](system-design/bitbucket-plugin-01.md)
- [Bitbucket Connector Plugin System Design Part 2](system-design/bitbucket-plugin-02.md)
- [External Question Answering — authorized, discoverable, idempotent clarification resolution System Design Part 1](system-design/external-question-answering-01.md)
- [External Question Answering — authorized, discoverable, idempotent clarification resolution System Design Part 2](system-design/external-question-answering-02.md)
- [External Question Answering — authorized, discoverable, idempotent clarification resolution System Design Part 3](system-design/external-question-answering-03.md)
- [External Question Answering — authorized, discoverable, idempotent clarification resolution System Design Part 4](system-design/external-question-answering-04.md)
- [Workspace GitHub Authentication System Design Part 1](system-design/github-authentication-01.md)
- [Workspace GitHub Authentication System Design Part 2](system-design/github-authentication-02.md)
- [Workspace GitHub Authentication System Design Part 3](system-design/github-authentication-03.md)
- [GitHub PR Auto-Fix Conflicts](system-design/github-pr-auto-fix-conflicts.md)
- [GitHub PR Merge Queue](system-design/github-pr-merge-queue.md)
- [GitHub PR Merge Queue Recovery](system-design/github-pr-merge-queue-recovery.md)
- [GitHub task pull request sync coordination](system-design/github-task-pr-sync-coordination.md)
- [Pull request link copy actions](system-design/pr-link-copy-actions.md)
- [GitLab Integration System Design Part 1](system-design/gitlab-integration-01.md)
- [GitLab Integration System Design Part 2](system-design/gitlab-integration-02.md)
- [GitLab MR Status Chip System Design Part 1](system-design/gitlab-mr-status-chip-01.md)
- [GitLab MR Status Chip System Design Part 2](system-design/gitlab-mr-status-chip-02.md)
- [GitLab MR Status Chip System Design Part 3](system-design/gitlab-mr-status-chip-03.md)
- [GitLab MR Status Chip System Design Part 4](system-design/gitlab-mr-status-chip-04.md)
- [GitLab MR Status Chip System Design Part 5](system-design/gitlab-mr-status-chip-05.md)
- [GitLab MR Badge on the Sidebar and Tasks-List Rows System Design Part 1](system-design/gitlab-mr-task-list-badges-01.md)
- [GitLab MR Badge on the Sidebar and Tasks-List Rows System Design Part 2](system-design/gitlab-mr-task-list-badges-02.md)
- [GitLab MR Badge on the Sidebar and Tasks-List Rows System Design Part 3](system-design/gitlab-mr-task-list-badges-03.md)
- [Jira Watcher Task Prompts](system-design/jira-watcher-task-prompts.md)
- [Watcher Remote Base Branches](system-design/watcher-remote-base-branches.md)
## Migration record
Migration remains in progress while legacy source detail is extracted from the
canonical requirement and system-design documents above.
## Related systems
- [Auth](../auth/README.md): authenticates users and service requests.
- [Tasks](../tasks/README.md): owns the Kandev task receiving external work.
- [Plugins](../plugins/README.md): owns plugin-host integration contracts.