kandev/docs/plans/bitbucket-plugin/task-01-design-package.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
01-design-package	Design package and task files	completed	0		plan.md	../../specs/integrations/requirements/bitbucket-plugin.md

Task 01: Design package and task files

Intent

Materialize approved Bitbucket connector behavior, generic host boundaries, ADRs, and dependency-scoped implementation packets without touching production code.

Dependencies

None.

Owned paths

• docs/specs/integrations/requirements/bitbucket-plugin.md
• docs/specs/INDEX.md
• docs/specs/plugins/requirements/plugins.md
• docs/decisions/2026-07-31-authenticated-plugin-actions.md
• docs/decisions/2026-07-31-plugin-repository-provider-extensions.md
• docs/decisions/2026-07-31-provider-neutral-git-credential-broker.md
• docs/decisions/INDEX.md
• docs/plans/bitbucket-plugin/
• docs/plans/plugins/GRPC-CONTRACT.md
• docs/plans/plugins/PLUGIN-API.md
• docs/plans/plugins/HOST-DATA-API.proto

Acceptance

1. Spec preserves Cloud+DC, API token/PAT+OAuth, full supported-capability parity, plugin-first boundaries, native Link/review hooks, and composer submission reauthorization.
2. Three ADRs and frozen contracts define generic reusable seams without Bitbucket API payloads in the host.
3. task-01 through task-13 declare dependencies, owned paths, acceptance, exact checks, and risks; indexes and relative links resolve.

Verification

git diff --check
rg -n 'Link → Bitbucket Pull Request|submit-time|reauthoriz|Cloud|Data Center' docs/specs/bitbucket-plugin docs/plans/bitbucket-plugin

Risks

Frozen contract drift can make later host/plugin tasks incompatible. Reconcile every contract amendment with the approved parent plan before implementation starts.