diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index b8feb24..876295a 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "microsoft-events", "description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.", - "version": "1.0.6", + "version": "1.0.7", "author": { "name": "Microsoft" }, diff --git a/.github/plugin/plugin.json b/.github/plugin/plugin.json index efbfb48..6840641 100644 --- a/.github/plugin/plugin.json +++ b/.github/plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "microsoft-events", "description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.", - "version": "1.0.6", + "version": "1.0.7", "author": { "name": "Microsoft", "url": "https://www.microsoft.com" diff --git a/.github/workflows/m365-plugin.yml b/.github/workflows/m365-plugin.yml index 2b9e3ce..00d24da 100644 --- a/.github/workflows/m365-plugin.yml +++ b/.github/workflows/m365-plugin.yml @@ -2,7 +2,7 @@ name: M365 plugin # Builds the offline Microsoft 365 Copilot plugin app package (for Cowork) with live catalog data # and publishes it as release m365-v, marked Latest, so -# releases/latest/download/microsoft-build-m365.zip serves it. The M365 plugin has its own +# releases/latest/download/microsoft-events-m365.zip serves it. The M365 plugin has its own # version, separate from the plugin manifests, because catalog refreshes need new releases too. on: workflow_dispatch: @@ -27,7 +27,7 @@ concurrency: env: # Keep in sync with the atk install step in ci.yml. ATK_VERSION: 1.1.18 - ZIP_NAME: microsoft-build-m365.zip + ZIP_NAME: microsoft-events-m365.zip jobs: build: diff --git a/AGENTS.md b/AGENTS.md index 40b0001..ed237e2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ This repo packages the **Microsoft Events** assistant plugin and the `@microsoft The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shared product identity fields aligned across the manifests when changing the plugin name, description, version, author, repository, keywords, license, skills path, or MCP wiring. **Shared assets** used by the plugin ecosystems: -- `skills\microsoft-build\SKILL.md` — the active skill prompt +- `skills\microsoft-events\SKILL.md` — the active skill prompt - `.mcp.json` — Microsoft Learn MCP endpoint config - `cli\` — source for the `@microsoft/events-cli` package used by the skill @@ -17,10 +17,10 @@ The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shar ## Sync rules -- Event support is duplicated by design between the CLI and skill docs. When adding, removing, or renaming events, update `cli\src\config.ts`, the supported/default event guidance in `skills\microsoft-build\SKILL.md`, and affected tests/docs together. -- The offline Microsoft 365 Copilot plugin (Cowork) builds its SKILL.md from `skills\microsoft-build\SKILL.md`; there's no second copy to keep aligned. `cli\m365-skill\offline-overlay.md` holds the only Cowork-specific text: frontmatter keys to replace and a `## Session catalog access` section that uses only `node scripts/msevents.mjs` (no `npx`, network, or `refresh`). `SKILL_REWRITES` in `cli\scripts\build-m365-plugin.mjs` rewrites the remaining online steps, and the build fails when a rewrite stops matching or online wording (`npx`, catalog endpoints, `refresh`, "live catalog") is left, so `npm run smoke:m365` catches main-skill edits that need a matching update there. Changing the overlay or rewrites doesn't need a plugin version bump; the M365 plugin has its own version, entered when the M365 plugin workflow publishes a release. -- Treat `skills\microsoft-build\SKILL.md` as the product contract for event-session behavior. For Build, Ignite, or event-session work: default "Build" to `build-2026`, get session metadata from the live catalog through `msevents` or the endpoint, get SDK/API facts from Microsoft Learn MCP, and never invent session IDs, speakers, schedules, or links. -- Versioning gate: any meaningful `skills\microsoft-build\SKILL.md` change (agent behavior, commands/examples agents may follow, supported/default events, CLI/MCP/catalog usage, or user-facing workflow guidance) must bump both versioned plugin manifests to the same value; patch bumps are fine for guidance-only changes. +- Event support is duplicated by design between the CLI and skill docs. When adding, removing, or renaming events, update `cli\src\config.ts`, the supported/default event guidance in `skills\microsoft-events\SKILL.md`, and affected tests/docs together. +- The offline Microsoft 365 Copilot plugin (Cowork) builds its SKILL.md from `skills\microsoft-events\SKILL.md`; there's no second copy to keep aligned. `cli\m365-skill\offline-overlay.md` holds the only Cowork-specific text: frontmatter keys to replace and a `## Session catalog access` section that uses only `node scripts/msevents.mjs` (no `npx`, network, or `refresh`). `SKILL_REWRITES` in `cli\scripts\build-m365-plugin.mjs` rewrites the remaining online steps, and the build fails when a rewrite stops matching or online wording (`npx`, catalog endpoints, `refresh`, "live catalog") is left, so `npm run smoke:m365` catches main-skill edits that need a matching update there. Changing the overlay or rewrites doesn't need a plugin version bump; the M365 plugin has its own version, entered when the M365 plugin workflow publishes a release. +- Treat `skills\microsoft-events\SKILL.md` as the product contract for event-session behavior. For Build, Ignite, or event-session work: default "Build" to `build-2026`, get session metadata from the live catalog through `msevents` or the endpoint, get SDK/API facts from Microsoft Learn MCP, and never invent session IDs, speakers, schedules, or links. +- Versioning gate: any meaningful `skills\microsoft-events\SKILL.md` change (agent behavior, commands/examples agents may follow, supported/default events, CLI/MCP/catalog usage, or user-facing workflow guidance) must bump both versioned plugin manifests to the same value; patch bumps are fine for guidance-only changes. - PR review gate: GitHub Copilot/code reviewers should flag meaningful `SKILL.md` changes without synced plugin version bumps, and any plugin version drift. Typo/format-only skill edits may skip the bump only when the PR explicitly says so. - Keep README install/client guidance aligned with plugin manifest, skill, MCP, or CLI behavior changes. @@ -44,7 +44,7 @@ npm run build:m365 -- --plugin-version 1.0.7 --package `npm run smoke:live` hits the live catalog; CI only runs it outside pull requests. `npm run build:m365` also downloads live catalogs and writes the M365 plugin to `out\m365-plugin` (git-ignored); `--package` uses the `atk` CLI to build `out\m365-plugin-app\appPackage\build\appPackage.zip`. `smoke:m365 -- --package` also needs `atk`: it builds the zip from the fixture, unzips it and runs the offline checks on the unzipped skill, as CI does. Never commit generated snapshot data. -`.github\workflows\m365-plugin.yml` publishes the M365 plugin. It runs manually on `main` with a version input, which must be `x.y.z` and higher than every `m365-v*` tag; the M365 plugin is versioned separately from the plugin manifests. An optional events input (space-separated event IDs, empty for all) is passed to the build as `--event` flags. It creates release `m365-v` with `microsoft-build-m365.zip` attached and marks it Latest, which the README links through `releases/latest/download/`, so don't mark other releases as Latest. Keep the build job read-only; only the job that creates the release gets `contents: write`. +`.github\workflows\m365-plugin.yml` publishes the M365 plugin. It runs manually on `main` with a version input, which must be `x.y.z` and higher than every `m365-v*` tag; the M365 plugin is versioned separately from the plugin manifests. An optional events input (space-separated event IDs, empty for all) is passed to the build as `--event` flags. It creates release `m365-v` with `microsoft-events-m365.zip` attached and marks it Latest, which the README links through `releases/latest/download/`, so don't mark other releases as Latest. Keep the build job read-only; only the job that creates the release gets `contents: write`. The M365 plugin bundles `cli\src\index.ts` (the whole CLI) with esbuild. Its banner sets `MSEVENTS_OFFLINE=1` and points `MSEVENTS_CACHE_DIR` at the bundled `data\` folder, and the version comes from a build-time `__MSEVENTS_VERSION__` constant because the bundle has no `package.json`. Keep offline mode free of network calls and cache writes; `npm run smoke:m365` checks this with read-only data. diff --git a/Build-CLI.png b/Build-CLI.png index e932d7c..f9f304a 100644 Binary files a/Build-CLI.png and b/Build-CLI.png differ diff --git a/README.md b/README.md index a349b0e..886f3e9 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ -# Microsoft Build CLI +# Microsoft Events CLI -A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that connects your local project to the Microsoft Build session catalog. It reads your dependencies, finds relevant sessions, and helps you act on what you learn — all from your terminal. +A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that connects your local project to Microsoft event session catalogs. It reads your dependencies, finds relevant sessions, and helps you act on what you learn — all from your terminal. -![Build CLI](Build-CLI.png) +![Microsoft Events CLI](Build-CLI.png) ## Quick Start @@ -16,10 +16,10 @@ A [GitHub Copilot CLI](https://github.com/features/copilot/cli/) skill that conn ``` 3. Try: ``` - What Build sessions are relevant to my project? + What Ignite 2026 sessions are relevant to my project? ``` -The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and other dependency files, maps them to Microsoft products, and searches the live Build 2026 session catalog. +The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and other dependency files, maps them to Microsoft products, and searches live event catalogs (default: Ignite 2026). ## Requirements @@ -30,36 +30,38 @@ The skill reads `package.json`, `requirements.txt`, `.csproj`, `go.mod`, and oth 📺 **[Watch the overview video](https://www.youtube.com/watch?v=gm8gKtrd3po)** to see it in action. -### Before Build — plan your schedule +### Before an event — plan your schedule | Ask the skill to… | Example | |------------------------------------------|-------------------------------------------------------| -| Find sessions for your project | *"What Build sessions should I attend?"* | -| See what's new for your tech stack | *"What's new at Build for Azure Cosmos DB?"* | -| Look up a session by code | *"Tell me about session BRK155"* | +| Build a personalized session path | *"Find sessions for me for an IT admin focused on Entra, Intune, and Defender."* | +| See what's new for your stack | *"What's new for me at Ignite with Node.js, TypeScript, Functions, and Cosmos DB?"* | +| Look up a specific session | *"Tell me about session BRK155."* | -### During Build — capture what matters +### During an event — capture what matters | Ask the skill to… | Example | |------------------------------------------|-------------------------------------------------------| -| Log notes tied to a session | *"Log a note from session BRK155: great agent demo"* | -| Get next steps after a session | *"What should I do after session BRK155?"* | +| Log notes tied to a session | *"Log a note from session BRK155: key governance steps and rollout risks."* | +| Get immediate follow-up actions | *"What should I do after session BRK155?"* | +| Build a supplemental learning path | *"Build a supplemental learning path for BRK155 and BRK223."* | -### After Build — ship what you learned +### After an event — ship what you learned | Ask the skill to… | Example | |------------------------------------------|-------------------------------------------------------| -| Scaffold a project from a session | *"Scaffold a project from session BRK155"* | -| See what changed for your project | *"What changed at Build for my project?"* | +| Create an operational checklist | *"Create an operational learning checklist from BRK155 for our IT admin team."* | +| Scaffold from a technical session | *"Scaffold a project from session BRK155."* | +| Ground recommendations in your context | *"Ground recommendations in my authorized context and show traceability."* | ## How It Works -The skill is a thin layer over the **live Build 2026 catalog API** — no stale data, no manual updates. For SDK docs and code samples, it falls back to the [Microsoft Learn MCP Server](https://learn.microsoft.com/training/support/mcp). +The skill is a thin layer over **live Microsoft event session catalogs** — no stale data, no manual updates. For SDK docs and code samples, it falls back to the [Microsoft Learn MCP Server](https://learn.microsoft.com/training/support/mcp). -Session results are a starting point. For broad topics, ask the agent to refine (*"show me more Foundry sessions about observability"*) or browse the full catalog at [build.microsoft.com/sessions](https://build.microsoft.com/sessions). +Session results are a starting point. For broad topics, ask the agent to refine (*"show me more Foundry sessions about observability"*) or browse full catalogs at [ignite.microsoft.com/sessions](https://ignite.microsoft.com/sessions) and [build.microsoft.com/sessions](https://build.microsoft.com/sessions). > [!NOTE] -> Build-CLI targets **Build 2026** and also indexes past events (Build 2025, Ignite 2025). It supports any future event that follows the same catalog endpoint pattern. It is not a replacement for the event app or session browser — it's a developer-first complement to them. +> This skill defaults to **Ignite 2026** and also supports Build 2026. It is not a replacement for the event app or session browser — it's a developer and IT-pro complement to them. ## Supported Clients @@ -67,13 +69,13 @@ Session results are a starting point. For broad topics, ask the agent to refine |--------|---------------| | GitHub Copilot CLI | `/plugin install microsoft/Build-CLI` then `/restart` | | VS Code | Open Extensions (Ctrl+Shift+X), search `@agentPlugins microsoft-events`, and install | -| Visual Studio 2026 | Copy `skills/microsoft-build/` to a [supported skill location](https://learn.microsoft.com/visualstudio/ide/copilot-agent-skills) | +| Visual Studio 2026 | Copy `skills/microsoft-events/` to a [supported skill location](https://learn.microsoft.com/visualstudio/ide/copilot-agent-skills) | | Claude Code | `/plugin marketplace add microsoft/Build-CLI` then `/plugin install microsoft-events@microsoft-events-marketplace` | -| Microsoft 365 Copilot Cowork | Download [`microsoft-build-m365.zip`](https://github.com/microsoft/Build-CLI/releases/latest/download/microsoft-build-m365.zip) from the latest release and upload it in Cowork (**Customize** → **Plugins** → **Add plugin** → **Only you**). To build your own offline plugin, see [cli/README.md](cli/README.md#microsoft-365-copilot-plugin-offline) | +| Microsoft 365 Copilot Cowork | Download [`microsoft-events-m365.zip`](https://github.com/microsoft/Build-CLI/releases/latest/download/microsoft-events-m365.zip) from the latest release and upload it in Cowork (**Customize** → **Plugins** → **Add plugin** → **Only you**). To build your own offline plugin, see [cli/README.md](cli/README.md#microsoft-365-copilot-plugin-offline) | ## Scope and Limitations -- **Event-scoped:** Targets Build 2026, with Build 2025 and Ignite 2025 also available. The architecture supports any event that uses the same catalog endpoints. +- **Event-scoped:** Defaults to Ignite 2026, with Build 2026 also available. The architecture supports any event that uses the same catalog endpoints. - **Dependency-driven:** Recommendations are only as good as the dependency files in your project root. If your project doesn't have a manifest file, tell the skill your stack directly. - **Not offline:** Requires network access to query the catalog and Learn MCP server. The M365 plugin is the exception: it searches catalog data bundled at build time, which goes stale until you install a newer release or rebuild it. diff --git a/cli/README.md b/cli/README.md index 51dca16..d80fb2a 100644 --- a/cli/README.md +++ b/cli/README.md @@ -110,7 +110,7 @@ node dist/index.js --help Microsoft 365 Copilot Cowork runs skill scripts in a sandbox with Node.js but no network access, so `npx -y @microsoft/events-cli` can't run there. `npm run build:m365` produces a Cowork-ready plugin that ships the whole `msevents` CLI as one bundled file, `scripts/msevents.mjs`, together with a frozen snapshot of its cache in `data/`. The bundle always runs in offline mode (`MSEVENTS_OFFLINE`) with its cache folder set to `../data/`, so search results match `msevents` for the same catalog data. -Each [M365 plugin release](https://github.com/microsoft/Build-CLI/releases) (tagged `m365-v`) includes a prebuilt `microsoft-build-m365.zip` (see [Publishing the M365 plugin](#publishing-the-m365-plugin)). To build your own: +Each [M365 plugin release](https://github.com/microsoft/Build-CLI/releases) (tagged `m365-v`) includes a prebuilt `microsoft-events-m365.zip` (see [Publishing the M365 plugin](#publishing-the-m365-plugin)). To build your own: ```bash cd cli @@ -133,15 +133,15 @@ out/ ├── m365-plugin/ # plugin folder │ ├── .claude-plugin/plugin.json │ ├── .mcp.json -│ └── skills/microsoft-build/ -│ ├── SKILL.md # skills/microsoft-build/SKILL.md, rewritten for offline use +│ └── skills/microsoft-events/ +│ ├── SKILL.md # skills/microsoft-events/SKILL.md, rewritten for offline use │ ├── scripts/msevents.mjs # the msevents CLI, bundled and locked to offline mode │ └── data/ # frozen cache: -sessions.json and -meta.json └── m365-plugin-app/ # with --package: atk project └── appPackage/build/appPackage.zip ``` -The Cowork SKILL.md is built from the repo skill, `skills/microsoft-build/SKILL.md`, so both stay in sync. The repo skill tells the agent to use `npx`, the catalog endpoints and `refresh`, none of which work in Cowork's offline sandbox, so the build: +The Cowork SKILL.md is built from the repo skill, `skills/microsoft-events/SKILL.md`, so both stay in sync. The repo skill tells the agent to use `npx`, the catalog endpoints and `refresh`, none of which work in Cowork's offline sandbox, so the build: - replaces the `## Session catalog access` section and the `compatibility`, `metadata` and `allowed-tools` frontmatter with [`cli/m365-skill/offline-overlay.md`](m365-skill/offline-overlay.md), filling in the snapshot date and bundled events; - rewrites the remaining online steps (`npx -y @microsoft/events-cli` becomes `node scripts/msevents.mjs`, "Without CLI" fallbacks and catalog URLs are removed) with `SKILL_REWRITES` in `scripts/build-m365-plugin.mjs`; @@ -149,13 +149,13 @@ The Cowork SKILL.md is built from the repo skill, `skills/microsoft-build/SKILL. When you edit the repo skill, run `npm run smoke:m365`; CI runs it too. The result is about 28,000 characters (roughly 7,000 tokens), above the ~5,000 tokens Cowork recommends for a skill body but within what it accepts. -To install, upload the zip (`appPackage.zip` from a local build, or `microsoft-build-m365.zip` from a release) in Cowork (**Customize** → **Plugins** → **Add plugin** → **Only you**), or sideload it with `atk install --file-path --scope Personal`. Plugin skills appear only in new conversations. +To install, upload the zip (`appPackage.zip` from a local build, or `microsoft-events-m365.zip` from a release) in Cowork (**Customize** → **Plugins** → **Add plugin** → **Only you**), or sideload it with `atk install --file-path --scope Personal`. Plugin skills appear only in new conversations. The snapshot doesn't update itself. Install a newer release, or rebuild with a higher `--plugin-version` and reinstall, to pick up catalog changes. `npm run smoke:m365` builds from a fixture offline, makes the data read-only, and checks that the bundle's output matches `msevents`. With `-- --package` (needs `atk`), it also builds the app package zip, unzips it, checks that its skill files match the plugin folder, and runs the same checks against the unzipped skill; CI runs it this way. ### Publishing the M365 plugin -The [M365 plugin workflow](../.github/workflows/m365-plugin.yml) builds and publishes the plugin. Run **M365 plugin** from the **Actions** tab on `main` and enter a version. It runs `npm run build:m365 -- --package` with live catalog data, then creates a release tagged `m365-v` with `microsoft-build-m365.zip` attached and marks it **Latest**, so [`releases/latest/download/microsoft-build-m365.zip`](https://github.com/microsoft/Build-CLI/releases/latest/download/microsoft-build-m365.zip) serves it. +The [M365 plugin workflow](../.github/workflows/m365-plugin.yml) builds and publishes the plugin. Run **M365 plugin** from the **Actions** tab on `main` and enter a version. It runs `npm run build:m365 -- --package` with live catalog data, then creates a release tagged `m365-v` with `microsoft-events-m365.zip` attached and marks it **Latest**, so [`releases/latest/download/microsoft-events-m365.zip`](https://github.com/microsoft/Build-CLI/releases/latest/download/microsoft-events-m365.zip) serves it. - **Version:** the M365 plugin is versioned separately from the plugin manifests, because a catalog refresh needs a new release even without code changes. Enter `x.y.z`, higher than the last `m365-v*` release; Cowork only updates an installed plugin to a higher version. - **Events:** leave the events field empty to bundle every supported event, or enter event IDs separated by spaces, such as `build-2026 ignite-2026`, to bundle only those. Use it when an event's catalog can't be downloaded, because the build fails if any requested event fails. diff --git a/cli/m365-skill/offline-overlay.md b/cli/m365-skill/offline-overlay.md index b84e682..9d686fc 100644 --- a/cli/m365-skill/offline-overlay.md +++ b/cli/m365-skill/offline-overlay.md @@ -1,6 +1,6 @@ --- # Offline changes for the M365 plugin's SKILL.md. `npm run build:m365` builds that SKILL.md from -# skills/microsoft-build/SKILL.md: each key here replaces the same frontmatter key (an empty value +# the repository's skill: each key here replaces the same frontmatter key (an empty value # removes it), and the body below replaces the "## Session catalog access" section. The build # script rewrites the rest of the skill for offline use; see SKILL_REWRITES in # cli/scripts/build-m365-plugin.mjs. @@ -11,7 +11,7 @@ compatibility: >- come from the Microsoft Learn MCP Server or the agent's built-in web tools. metadata: author: Microsoft Learn partnerships team - domain: microsoft-build + domain: "{{SKILL_NAME}}" snapshot: "{{SNAPSHOT_DATE}}" msevents: "{{CLI_VERSION}}" allowed-tools: diff --git a/cli/scripts/build-m365-plugin.mjs b/cli/scripts/build-m365-plugin.mjs index 7e90f7e..9fb0910 100644 --- a/cli/scripts/build-m365-plugin.mjs +++ b/cli/scripts/build-m365-plugin.mjs @@ -1,11 +1,11 @@ // Builds the Microsoft 365 Copilot plugin (a Claude-format plugin folder for Cowork) with an offline -// session snapshot: skills/microsoft-build/{SKILL.md, scripts/msevents.mjs, data/-*.json}. +// session snapshot: skills//{SKILL.md, scripts/msevents.mjs, data/-*.json}. // scripts/msevents.mjs is the whole msevents CLI bundled into one file. Its banner turns on // offline mode (MSEVENTS_OFFLINE) and points the cache at ../data, so data/ is a frozen cache. -// SKILL.md is the repo skill (skills/microsoft-build/SKILL.md) rewritten for offline use with +// SKILL.md is the repo skill rewritten for offline use with // cli/m365-skill/offline-overlay.md. Run through `npm run build:m365` so dist/ is up to date. import { execFile } from 'node:child_process'; -import { existsSync } from 'node:fs'; +import { existsSync, readdirSync } from 'node:fs'; import { mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises'; import { tmpdir } from 'node:os'; import { delimiter, dirname, isAbsolute, join, relative, resolve } from 'node:path'; @@ -17,22 +17,29 @@ import { KNOWN_EVENTS } from '../dist/config.js'; const execFileAsync = promisify(execFile); const cliRoot = fileURLToPath(new URL('..', import.meta.url)); const repoRoot = resolve(cliRoot, '..'); -const SKILL_NAME = 'microsoft-build'; +const skillRoot = join(repoRoot, 'skills'); +const skillNames = readdirSync(skillRoot, { withFileTypes: true }) + .filter((entry) => entry.isDirectory() && existsSync(join(skillRoot, entry.name, 'SKILL.md'))) + .map((entry) => entry.name); +if (skillNames.length !== 1) { + throw new Error(`Expected exactly one skill folder with SKILL.md under ${skillRoot}; found ${skillNames.length}`); +} +const SKILL_NAME = skillNames[0]; const SCRIPT_FILE = 'msevents.mjs'; const MB = 1024 * 1024; // Cowork limits for files that ship next to SKILL.md. const COMPANION_LIMITS = { files: 20, fileBytes: 5 * MB, totalBytes: 10 * MB }; const SKILL_DESCRIPTION_MAX_CHARS = 1024; -const SKILL_SOURCE = join(repoRoot, 'skills', SKILL_NAME, 'SKILL.md'); +const SKILL_SOURCE = join(skillRoot, SKILL_NAME, 'SKILL.md'); const SKILL_OVERLAY = join(cliRoot, 'm365-skill', 'offline-overlay.md'); // The repo skill section that the overlay's body replaces. const SKILL_SECTION = '## Session catalog access'; // Rewrites that turn the repo skill's online steps into offline ones. Each one must match, so a -// wording change in skills/microsoft-build/SKILL.md fails the build until this list is updated. +// wording change in the source SKILL.md fails the build until this list is updated. const SKILL_REWRITES = [ { - find: /Uses the msevents CLI for fast local search and\s+Learn MCP Server for docs\./, + find: /Uses the msevents CLI for fast local search and\s+Learn MCP Server for\s+docs\./, replace: 'Searches session catalogs bundled with this skill and uses Microsoft Learn for docs.', }, { find: 'event ID and endpoint from', replace: 'event ID from' }, @@ -507,6 +514,7 @@ async function main() { const snapshotDate = collected.map(({ meta }) => meta.fetchedAt).sort()[0].slice(0, 10); const skill = buildSkill(await readFile(SKILL_SOURCE, 'utf8'), await readFile(SKILL_OVERLAY, 'utf8'), { + SKILL_NAME, SNAPSHOT_DATE: snapshotDate, CLI_VERSION: cliVersion, SNAPSHOT_EVENTS: collected diff --git a/cli/scripts/smoke-m365-plugin.mjs b/cli/scripts/smoke-m365-plugin.mjs index ed13a18..b35d96c 100644 --- a/cli/scripts/smoke-m365-plugin.mjs +++ b/cli/scripts/smoke-m365-plugin.mjs @@ -16,6 +16,7 @@ const commandTimeoutMs = 60_000; const eventId = 'build-2025'; const isWindows = process.platform === 'win32'; const { values: options } = parseArgs({ options: { package: { type: 'boolean' } } }); +const sourceSkillsDir = join(cliRoot, '..', 'skills'); function assert(condition, message) { if (!condition) throw new Error(message); @@ -44,6 +45,11 @@ async function listFiles(dir) { .sort(); } +const sourceSkillDirs = (await readdir(sourceSkillsDir, { withFileTypes: true })) + .filter((entry) => entry.isDirectory()); +assert(sourceSkillDirs.length === 1, `Expected one source skill folder, found ${sourceSkillDirs.length}`); +const skillName = sourceSkillDirs[0].name; + // Windows' built-in tar (bsdtar) reads zip files; a Git Bash tar earlier on PATH may not. async function unzip(zip, dir) { await mkdir(dir, { recursive: true }); @@ -58,9 +64,9 @@ const root = await mkdtemp(join(tmpdir(), 'msevents-m365-smoke-')); const cacheDir = join(root, 'cache'); const emptyCacheDir = join(root, 'empty-cache'); const pluginDir = join(root, 'plugin'); -const builtSkillDir = join(pluginDir, 'skills', 'microsoft-build'); +const builtSkillDir = join(pluginDir, 'skills', skillName); const unzippedDir = join(root, 'unzipped'); -const skillDir = options.package ? join(unzippedDir, 'skills', 'microsoft-build') : builtSkillDir; +const skillDir = options.package ? join(unzippedDir, 'skills', skillName) : builtSkillDir; const dataDir = join(skillDir, 'data'); const workDir = join(root, 'work'); const noNetwork = join(root, 'no-network.mjs'); @@ -101,8 +107,8 @@ try { await unzip(join(`${pluginDir}-app`, 'appPackage', 'build', 'appPackage.zip'), unzippedDir); const appManifest = JSON.parse(await readFile(join(unzippedDir, 'manifest.json'), 'utf8')); assert( - appManifest.agentSkills?.some((s) => s.folder === './skills/microsoft-build'), - 'Expected the app package manifest to register skills/microsoft-build', + appManifest.agentSkills?.some((s) => s.folder === `./skills/${skillName}`), + `Expected the app package manifest to register skills/${skillName}`, ); const builtFiles = await listFiles(builtSkillDir); const packedFiles = await listFiles(skillDir); @@ -128,7 +134,7 @@ try { assert(!text.includes('{{'), 'SKILL.md has unfilled placeholders'); assert(text.includes('2026-01-01'), 'Expected SKILL.md to show the snapshot date from the cache meta file'); assert(text.includes(`| \`${eventId}\` | ${sessions.length} |`), 'Expected SKILL.md to list the bundled event'); - const repoSkill = (await readFile('../skills/microsoft-build/SKILL.md', 'utf8')).replace(/\r\n?/g, '\n'); + const repoSkill = (await readFile(join(sourceSkillsDir, skillName, 'SKILL.md'), 'utf8')).replace(/\r\n?/g, '\n'); for (const heading of repoSkill.match(/^## .+$/gm)) { assert(text.includes(`\n${heading}\n`), `Expected SKILL.md to keep the repo skill's "${heading}" section`); } diff --git a/skills/microsoft-build/SKILL.md b/skills/microsoft-events/SKILL.md similarity index 61% rename from skills/microsoft-build/SKILL.md rename to skills/microsoft-events/SKILL.md index 945e699..a1f611c 100644 --- a/skills/microsoft-build/SKILL.md +++ b/skills/microsoft-events/SKILL.md @@ -1,13 +1,14 @@ --- -name: microsoft-build +name: microsoft-events description: >- - Your companion for Microsoft Build 2026. Helps you find sessions relevant to - your project, discover what's new for your tech stack, scaffold projects from - sessions, and plan your event schedule. Activate when users mention sessions, - schedule, what's new, Build, Ignite, AI Tour, Microsoft event, conference, or - reference a session code (BRK, DEM, LAB, KEY). Also supports Ignite 2025 and - Build 2025 session catalogs. Uses the msevents CLI for fast local search and - Learn MCP Server for docs. + Your companion for Microsoft events, defaulting to Ignite 2026. Helps you + find sessions relevant to your project, discover what's new for your tech + stack, scaffold projects from sessions, and plan your event schedule. Activate + when users mention sessions, schedule, what's new, Build, Ignite, + Microsoft event, conference, or reference a session code (BRK, DEM, LAB, KEY, + LTG, THR). Supports Ignite 2026 and Build 2026 + catalogs. Uses the msevents CLI for fast local search and Learn MCP Server for + docs. license: Apache-2.0 compatibility: >- Prefers the msevents CLI (`npx -y @microsoft/events-cli`) for session catalog @@ -17,15 +18,15 @@ compatibility: >- tools are unavailable, falls back to the mslearn CLI (`npx @microsoft/learn-cli`). No Azure subscription required. metadata: - author: Microsoft Learn partnerships team - version: "0.5" - domain: microsoft-build + author: Microsoft Learn team + version: "0.6" + domain: microsoft-events allowed-tools: microsoft_docs_search microsoft_docs_fetch microsoft_code_sample_search --- -# Microsoft Build CLI +# Microsoft Events CLI -> This skill supports multiple Microsoft events. Build 2026 is the default. When the user asks about a different event, use the appropriate event ID and endpoint from the table below. +> This skill supports multiple Microsoft events. Ignite 2026 is the default. When the user asks about a different event, use the appropriate event ID and endpoint from the table below. ## Event context @@ -33,34 +34,55 @@ allowed-tools: microsoft_docs_search microsoft_docs_fetch microsoft_code_sample_ | Setting | Value | |---------|-------| -| Event | Build 2026 | -| Event ID | `build-2026` | -| Dates | June 2-3, 2026 | -| Location | San Francisco, CA | -| Timezone | Pacific Daylight Time (PDT, UTC-7) | -| Catalog endpoint | `https://aka.ms/build2026-session-info` | -| News & Announcements | `https://aka.ms/build2026-news` | -| Default CLI flag | `--event build-2026` | +| Event | Ignite 2026 | +| Event ID | `ignite-2026` | +| Dates | November 17-20, 2026 (optional pre-day: November 16) | +| Location | San Francisco, CA (Moscone Center) | +| Timezone | Pacific Time (America/Los_Angeles) | +| Catalog endpoint | `https://aka.ms/ignite2026-session-info` | +| News & Announcements | Check Key resources; if missing, search `news.microsoft.com` | +| Default CLI flag | `--event ignite-2026` | ### Supported events | Event | Event ID | Catalog Endpoint | Location | Timezone | |-------|----------|-----------------|----------|----------| +| Ignite 2026 | `ignite-2026` | `https://aka.ms/ignite2026-session-info` | San Francisco, CA (Moscone Center) | PT (America/Los_Angeles) | | Build 2026 | `build-2026` | `https://aka.ms/build2026-session-info` | San Francisco, CA | PDT (UTC-7) | -| Ignite 2025 | `ignite-2025` | `https://aka.ms/ignite2025-session-info` | Chicago, IL | CST (UTC-6) | -| Build 2025 | `build-2025` | `https://aka.ms/build2025-session-info` | Seattle, WA | PDT (UTC-7) | + +### Recognized event names (not yet configured) + +| Event name | Status | Behavior | +|---|---|---| +| Frontier Tour | Recognized, not configured | Recognize the event name, but do not search or return event facts. | + +For recognized-but-not-configured event names, never invent dates, locations, sessions, schedule, or availability. ### Time display -Always present session times in the event's local timezone (e.g., "2:30 PM PDT" for Build 2026 in San Francisco). If `startDateTime` is null for an upcoming event, note that day assignments aren't available yet and show time slots only. +Always present session times in the event's local timezone (e.g., "2:30 PM PDT" when the event timezone is PDT). If `startDateTime` is null for an upcoming event, note that day assignments aren't available yet and show time slots only. + +When the user mentions a specific event by name, use its event ID for CLI commands (`--event `) and its endpoint for direct fetch. If no event is specified, default to Ignite 2026. + +Use these values throughout. CLI commands should include `--event ignite-2026` by default unless the user specifies another event. + +### Event and content availability -When the user mentions a specific event by name, use its event ID for CLI commands (`--event `) and its endpoint for direct fetch. If no event is specified, default to Build 2026. +- A configured catalog can represent upcoming, current, or historical content. Do not infer lifecycle state from catalog presence alone. +- Use catalog fields to distinguish scheduled, live, recorded, on-demand, self-paced, and unavailable content. +- For upcoming sessions, describe them as scheduled and do not imply recordings, transcripts, or replay unless explicitly indicated. +- Treat missing availability fields as unavailable or unknown. Do not upgrade availability based on assumptions. -Use these values throughout. When the skill says "Build," it means Build 2026. CLI commands should include `--event build-2026` by default unless the user specifies another event. +### Schedule authority -Helps developers find Build sessions relevant to their projects, discover what's new for their tech stack, scaffold projects from session content, and plan their Build schedule — all based on what they're actually building. +- Treat `startDateTime` and `endDateTime` as UTC when present. +- Treat `TimeSlot` as display text only, not timezone authority. +- Convert times only when timezone authority is explicit (catalog-provided or user-provided IANA timezone/UTC offset). +- If UTC boundaries conflict with `TimeSlot`, preserve both and flag the conflict; do not reconcile. -The "what's new for my project" workflow works year-round — Learn MCP Server always has current documentation, SDK updates, and what's-new pages. During Build, the session catalog adds session recommendations on top of the documentation layer. +Helps developers and IT pros find event sessions relevant to their projects, discover what's new for their tech stack, scaffold projects from session content, and plan their event schedule — all based on what they're actually building. + +The "what's new for me" workflow works year-round — Learn MCP Server always has current documentation, SDK updates, and what's-new pages. During active events, the session catalog adds session recommendations on top of the documentation layer. Two live data sources, no static files: @@ -69,20 +91,29 @@ Two live data sources, no static files: > Golden rule: session metadata comes from the live catalog (via CLI or endpoint); SDK docs, API references, and code samples come from Learn MCP Server. Never fabricate session IDs, speaker names, or schedule data. +## Source boundary + +- **Catalog facts**: session IDs, titles, abstracts, speakers, schedules, locations, formats, availability, and links. +- **Learn facts**: current product, SDK/API behavior, lifecycle, implementation, quickstart, and tutorial facts. +- **Authorized context**: project files, architecture, policies, role, technologies, interests, and learning goals the user explicitly authorizes. +- **Agent judgment**: relevance categories, comparisons, suggested learning order, and next-step recommendations. + +For recommendations, clearly separate facts from judgment and cite the concrete signal behind each recommendation. + ## When to use this skill Activate when the user: -- Mentions sessions, schedule, or anything about Build, Ignite, or AI Tour +- Mentions sessions, schedule, or anything about Build or Ignite - Asks about a Microsoft flagship event or conference - Asks what's new for their project or tech stack - Asks what changed in their dependencies or what updates are relevant to their code - Wants to find sessions relevant to their work - Asks to scaffold or start a project based on a session -- Asks for help planning their Build schedule or event schedule +- Asks for help planning their event schedule - Asks what to do after attending a session, or wants next steps - Wants to log notes or takeaways from a session -- References a session code (BRK, DEM, LAB, KEY, etc.) +- References a session code (BRK, DEM, LAB, KEY, LTG, THR, etc.) - Asks to create or export their schedule as a markdown file Do not activate when the user: @@ -98,22 +129,22 @@ The msevents CLI fetches, caches, indexes, and searches the session catalog loca ```sh # Search by keyword -npx -y @microsoft/events-cli sessions --query "Microsoft Foundry" --event build-2026 --json +npx -y @microsoft/events-cli sessions --query "Microsoft Foundry" --event ignite-2026 --json # Search by technology (matches product, tags, topic, languages, title, description) -npx -y @microsoft/events-cli sessions --tech "Azure Cosmos DB" --event build-2026 --json +npx -y @microsoft/events-cli sessions --tech "Azure Cosmos DB" --event ignite-2026 --json # Search by speaker -npx -y @microsoft/events-cli sessions --speaker "Scott Hanselman" --event build-2026 --json +npx -y @microsoft/events-cli sessions --speaker "Scott Hanselman" --event ignite-2026 --json # Combine filters -npx -y @microsoft/events-cli sessions --tech "Microsoft Foundry" --speaker "Yina Arenas" --event build-2026 --json +npx -y @microsoft/events-cli sessions --tech "Microsoft Foundry" --speaker "Yina Arenas" --event ignite-2026 --json # Look up a specific session by code npx -y @microsoft/events-cli session BRK155 --json # Refresh the cache -npx -y @microsoft/events-cli refresh --event build-2026 +npx -y @microsoft/events-cli refresh --event ignite-2026 # Check cache status npx -y @microsoft/events-cli status @@ -129,7 +160,7 @@ The CLI caches session data locally. On first use it fetches automatically — n | | `--tech ` | Search by technology (product, tags, topic, languages, title, description) | | | `--speaker ` | Search by speaker name | | | `--type ` | Filter by session type (breakout, lab, demo, keynote, etc.) | -| | `--event ` | Filter by event (e.g., `build-2026`, `ignite-2025`) | +| | `--event ` | Filter by event (e.g., `ignite-2026`, `build-2026`) | | | `--limit ` | Max results, default 10 | | | `--json` | Output as JSON | | `session ` | `--event ` | Scope to a specific event (for disambiguation) | @@ -144,12 +175,10 @@ If the CLI is not available (not installed, npx fails), fall back to fetching th ``` # Use the aka.ms links from the supported events table above -# Build 2026 (default): +# Ignite 2026 (default): +GET https://aka.ms/ignite2026-session-info +# Build 2026: GET https://aka.ms/build2026-session-info -# Ignite 2025: -GET https://aka.ms/ignite2025-session-info -# Build 2025: -GET https://aka.ms/build2025-session-info ``` The response is a JSON array of session objects. Key fields: @@ -177,9 +206,32 @@ The response is a JSON array of session objects. Key fields: | `viewingOptions` | Recording status (e.g., "Will be recorded", "Will not be recorded") | | `hasLiveStream` | Whether the session has a live stream (boolean) | | `hasOnDemand` | Whether on-demand video will be available (boolean) | +| `langLocale` | Session locale used in Ignite session-page URL (e.g., `en-US`) | +| `sessionInstanceId` | Opaque Ignite session instance ID used to build session-page URL | When using direct fetch: fetch once per conversation, filter for all technologies in the inventory in the same step, carry forward only matched sessions. +### Deterministic catalog access guardrails + +1. Prefer `msevents` for live catalog retrieval whenever available. +2. For generic cross-event search or event-less session-code lookup, ensure coverage for every required active event before returning results. +3. If required event coverage is missing, state the limitation, list missing events, and ask the user to narrow scope. +4. Do not return partial cross-event results as if complete. +5. Do not use page scraping, browser extraction, or unbounded catalog loading for authoritative session lookup. + +### Session page link rules + +When listing sessions, always include a session page URL when deterministically available from catalog facts. + +1. **Ignite sessions**: build the URL from catalog fields: + - `https://ignite.microsoft.com/{langLocale}/sessions/{sessionInstanceId}?source=sessions` + - Use `langLocale` and `sessionInstanceId` from the catalog record. + - If CLI output omits either field, fetch the corresponding raw catalog record by `sessionCode` from the configured endpoint before constructing the URL. + - Never invent or guess opaque IDs. +2. **Build sessions**: use: + - `https://build.microsoft.com/sessions/{sessionCode}` +3. If required URL fields are missing, state that a direct session-page link is unavailable for that result instead of fabricating one. + ### Learn MCP Server (live) Use Learn MCP tools to retrieve current documentation: @@ -206,31 +258,40 @@ npx @microsoft/learn-cli code-search "azure openai streaming" ## Core workflows -### "What's new for my project?" - -The user wants to know what recent Microsoft updates are relevant to their project. This workflow works year-round. - -1. Scan the user's project for tech stack signals: package.json, requirements.txt, .csproj, go.mod, Dockerfile, bicep/terraform files, .github/workflows -2. Extract dependencies, frameworks, and services in use -3. If a recent event is active or recent, fetch the News & Announcements page to discover announcements relevant to the inventory. This surfaces product launches, GA announcements, and preview features that may not yet appear in Learn what's-new pages or session titles. -4. Query Learn MCP Server for recent what's-new pages, SDK updates, and migration guides for each identified dependency. Include any announcements discovered via the News & Announcements page. -5. Search for relevant sessions: - - **With CLI**: Run `npx -y @microsoft/events-cli sessions --tech "[product]" --event build-2026 --json` for each major technology in the inventory +### "What's new for me?" + +The user wants to know what recent Microsoft updates are relevant to them. This workflow works year-round. + +1. Start by asking how to personalize recommendations: + - **Project-based** (scan an open dev project), or + - **Profile-based** (use known stack/deployment context from the conversation and user-provided details) +2. If project-based is chosen, ask explicit permission before reading project files. Only scan when the user agrees. +3. Build an initial technology inventory: + - **With permission**: scan project signals (`package.json`, `requirements.txt`, `.csproj`, `go.mod`, `Dockerfile`, bicep/terraform files, `.github/workflows`) + - **Without permission or no project**: use known stack/deployment context and any technologies already mentioned by the user +4. Validate the inventory with the user before recommendations: + - Confirm what's correct + - Remove incorrect items + - Ask whether they want to add any other technologies, platforms, or priorities +5. If a recent event is active or recent, fetch the News & Announcements page to discover announcements relevant to the confirmed inventory. This surfaces product launches, GA announcements, and preview features that may not yet appear in Learn what's-new pages or session titles. +6. Query Learn MCP Server for recent what's-new pages, SDK updates, and migration guides for each confirmed dependency/technology. Include any announcements discovered via the News & Announcements page. +7. Search for relevant sessions: + - **With CLI**: Run `npx -y @microsoft/events-cli sessions --tech "[product]" --event ignite-2026 --json` for each major technology in the confirmed inventory - **Without CLI**: Fetch the catalog once and match against `product`, `topic`, `tags`, and `programmingLanguages` fields -6. Present results: +8. Present results: - Announcements: what was launched or updated, with links to docs and blog posts - Documentation updates: what changed in the SDKs and services they use, with links to current docs - Relevant sessions: event sessions that cover their technologies, sorted by relevance -7. For high-confidence matches, offer to explain the migration path or impact on the developer's project +9. For high-confidence matches, offer to explain migration path or implementation impact for their environment Be specific. "The new Azure Functions v4 streaming support affects your queue trigger in /api/process.ts" is useful. "There were updates to Azure Functions" is not. **Output format:** ``` -## What's New at Build for Your Stack +## What's New at [Event] for You -Scanning: package.json, tsconfig.json, Dockerfile -Stack: Node 20, TypeScript, Azure Functions v4, Cosmos DB +Mode: Project-based (approved) | Profile-based +Inventory used: Node 20, TypeScript, Azure Functions v4, Cosmos DB ### @azure/cosmos - New vector search API replaces your workaround in /api/search @@ -245,41 +306,57 @@ Stack: Node 20, TypeScript, Azure Functions v4, Cosmos DB Create upgrade branch with new APIs? (y/n) ``` -### "Find sessions for me" +### "Find sessions for me (personalized learning path)" The user wants a personalized event schedule based on their projects or interests. -1. If the user has a project open, scan tech stack (same as above) -2. If no project is open, interview briefly (2-3 questions max): what they do, what technologies they use or want to learn, what they want from Build (solve a problem, learn something new, hands-on practice) -3. Search for sessions: - - **With CLI**: `npx -y @microsoft/events-cli sessions --tech "[product]" --event build-2026 --json` per technology, then `--query` for broader interest areas +1. Confirm target event (default Ignite 2026), role, and objective. +2. If the user has a project open, scan tech stack (same as above). +3. If no project is open, interview briefly (2-3 questions max): what they do, what technologies they use or want to learn, what they want from the event (solve a problem, learn something new, hands-on practice). +4. Search for sessions: + - **With CLI**: `npx -y @microsoft/events-cli sessions --tech "[product]" --event ignite-2026 --json` per technology, then `--query` for broader interest areas - **Without CLI**: Fetch the catalog and match manually -4. Match sessions to the user's stack using product, topic, tags, languages, and description -5. Present 3-5 sessions grouped by relevance tier: +5. Match sessions to the user's stack and role using product, topic, tags, languages, and description. +6. Rank by direct relevance, then progression fit (foundation -> applied -> advanced). +7. Present 3-5 sessions grouped by relevance tier: - Directly relevant: sessions about technologies in their active project - Adjacent: sessions about complementary technologies or next-step capabilities - Exploratory: sessions that expand their toolkit in a useful direction -6. For each recommended session, include: session code, title, one-line reason it's relevant, speaker(s), location, time slot, type (lab/breakout/demo), level -7. If they have time for multiple sessions, suggest a learning path order: foundational first, then intermediate/advanced, ending with hands-on labs to apply what they learned -8. After helping the user build a schedule (finding sessions, flagging conflicts), offer: "Would you like me to save this as a markdown file?" Do not create a file until the user confirms. Include day, time, session code, title, and location. +8. Build a sequenced path: + - Foundation + - Applied implementation + - Advanced/architecture +9. For each recommended session, include: session code, title, one-line reason it's relevant, speaker(s), location, time slot, type (lab/breakout/demo), level, session-page URL, and why it belongs at that point in the sequence. +10. If confidence is low, say so and offer 1-2 alternatives. +11. After helping the user build a schedule (finding sessions, flagging conflicts), offer: "Would you like me to save this as a markdown file?" Do not create a file until the user confirms. Include day, time, session code, title, and location. **Output format:** -``` -## Recommended Sessions for Your Stack +``` +## Personalized Session Path for Your Stack Based on your project (Node.js, Azure Functions, Cosmos DB): +### Foundation 1. **BRK223** — From rows to reasoning: Designing databases for AI apps and agents 📌 Relevant: You use Cosmos DB in /api/data 🎤 Mark Smith | 📍 Room 151 | Jun 2, 3:45 PM PDT Breakout · Level 300 + Why now: Establishes core data patterns used by later implementation sessions 🔗 https://build.microsoft.com/sessions/BRK223 +### Applied implementation 2. **LAB511** — Create advanced Postgres-powered agentic apps with Azure HorizonDB 📌 Relevant: Your requirements.txt includes psycopg2 🎤 Jane Doe | 📍 Hall B | Jun 3, 9:00 AM PDT Lab · Level 200 + Why now: Applies architecture patterns from the foundation session in hands-on form 🔗 https://build.microsoft.com/sessions/LAB511 + +### Advanced/architecture +3. **BRK310** — [Example advanced session] + 📌 Relevant: Expands production design choices for your stack + Why now: Moves from implementation to scaling and operational trade-offs + 🔗 [Session page URL] ``` ### "Scaffold from session [ID]" @@ -288,7 +365,7 @@ The user saw a session and wants to start building with what was demonstrated. 1. **Ask where to create the project first** — don't assume. New directory, current directory, or a specific path. 2. Look up the session: - - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event build-2026 --json` + - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event ignite-2026 --json` - **Without CLI**: Fetch the catalog and find by code or title 3. Extract the technologies and products covered from the session metadata 4. Check prerequisites: based on the session's tech stack, list what the user needs (Azure subscription, SDKs, runtimes, API keys). Ask if they have them before proceeding. @@ -318,9 +395,9 @@ Open in VS Code? (y/n) The user wants to understand a specific session. 1. Look up the session: - - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event build-2026 --json` + - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event ignite-2026 --json` - **Without CLI**: Fetch the catalog and find by code or title -2. Present: title, speakers, abstract, session type, level, time slot, location, delivery type, viewing options, related sessions +2. Present: title, speakers, abstract, session type, level, time slot, location, delivery type, viewing options, session-page URL, related sessions 3. If the session covers specific products or technologies, search Learn MCP for current docs on those topics 4. Link to slides or on-demand video if available 5. If the user is remote, highlight whether the session is online, has a live stream, or will be available on-demand @@ -353,7 +430,7 @@ Learn how to design your database layer for AI-native applications and agents... The user just attended or watched a session and wants next steps. 1. Look up the session: - - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event build-2026 --json` + - **With CLI**: `npx -y @microsoft/events-cli session [ID] --event ignite-2026 --json` - **Without CLI**: Fetch the catalog and find by code or title 2. Check the `relatedSessionCodes` field first — use those if populated 3. Build a response with up to three sections: @@ -370,10 +447,12 @@ The user just attended or watched a session and wants next steps. 1. **BRK224** — Thirsty for more data: how Pepsi refreshed for agentic apps Builds on the Cosmos DB patterns you just learned ⏰ Starts in 45 min + 🔗 [Session page URL] 2. **DEM310** — Ship code faster with AI-powered NoSQL schema design Directly applies to your project's data layer ⏰ Starts in 2 hours + 🔗 [Session page URL] ### Try Now (between sessions) - Scaffold a project from BRK223: `scaffold BRK223` @@ -410,20 +489,90 @@ The user wants to capture takeaways during or after a session. 4. If session lookup fails, write the entry without enrichment — don't block note-taking on data access. 5. Confirm briefly: "Saved your note on BRK241 to journal/2026-05-19.md." +### "Build a supplemental learning path" + +The user wants docs and samples that complement selected sessions. + +1. Start from chosen sessions (or ask for 1-3 session codes). +2. Extract products/topics from session metadata. +3. Query Learn MCP for current quickstarts, tutorials, API refs, and code samples. +4. Organize resources by learning phase: before session, after session, production hardening. +5. Include only resources with clear topic alignment; do not pad with generic docs. + +**Output format:** +```markdown +## Supplemental Learning Path for [Session Code(s)] + +### Before the session +- [Doc title](URL) - [1-line reason] + +### After the session +- [Quickstart/tutorial](URL) - [1-line reason] + +### Production hardening +- [Architecture/ops doc](URL) - [1-line reason] +``` + +### "Create an operational learning checklist" + +The user wants practical execution steps from session learning to implementation. + +1. Identify session technologies and required prerequisites. +2. Convert session themes into concrete tasks (setup, validate, implement, deploy, observe). +3. Add evidence checkpoints for each task (what proves completion). +4. Include dependencies/order and minimal rollback guidance for risky steps. +5. Keep checklist scoped to the user's stack and selected sessions. + +**Output format:** +```markdown +## Operational Checklist from [Session Code] + +- [ ] Environment prerequisites verified +- [ ] Starter implementation completed +- [ ] Validation tests run +- [ ] Deployment path confirmed +- [ ] Monitoring/alerts configured +- [ ] Follow-up session or doc reviewed +``` + +### "Ground recommendations in authorized context" + +Use this whenever recommendations are personalized. + +1. Treat session/catalog fields and Learn docs as facts; keep recommendations as judgment. +2. Tie every recommendation to explicit context: + - user-stated goals, or + - approved project inventory, or + - prior constraints shared in-chat. +3. For each recommended session/resource, cite concrete matching signals. +4. If context is missing or ambiguous, ask for it before ranking. + +**Output format:** +```markdown +## Recommendation Traceability + +- Recommendation: [CODE or doc] + - Matched facts: [catalog/doc facts] + - Authorized context: [user goal or project signal] + - Confidence: High | Medium | Low +``` + ## Context before recommendations -Before recommending sessions or documentation, establish what the developer actually uses. Do not skip this step. +Before recommending sessions or documentation, establish what the user actually uses. Do not skip this step. -1. Scan the project for tech stack signals: package.json, requirements.txt, .csproj, go.mod, Dockerfile, bicep/terraform files, .github/workflows, docker-compose.yml -2. Extract concrete dependencies, frameworks, SDK versions, and Azure services in use +1. Choose one inventory path: + - **Project-based inventory (requires explicit consent):** scan project tech-stack signals (`package.json`, `requirements.txt`, `.csproj`, `go.mod`, `Dockerfile`, bicep/terraform files, `.github/workflows`, `docker-compose.yml`) only after user approval. + - **Profile-based inventory:** use the user-provided stack and role context when project-file access is not approved or not needed. +2. Extract concrete dependencies, frameworks, SDK versions, and Azure services in use. 3. Translate package names to Microsoft product names for effective searching. Common patterns: - npm `@azure/*` packages map to Azure service names (e.g., `@azure/cosmos` -> "Azure Cosmos DB", `@azure/functions` -> "Azure Functions") - NuGet `Microsoft.*` and `Azure.*` packages map to .NET or Azure service names - pip `azure-*` packages follow similar patterns (e.g., `azure-storage-blob` -> "Azure Blob Storage") - For Azure services, canonical product names are listed at https://github.com/MicrosoftDocs/Agent-Skills (191 Azure services as directory names like `azure-cosmos-db`, `azure-functions`) - When the mapping is unclear, use the package name as a search term — Learn MCP handles fuzzy matching -4. Build an inventory: language(s), frameworks, Azure services, data stores, CI/CD tools, with both package names and product names -5. Only then query Learn MCP and search sessions, using the inventory to scope searches +4. Build a validated inventory: language(s), frameworks, Azure services, data stores, CI/CD tools, with both package names and product names. +5. Only then query Learn MCP and search sessions, using the validated inventory to scope searches. If the user has no project open, ask what they work with. Do not recommend sessions or docs based on vague interest areas alone — get to specific technologies. @@ -447,7 +596,7 @@ Use MCP tools (or the mslearn CLI fallback) deliberately, not speculatively: 3. Fetch full pages for high-value results. A search result snippet may lack the migration steps or version details the developer needs. Use microsoft_docs_fetch on the most relevant URLs. 4. Scope searches to the inventory. Do not search for technologies the developer does not use. 5. Try multiple query formulations when initial results are weak. If "what's new Azure Cosmos DB" returns generic content, try "Azure Cosmos DB changelog 2026" or "Azure Cosmos DB preview features." -6. For broad questions ("what's new for my project", "what changed at Build"), always fetch the event's **News & Announcements** page using the links in the **Key resources** section below. If the relevant event or year is not listed there, fall back to searching `news.microsoft.com` for the event's **News & Announcements** page. The **News & Announcements** page groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the **News & Announcements** page is optional. +6. For broad questions ("what's new for me", "what's new for my project", "what changed at this event"), always fetch the event's **News & Announcements** page using the links in the **Key resources** section below. If the relevant event or year is not listed there, fall back to searching `news.microsoft.com` for the event's **News & Announcements** page. The **News & Announcements** page groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the **News & Announcements** page is optional. 7. Use what's-new pages on Learn when they exist. Many services have dedicated pages following patterns like `/azure/{service}/whats-new` or `/dotnet/core/whats-new/`. Try fetching these directly with microsoft_docs_fetch for a comprehensive changelog. ## Session catalog cross-reference @@ -456,7 +605,7 @@ When the agent finds relevant documentation updates for the developer's stack, c 1. Take the product names and topics from the documentation results 2. Search for matching sessions: - - **With CLI**: `npx -y @microsoft/events-cli sessions --tech "[product]" --event build-2026 --json` + - **With CLI**: `npx -y @microsoft/events-cli sessions --tech "[product]" --event ignite-2026 --json` - **Without CLI**: Match against catalog fields `product`, `topic`, `tags`, `solutionArea` 3. Use announcement content as a bridge — if a what's-new page mentions a feature, search sessions covering that product area 4. Present sessions alongside the documentation updates, not as a separate list @@ -498,7 +647,7 @@ Query templates for common lookups. Replace `[placeholders]` with values from th | Migration guide | `"migrate to [new feature/version] [product name]"` | | | Quickstart | `"quickstart [product name] [language]"` | | | Code sample | `"[product name] [feature] sample [language]"` | Use microsoft_code_sample_search | -| Event updates | `"[product name] Build 2026"` or `"[product name] Ignite 2026"` | Surfaces event-specific announcements | +| Event updates | `"[product name] Ignite 2026"` or `"[product name] Build 2026"` | Surfaces event-specific announcements | ## Acceptance criteria @@ -519,12 +668,18 @@ A good response from this skill: | Microsoft Ignite | `https://ignite.microsoft.com/` | | msevents CLI | `npx -y @microsoft/events-cli` | | CLI source | `../../cli/` | +| Ignite 2026 session catalog | `https://aka.ms/ignite2026-session-info` | | Build 2026 session catalog | `https://aka.ms/build2026-session-info` | -| Build 2025 session catalog | `https://aka.ms/build2025-session-info` | -| Ignite 2025 session catalog | `https://aka.ms/ignite2025-session-info` | +| Ignite 2026 News & Announcements | If not published in this table yet, search `news.microsoft.com` for Ignite 2026 announcements | | Build 2026 News & Announcements | `https://aka.ms/build2026-news` | -| Build 2025 News & Announcements | `https://aka.ms/build2025-news` | -| Ignite 2025 News & Announcements | `https://aka.ms/ignite2025-news` | | Learn MCP Server | `https://learn.microsoft.com/api/mcp` | | Learn MCP Server docs | `https://learn.microsoft.com/en-us/training/support/mcp` | | Azure Agent Skills (product names) | `https://github.com/MicrosoftDocs/Agent-Skills` | + +## Ignite 2026 repository conventions + +Use these rules when users ask for repo links tied to Ignite sessions: + +1. Prefer explicit links from trusted event threads when available. +2. Otherwise use the observed naming convention `https://github.com/microsoft/ignite26-` and verify the repo exists before sharing. +3. Keep recommendations to public, verifiable resources unless the user explicitly asks for internal-only links.