Skip to content

Add TLC meeting minutes skill#2676

Merged
titusfortner merged 3 commits into
SeleniumHQ:trunkfrom
titusfortner:tlc-meeting
Jul 16, 2026
Merged

Add TLC meeting minutes skill#2676
titusfortner merged 3 commits into
SeleniumHQ:trunkfrom
titusfortner:tlc-meeting

Conversation

@titusfortner

Copy link
Copy Markdown
Member

Description

Adds a shared .agents/skills/tlc-meeting skill for generating Selenium TLC meeting minutes from local transcripts, and documents shared project skill discovery in AGENTS.md.

Also adds 2026 TLC meeting minutes for:

  • June 11
  • June 18
  • June 25
  • July 2

The skill treats the transcript as the source of truth, uses the rolling agenda only for matching dated agenda context and public links, and allows GitHub PR/issue bodies/comments only as public reference context.

Motivation and Context

This makes TLC meeting minute generation repeatable and reviewable for future meetings. The skill encodes the workflow, participant mapping, evidence rules, GitHub handle-link style, and section responsibilities so future minutes avoid private transcript links, agenda-only content, unsupported decisions, and duplicated summary/decision/discussion text.

Types of changes

  • Change to the site (I have double-checked the Netlify deployment, and my changes look good)
  • Code example added (and I also added the example to all translated languages)
  • Improved translation
  • Added new translation (and I also added a notice to each document missing translation)

@netlify

netlify Bot commented Jul 8, 2026

Copy link
Copy Markdown

Deploy Preview for selenium-dev ready!

Name Link
🔨 Latest commit 432c591
🔍 Latest deploy log https://app.netlify.com/projects/selenium-dev/deploys/6a58f7ad60b7d800083f34b3
😎 Deploy Preview https://deploy-preview-2676--selenium-dev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@titusfortner
titusfortner marked this pull request as ready for review July 16, 2026 15:24
@qodo-code-review

Copy link
Copy Markdown
Contributor

PR Summary by Qodo

Add TLC meeting-minutes agent skill and publish 2026 TLC minutes

📝 Documentation ✨ Enhancement 🕐 20-40 Minutes

Grey Divider

AI Description

• Add a reusable agent skill to generate public TLC minutes from local transcripts.
• Document shared skill discovery so agents consistently apply project workflows.
• Publish four new 2026 TLC meeting minutes pages under the meetings section.
Diagram

graph TD
  T["Local transcript / Meet notes"] --> S["tlc-meeting skill"] --> M["Meeting minutes .md"]
  A["Rolling agenda (Google Doc)"] --> S
  G["GitHub PRs/issues (public)"] --> S
  M --> W["Hugo site build"]
  subgraph Legend
    direction LR
    _in["Input"] ~~~ _skill["Process"] ~~~ _out["Output"]
  end
Loading
High-Level Assessment

The following are alternative approaches to this PR:

1. Hugo archetype/template for TLC minutes
  • ➕ Enforces consistent front matter/section skeleton without agent-specific tooling
  • ➕ Works for contributors who don't use agents
  • ➖ Doesn't encode evidence rules, speaker-to-handle mapping, or agenda/GitHub cross-referencing
  • ➖ Still requires manual summarization discipline
2. Add a small generator script (CLI) for minutes scaffolding + validations
  • ➕ Can automatically validate formatting (front matter dates, link refs, required sections)
  • ➕ Repeatable in CI (lint minutes for private links / missing sections)
  • ➖ More maintenance burden than a Markdown skill
  • ➖ Hard to reliably validate “evidence-based” content without the transcript

Recommendation: The PR’s approach (a shared skill plus explicit evidence rules) is the best fit for this workflow because the hard part is consistent decision-quality summarization and public-evidence discipline, not just file scaffolding. If errors start recurring (private links, missing sections, inconsistent references), consider adding a lightweight lint step later to validate structure and link/reference hygiene.

Files changed (7) +658 / -0

Documentation (7) +658 / -0
SKILL.mdAdd tlc-meeting skill with evidence rules and minutes template +162/-0

Add tlc-meeting skill with evidence rules and minutes template

• Introduces a shared agent skill that prescribes how to generate TLC meeting minutes from local transcripts. Encodes workflow steps, transcript-as-truth evidence rules, participant GitHub-handle mapping, and output formatting/validation guidance for minutes pages.

.agents/skills/tlc-meeting/SKILL.md

AGENTS.mdDocument discovery of shared skills under .agents/skills/ +2/-0

Document discovery of shared skills under .agents/skills/

