Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/skills/cracktro/slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ Editing: add, remove or move one row per slide in the same change as `deck.js`,
| GitHub-native governance | illustrative | Defaults and policy variables are set at enterprise, organization or repository scope and enforced with GitHub controls such as protected environments. |
| Operator-owned infrastructure | illustrative | Operators run agentic jobs on their own Linux runners, on Kubernetes, or in air-gapped networks with mirrored actions and container images. |
| GitHub App permissions | illustrative | A GitHub App installed on selected repositories mints short-lived scoped tokens, keeping the agent read-only and leaving writes to trusted safe-output jobs in each repository. |
| Multi-repo PRs | illustrative | One run checks out several repositories with a read-only GitHub App, the agent edits them without any token, and the safe-outputs job uses a second, write-capable GitHub App to open one pull request in each allowlisted repository. |
| OIDC token broker | illustrative | Experimental: a deployment-owned broker verifies a job's OIDC identity and returns a short-lived credential, so no long-lived secret is stored in the repository. |
| Push SDLC | illustrative | A task arrives with its own squad of human-led AI agents that join the developer's repository, pair with them, then step back and leave their decisions behind. |
| Connectors | illustrative | Experimental: a connector declares everything a third-party service offers; a workflow imports it and selects only the reads and writes it needs. |
Expand Down
104 changes: 104 additions & 0 deletions docs/public/cracktro/deck.js
Original file line number Diff line number Diff line change
Expand Up @@ -2630,6 +2630,9 @@
.otb .slide-head .l-grad .ch { background-image: linear-gradient(90deg, #79c0ff, #3fb950, #d29922, #79c0ff); }
.whg .slide-head .l-grad .ch { background-image: linear-gradient(90deg, #56d4dd, #ab7df8, #f0883e, #56d4dd); }
.xsv .ttl { transform-box: fill-box; transform-origin: left center; }
.xsv .mrp-c { fill: #e6edf3; font: 500 22px var(--mono); }
.xsv .mrp-t { fill: #f0f6fc; font: 700 36px "Mona Sans", sans-serif; }
.xsv .mrp-m { fill: #e6edf3; font: 500 22px var(--mono); }
.gap .cell.probe rect { stroke: #f0f6fc; stroke-width: 3; }

/* --- enterprise ready --- */
Expand Down Expand Up @@ -12802,6 +12805,107 @@
});
}

// Multi-repo PRs: one run checks out two repositories with a read-only GitHub App, the agent edits both without a
// token, and the safe-outputs job uses a second, write-capable App to open one pull request in each repository
{
resetIndex();
const BLUE = "#4493f8",
BLUE2 = "#79c0ff",
ORANGE = "#db6d28",
ORANGE2 = "#ffa657";
const ico = (n, x, y, sz, fill) => `<g transform="translate(${x - sz / 2},${y - sz / 2}) scale(${sz / 24})" fill="${fill}">${OCTI[n].map(d => `<path d="${d}"/>`).join("")}</g>`;
// abbreviated front matter: [text, role (r read · w write · p pull requests · "" none)]; "..." marks omitted details
const YAML = [
["checkout:", ""],
[" - repository: octo-org/api", "r"],
[" github-app: ...", "r"],
[" - ...", "r"],
["safe-outputs:", ""],
[" github-app: ...", "w"],
[" create-pull-request:", "p"],
[" allowed-repos: [...]", "p"],
[" max: 2", "p"],
];
const ROLE = { r: [BLUE, 1, 3], w: [ORANGE, 4, 6], p: ["#ab7df8", 3, 5] };
const LH = 36,
CY = 145,
TOP = CY + 88;
const yamlLine = (l, y) => {
const m = l.match(/^(\s*(?:- )?)([\w-]+:)(.*)$/);
if (!m) return `<text class="mrp-c" x="34" y="${y}" xml:space="preserve" style="fill:#9198a1">${l.replace(/ /g, "\u00a0")}</text>`;
const [, ind, key, val] = m;
return `<text class="mrp-c" x="34" y="${y}" xml:space="preserve">${ind.replace(/ /g, "\u00a0")}<tspan style="fill:${ind ? "#7ee787" : "#d2a8ff"}">${key}</tspan><tspan style="fill:${val.includes("...") ? "#9198a1" : "#a5d6ff"}">${xEsc(val)}</tspan></text>`;
};
let g = "";
// abbreviated front matter card with role bars and step highlights
g += `<rect class="card" x="0" y="${CY}" width="480" height="410" rx="16"/><text class="k" x="24" y="${CY + 34}">workflow.md · front matter</text><line x1="0" y1="${CY + 50}" x2="480" y2="${CY + 50}" stroke="#3d444d"/>`;
YAML.forEach(([l, r], i) => {
const y = TOP + i * LH;
if (r) {
const [c, s, e] = ROLE[r];
g += `<rect x="14" y="${y - 25}" width="4" height="${LH}" fill="${c}"/>`;
g += `<rect class="x" data-s="${s}" data-e="${e}" x="18" y="${y - 25}" width="448" height="${LH}" fill="${c}26"/>`;
}
g += yamlLine(l, y);
});
g += `<text x="456" y="${TOP + 2 * LH}" text-anchor="end" style="fill:${BLUE2};font-size:14px">READ APP</text><text x="456" y="${TOP + 5 * LH}" text-anchor="end" style="fill:${ORANGE2};font-size:14px">WRITE APP</text>`;
// the two GitHub Apps
const app = (y, c, c2, title, lines) =>
`<g data-s="0" style="--hc:${c}"><rect class="card" x="530" y="${y}" width="300" height="300" rx="14" style="stroke:${c};stroke-width:2"/>${ico("key", 572, y + 46, 34, c2)}<text class="k" x="604" y="${y + 52}" style="fill:${c2}">GitHub App</text><text class="mrp-t" x="554" y="${y + 124}">${title}</text>` +
lines.map((l, j) => `<text class="mrp-m" x="554" y="${y + 186 + j * 40}">${l}</text>`).join("") +
`</g>`;
g += app(0, BLUE, BLUE2, "Read App", ["read-only token", "checkouts + tools"]);
g += app(400, ORANGE, ORANGE2, "Write App", ["write token", "safe outputs only"]);
// agent job: one checkout per repository and a token-free agent
g += `<g data-s="1" style="--hc:${BLUE}"><rect class="card" x="880" y="0" width="820" height="300" rx="14" style="stroke:${BLUE}"/><text class="k" x="904" y="36" style="fill:${BLUE2}">agent job · read token</text>`;
[60, 176].forEach(
(y, i) => (g += `<rect x="904" y="${y}" width="330" height="96" rx="10" fill="#0d1117" stroke="${BLUE}88"/>${ico("repo", 942, y + 48, 30, BLUE2)}<text class="mrp-m" x="974" y="${y + 56}">octo-org/${i ? "web" : "api"}</text>`)
);
g += `</g>`;
g += `<g data-s="2" style="--hc:#f0f6fc"><rect x="1295" y="60" width="386" height="212" rx="10" fill="#0d1117" stroke="#9198a1" stroke-dasharray="8 6"/>${ico("lock", 1334, 112, 34, "#f0f6fc")}<text class="mrp-t" x="1370" y="124" style="font-size:30px">Sandboxed agent</text><text class="mrp-m" x="1320" y="186" style="fill:#f0f6fc">holds no token</text><text x="1320" y="232" style="font-size:19px">edits both checkouts</text></g>`;
g += `<g data-s="3" style="--hc:#ab7df8"><rect x="1318" y="326" width="340" height="48" rx="10" fill="#ab7df822" stroke="#ab7df8"/><text x="1488" y="357" text-anchor="middle" style="fill:#d2a8ff;font-size:19px">2 × create_pull_request</text></g>`;
// safe-outputs job: one pull request per repository
g += `<g data-s="4" style="--hc:${ORANGE}"><rect class="card" x="880" y="400" width="820" height="300" rx="14" style="stroke:${ORANGE}"/><text class="k" x="904" y="436" style="fill:${ORANGE2}">safe-outputs job · write token</text></g>`;
[
[904, "api", 4],
[1300, "web", 5],
].forEach(
([x, r, s]) =>
(g += `<g data-s="${s}" style="--hc:${ORANGE}"><rect x="${x}" y="490" width="376" height="186" rx="10" fill="#0d1117" stroke="${ORANGE}"/>${ico("pr", x + 40, 534, 34, ORANGE2)}<text class="mrp-t" x="${x + 74}" y="546" style="font-size:28px">Pull request</text><text class="mrp-m" x="${x + 24}" y="604">octo-org/${r}</text><text x="${x + 24}" y="646" style="fill:${ORANGE2};font-size:19px">opened by Write App</text></g>`)
);
// wiring and packets
g += `<path class="ln" d="M830 108 H904 M830 224 H904 M1234 108 H1295 M1234 224 H1295"/><path class="ln dash" d="M1488 272 V400"/><path class="ln" d="M830 462 H1488 M1092 462 V490 M1488 462 V490"/>`;
g += `<path data-p="1" data-c="${BLUE2}" d="M830 108 H904" fill="none"/><path data-p="1" data-c="${BLUE2}" d="M830 224 H904" fill="none"/>`;
g += `<path data-p="2" data-c="#f0f6fc" d="M1234 108 H1295" fill="none"/><path data-p="2" data-c="#f0f6fc" d="M1234 224 H1295" fill="none"/>`;
g += `<path data-p="3" data-c="#d2a8ff" d="M1488 272 V326" fill="none"/>`;
g += `<path data-p="4" data-c="${ORANGE2}" d="M830 462 H1092 V490" fill="none"/>`;
g += `<path data-p="5" data-c="${ORANGE2}" d="M830 462 H1488 V490" fill="none"/>`;
const svg = xSvg(g);
const N = 6,
EVERY = 1300,
HOLD = 4600;
const stage = xStage(svg, N, EVERY, HOLD, k => sfx.pop(k));
const el = h(
"section",
{ class: "slide gap" },
h("div", { class: "slide-head" }, h("div", { class: "kicker" }, "One run · two repositories · two GitHub Apps"), h("h2", {}, letters("Multi-repo "), letters("PRs", "l-grad"))),
svg,
h("div", { class: "xcap" }, h("b", {}, "Split the keys:"), h("span", {}, "Read App → checkouts"), h("span", {}, "agent holds no token"), h("span", {}, "Write App → safe outputs"), h("span", {}, "one PR per repo"))
);
slides.push({
group: "enterprise",
notes:
"Multi-repo PRs. One workflow run changes two repositories and opens one pull request in each, using two GitHub Apps with different jobs. The front matter is abbreviated: one checkout entry stands for each repository, and the dots stand for the App credentials and other details. The read App checks out octo-org/api and octo-org/web side by side and backs the agent's GitHub tools. Its tokens are minted for the agent job with read permissions only, and the checkouts are scrubbed of credentials before the sandboxed agent starts, so the agent edits both working trees while holding no token at all. It then emits two create_pull_request requests, one naming each repository; allowed-repos is the allowlist the agent may pick from, and max: 2 lets one run open two pull requests. After threat detection, the safe-outputs job mints a token from the second, write-capable App, re-creates the same checkout layout, applies each patch in its repository and opens the pull requests. The agent never sees either App's key, and only the safe-outputs job can write. Repositories, apps and pull requests are synthetic and illustrative.",
enter() {
stage.enter();
},
tick(t) {
stage.tick(t);
},
el,
});
}

// OIDC token broker (experimental, deployment-owned): a job presents GitHub's OIDC token, the broker checks it against
// its enrollment policy and returns a short-lived credential that is invalidated after the job; failure never falls back
{
Expand Down
4 changes: 3 additions & 1 deletion docs/tests/talk.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -573,13 +573,15 @@ test.describe("agentic engineering slides", () => {
test("places the enterprise tracing, access and event slides beside their neighbours", async ({ page }) => {
expect(slideNo("Distributed tracing")).toBe(slideNo("OpenTelemetry") + 1);
expect(slideNo("GitHub App permissions")).toBe(slideNo("Operator-owned infrastructure") + 1);
expect(slideNo("OIDC token broker")).toBe(slideNo("GitHub App permissions") + 1);
expect(slideNo("Multi-repo PRs")).toBe(slideNo("GitHub App permissions") + 1);
expect(slideNo("OIDC token broker")).toBe(slideNo("Multi-repo PRs") + 1);
expect(slideNo("Webhook gateway")).toBe(slideNo("Connectors") + 1);
const errors: string[] = [];
page.on("pageerror", error => errors.push(error.message));
const NEW: [string, string | null][] = [
["Distributed tracing", null],
["GitHub App permissions", null],
["Multi-repo PRs", null],
["OIDC token broker", "Experimental"],
["Webhook gateway", "Experimental"],
];
Expand Down
Loading