/showroom:create-lab

📝 Workshop Lab Creation

Create hands-on Red Hat Showroom workshop content. Runs a grouped planning form then generates all files in parallel using specialized agents. Supports headless mode for Publishing House.

Quick Start

/showroom:create-lab
/showroom:create-lab content/modules/ROOT/pages/ --new
/showroom:create-lab content/modules/ROOT/pages/ --continue 03-module-01.adoc

Architecture

create-lab agent orchestration diagram

New lab: 4 file-generator agents run simultaneously — index, overview, details, module-01 all generated in parallel.

Continue mode: single file-generator seeded with previous module content (sequential by design for story continuity).

How It Works

  1. Parse arguments

    Reads --new or --continue flags. If target directory is empty, prompts to clone the nookbag template first.

  2. Grouped planning form (Phase A)

    Asks all questions at once — lab name, audience, business scenario, duration, module breakdown, environment details, reference materials, and optional writing style. No sequential blocking. User fills what they know and confirms the plan.

  3. Showroom setup (new labs)

    Q0–Q3: catalog type, tabs/consoles, Red Hat theme, E2E automation. Creates site.yml and ui-config.yml. If E2E: copies buttons.js from the nookbag e2e-template branch and creates runtime-automation/ skeleton with canonical Ansible stubs.

  4. Parallel file generation (Phase B)

    Spawns 4 showroom:file-generator agents simultaneously. Each gets the full FULL_SPEC JSON including writing style profile. All apply the auto-humanizer pass before writing to disk.

  5. Quality check and delivery

    Spawns showroom:module-reviewer on generated files. Merges nav.adoc from agent nav_entry outputs. Presents delivery summary with file list, word counts, and any quality warnings.

Personal Writing Style

Provide your style in the planning form:

Writing style: "conversational, short sentences, active voice, no jargon"
  OR paste 1-3 paragraphs of your writing as an example
  OR path to a module you wrote: ~/my-showroom/content/modules/ROOT/pages/03-module-01.adoc
  Saved profile: ~/.claude/context/my-writing-style.md

See Writing Style Guide for how to create a persistent profile.

Publishing House Integration

ph_payload:
  target_dir: content/modules/ROOT/pages/
  mode: new
  spec:
    lab_name: OpenShift Pipelines Workshop
    audience: intermediate
    learning_objectives: [Deploy a pipeline, Configure triggers, Monitor builds]
    business_scenario: ACME Corp needs to modernize their CI/CD pipeline...
    duration: 90min
    env:
      ocp_version: "4.18"
      attributes: {user: user1, password: openshift}
    writing_style: "conversational, short sentences"

Returns:

{
  "files_created": ["index.adoc", "01-overview.adoc", "02-details.adoc", "03-module-01-pipeline-setup.adoc"],
  "nav_updated": true,
  "quality": {"critical": 0, "high": 0, "warnings": 1}
}

See PH Integration Guide for full sequence diagrams.