• Updates agent instructions to explicitly inspect shared project skills in .agents/skills/*/SKILL.md before performing repeated or domain-specific workflows.

AGENTS.md

_index.mdAdd 2026 meetings section index +5/-0

Add 2026 meetings section index

• Creates the Hugo section index for 2026 project meetings with title/linkTitle/weight metadata so the year is navigable in the meetings hierarchy.

website_and_docs/content/meetings/2026/_index.md

tlc-06-11.mdPublish TLC minutes for 2026-06-11 +112/-0

Publish TLC minutes for 2026-06-11

• Adds a new TLC meeting page including participation, agenda, summary, decisions, discussion notes, action items, and link references for public artifacts discussed (e.g., selenium PRs).

website_and_docs/content/meetings/2026/tlc-06-11.md

tlc-06-18.mdPublish TLC minutes for 2026-06-18 +106/-0

Publish TLC minutes for 2026-06-18

• Adds a new TLC meeting page capturing the ADR process confirmation and BiDi Selenium 5 API shape discussion, with action items and references to relevant SeleniumHQ PRs.

website_and_docs/content/meetings/2026/tlc-06-18.md

tlc-06-25.mdPublish TLC minutes for 2026-06-25 +123/-0

Publish TLC minutes for 2026-06-25

• Adds a new TLC meeting page covering Selenium 5 release charter decisions, ADR process guidance, Selenium Manager/CLI scope discussion, and tracked action items with participant references.

website_and_docs/content/meetings/2026/tlc-06-25.md

tlc-07-02.mdPublish TLC minutes for 2026-07-02 +148/-0

Publish TLC minutes for 2026-07-02

• Adds a new TLC meeting page summarizing decisions on release charter scope, Selenium Manager beta status, ADR workflow updates, BiDi API boundary principles, and release/publishing follow-ups.

website_and_docs/content/meetings/2026/tlc-07-02.md

@titusfortner
titusfortner merged commit 1c8a079 into SeleniumHQ:trunk Jul 16, 2026
6 checks passed
@qodo-code-review

Copy link
Copy Markdown
Contributor

Code Review by Qodo

🐞 Bugs (1) 📘 Rule violations (0) 📜 Skill insights (0)

Grey Divider


Remediation recommended

1. Unclear skill discovery paths 🐞 Bug ⚙ Maintainability
Description
AGENTS.md adds guidance to inspect .agents/skills/, but it does not clarify how this relates to
the already-documented committed skills under scripts/skills/, leaving contributors/agents unsure
which directories are authoritative for discovery and where new shared skills should be added.
Code

AGENTS.md[R21-22]

+- Shared project skills live in `.agents/skills/`; inspect relevant `*/SKILL.md` files before
+  doing repeated or domain-specific workflows.
Evidence
AGENTS.md introduces .agents/skills/ as a shared-skill location while also separately stating that
scripts/skills/ holds committed repo skills; the repo already uses scripts/skills/ for an
existing skill and this PR adds a new skill under .agents/skills/, making the intended
discovery/authoritative location ambiguous.

AGENTS.md[19-29]
scripts/skills/release-blog-post/SKILL.md[1-6]
.agents/skills/tlc-meeting/SKILL.md[1-12]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
`AGENTS.md` now mentions shared skills under `.agents/skills/`, but the document already defines `scripts/skills/` as the location for committed repo skills. Without explicitly stating the relationship (e.g., “inspect both”, “`.agents/skills` supersedes `scripts/skills`”, or “they serve different purposes”), skill discovery and future contributions are likely to be inconsistent.

## Issue Context
- The repo already contains a committed skill under `scripts/skills/`.
- This PR introduces a new committed skill under `.agents/skills/`.

## Fix Focus Areas
- AGENTS.md[19-29]
- scripts/skills/release-blog-post/SKILL.md[1-6]
- .agents/skills/tlc-meeting/SKILL.md[1-12]

## Suggested fix
- Update `AGENTS.md` to explicitly define:
 - whether agents/contributors should inspect **both** `.agents/skills/` and `scripts/skills/`.
 - which directory is the preferred destination for **new** shared skills.
 - (optional) if one directory is legacy, add a short migration note.
- Consider aligning by either moving the new skill into `scripts/skills/` or updating the “Project-defined skills” section to include `.agents/skills/` as a first-class location (so the doc reads as one coherent policy).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Qodo Logo

Comment thread AGENTS.md
Comment on lines +21 to +22
- Shared project skills live in `.agents/skills/`; inspect relevant `*/SKILL.md` files before
doing repeated or domain-specific workflows.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remediation recommended

1. Unclear skill discovery paths 🐞 Bug ⚙ Maintainability

AGENTS.md adds guidance to inspect .agents/skills/, but it does not clarify how this relates to
the already-documented committed skills under scripts/skills/, leaving contributors/agents unsure
which directories are authoritative for discovery and where new shared skills should be added.
Agent Prompt
## Issue description
`AGENTS.md` now mentions shared skills under `.agents/skills/`, but the document already defines `scripts/skills/` as the location for committed repo skills. Without explicitly stating the relationship (e.g., “inspect both”, “`.agents/skills` supersedes `scripts/skills`”, or “they serve different purposes”), skill discovery and future contributions are likely to be inconsistent.

## Issue Context
- The repo already contains a committed skill under `scripts/skills/`.
- This PR introduces a new committed skill under `.agents/skills/`.

## Fix Focus Areas
- AGENTS.md[19-29]
- scripts/skills/release-blog-post/SKILL.md[1-6]
- .agents/skills/tlc-meeting/SKILL.md[1-12]

## Suggested fix
- Update `AGENTS.md` to explicitly define:
  - whether agents/contributors should inspect **both** `.agents/skills/` and `scripts/skills/`.
  - which directory is the preferred destination for **new** shared skills.
  - (optional) if one directory is legacy, add a short migration note.
- Consider aligning by either moving the new skill into `scripts/skills/` or updating the “Project-defined skills” section to include `.agents/skills/` as a first-class location (so the doc reads as one coherent policy).

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants