Bring a Drupal contribution idea - or use one of ours - and work through a practical AI-assisted workflow that turns it into a review-ready contribution designed to earn maintainer trust and accelerate the review process.

This workshop is facilitated by Product and Innovation Leads of the Drupal AI Initiative, and is designed to field-test practical patterns that will inform official AI-assisted contribution guidelines.

Prerequisite

Bring a laptop, a contribution idea if you have one, and access to an AI assistant you are comfortable using. Browser-based tools are enough for most lanes. Attendees should be comfortable with basic Drupal concepts, Git, and reading issue queues or project documentation. No prior AI experience is required. Curated issues, templates, checkpoint branches, and a browser-based fallback environment will be provided.

Target Audience

Drupal users and contributors (developers, testers, and technical writers) looking for a responsible, field-tested workflow for using AI to create reviewer-friendly contributions.

Outline

AI can draft a patch in minutes. Crafting a contribution that maintainers can easily verify, trust, and confidently merge is the actual skill.

This workshop gives Drupal contributors a practical workflow for using AI as a tool for high-value, maintainer-friendly collaboration. Participants bring a contribution idea - or choose from a curated list - and move through the same structured sequence: understand the issue and prior discussion, write a human task brief with acceptance criteria, add project instructions that constrain the assistant, use AI to draft analysis, docs, tests, or a small code change in reviewable increments, verify the result, disclose AI use clearly, and write a maintainer-friendly handoff comment.

The goal is not to show off a coding tool. The goal is to practice contributing with AI in a way that makes the human value visible: context, judgment, scope, verification, and collaboration. Attendees leave with a reusable workflow and a reviewer-ready contribution bundle they can keep developing after the session. The room also surfaces field-tested patterns that can inform future community guidance. No product demos. No magic prompts. Just practical contribution skills.

Learning Objectives

- Turn a Drupal idea or existing issue into a human-authored task brief with context, scope, and acceptance criteria.
- Write project instructions, such as an AGENTS.md, that constrain AI output to Drupal and project-specific expectations.
- Use AI to draft analysis, documentation, tests, or a small code change in reviewable increments instead of dumping a patch.
- Verify AI-generated work for correctness, dependencies, security, licensing, and disclosure.
- Write a maintainer-friendly handoff comment that explains what was done, what was verified, and what feedback is needed.

What attendees leave with

- A human-authored task brief
- Project instructions / AGENTS.md
- One scoped artifact: issue analysis, docs, tests, or a small code change
- A verification and disclosure checklist
- A maintainer-friendly handoff comment
- A reusable workflow they can bring back to their team

Experience level
Intermediate