This is the preflight for the AI-assisted TechDocs assessment build
(spec: PR #363, section 16). The administrator/platform owner works
through the section 11 preconditions and records each answer here. These
are organization and repository settings, not files, so this item closes
with recorded answers rather than a PR.
The probe delegation (spec section 16, as amended by 09a92bf) starts
after this issue closes; it carries the platform observations build
step 1 used to hold. Locally drafted build steps, step 1 (workflow
labels) included, do not wait on this issue.
Preconditions (spec section 11)
Additions beyond section 16's list (flagged as such)
Spec references
Covers the section 16 preflight; preconditions from section 11; bound by
P-1 (human-gated) and HC-1 (write boundary: MCP and secrets are its two
documented widening mechanisms).
This is the preflight for the AI-assisted TechDocs assessment build
(spec: PR #363, section 16). The administrator/platform owner works
through the section 11 preconditions and records each answer here. These
are organization and repository settings, not files, so this item closes
with recorded answers rather than a PR.
The probe delegation (spec section 16, as amended by 09a92bf) starts
after this issue closes; it carries the platform observations build
step 1 used to hold. Locally drafted build steps, step 1 (workflow
labels) included, do not wait on this issue.
Preconditions (spec section 11)
not opted out (org Copilot policy).
Recorded state: verified 2026-08-13,
copilot-swe-agentis inthe repository's assignable actors (read-only GraphQL
suggestedActors, capabilityCAN_BE_ASSIGNED). Supportingevidence: cncf/mentoring's cloud-agent PRs #1527, #1631, #1668
(Dec 2025 to Feb 2026).
Recorded state:
MCP servers configured for cncf/techdocs. Platform defaults noted
(GitHub MCP server, read-only, scoped to this repository;
Playwright MCP server, localhost-only).
Recorded state:
agent during the build (delegation is permission-gated to write
access; P-1).
Recorded state: nate-double-u is the sole delegator during the
build and holds
ADMIN(verified 2026-08-13, read-only GraphQLviewerPermission). Anyone added later is confirmed then.by default at the org level; record the budget decision.
Recorded state: reviewed 2026-08-13 by nate-double-u; currently
unlimited for CNCF folks per the CNCF Copilot Enterprise
arrangement
(https://contribute.cncf.io/blog/2025/12/16/github-copilot-enterprise-for-maintainers/).
No per-org budget cap in effect; revisit if the arrangement
changes.
Additions beyond section 16's list (flagged as such)
environment named
copilot, or it is empty (section 11 secretspolicy).
Recorded state: the
copilotenvironment exists with zerosecrets and zero variables (verified 2026-08-13, read-only API,
names-only listing). Compliant; re-checked if an exception is
ever proposed.
.github/settings.yml(the fileshows drift from live labels, so sync looks inactive). The answer
decides whether step 1's labels apply on merge or by hand with
gh label create(HC-4 permits the by-hand fallback).Recorded state: installed (org-level installation of the
repository-settings app, listed on the repo's GitHub Apps page,
so it has access) but not syncing on this repository. File
changes from 2022-11-07 (60a8818) and 2026-02-06 (993afda) never
applied live. Cross-check: the same app works in cncf/mentoring,
where a 2026-06-25 commit (9d88251) recolored an existing label
and live matches the file exactly. Prime suspect here: this
file's three unquoted
#colors (YAML parses them as comments,color becomes null); mentoring's colors are un-prefixed and parse
fine. The 2022 failure predates that bug and stays unexplained.
Step 1 therefore reconciles the file to live before adding
labels: fixing the quoting likely wakes the app, and a real
declarative sync deletes any live label missing from the file.
Fallback to
gh label createif merge still applies nothing.Spec references
Covers the section 16 preflight; preconditions from section 11; bound by
P-1 (human-gated) and HC-1 (write boundary: MCP and secrets are its two
documented widening mechanisms).