kandev/docs/plans/new-workspace-github-access-defaults/task-03-public-integration-documentation.md

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

id	title	status	wave	depends_on	plan	spec
03-public-integration-documentation	Public integration documentation	completed	3	02-workspace-github-defaults	plan.md	../../specs/integrations/requirements/github-authentication.md

Task 03: Public integration documentation

• Acceptance: Public docs identify executor credentials as the new-workspace default and managed workspace credentials as an explicit later choice.
• Acceptance: The docs explain operator-only active host gh auto-binding, disconnected fallback, remote-executor responsibility, and unchanged upgrade behavior without implying that a token is stored.
• Verification: Run both public-doc validators.

node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs

• Files likely touched: docs/public/integrations.md.
• Dependencies: Task 02.
• Parallelism: sequential; documentation must reflect the final green behavior.
• Inputs: amended GitHub-authentication spec, ADR-2026-08-02-new-workspace-github-access-defaults, and Task 02 results.
• Risks: Avoid saying Local/Worktree behavior also applies to Docker/SSH/cloud executors, and do not describe existing workspaces as migrated.
• Output contract: Summarize the doc changes and exact validator results; mark this task and the plan complete and synchronize ## Verification Results.

Results

• Updated docs/public/integrations.md to document executor inheritance as the new-workspace default, managed credentials as opt-in, operator/admin-only active gh auto-binding, soft disconnected fallback, remote-executor credential responsibility, and unchanged upgrades.
• Public-doc test suite: 58 passed.
• Public-doc validator: Validated 41 published docs pages.