run-ai-sdlc

name	run-ai-sdlc
description	Use when the user wants to run, serve, build, export, screenshot, smoke-test, or otherwise drive the ai-sdlc site — a team folder of YAML rendered as three interactive figures. Covers the dev server, the ai-sdlc CLI (serve/export/check), the one-file HTML export, and browser-driven verification of the drawer, view switch, and role filter.

Running ai-sdlc

An Astro 5 static site that renders one team folder — team.yaml, one file per shared catalog, and processes/*.yaml — into a team document at / and a process document at /<process>, each with three figures (FLOW / GRID / PLAYBOOK) and a detail drawer. Everything interesting is client-side, so reading the HTML is not verification. Drive it with driver.mjs.

Paths below are relative to the repo root.

Prerequisites

Node ≥ 22.18 (bin/check.mjs imports a .ts file and relies on Node's type stripping), plus the browser driver, installed globally:

npm install -g @playwright/cli   # provides `playwright-cli`
npm install                      # repo deps

Run: the driver (agent path)

One command proves the whole thing — server, every route, every interaction, and the export artifact:

node .claude/skills/run-ai-sdlc/driver.mjs smoke

It starts its own server on a free port, drives a real browser, and exits non-zero if any check fails. Last verified run:

serving C:\Users\nikiforovall\dev\ai-sdlc\examples\reference
  ok   / renders the team document — Example Team — ai-sdlc
  ok   /bugfix renders — 8 activities
  ok   /bugfix drawer starts closed
  ok   /bugfix activity opens its drawer panel — triage-bug
  ok   /bugfix Escape closes the drawer
  ok   /bugfix view switches to PLAYBOOK
  ok   /bugfix role filter narrows the readout — Product Lead — 1 of 8 activities in scope
  … same six for /feature and /incident …

deep links
  ok   /bugfix #view= restores the view — grid
  ok   /bugfix #role= restores the lens — Product Lead — 1 of 8 activities in scope
  ok   /bugfix #open= restores the drawer — triage-bug
  ok   /bugfix view, lens and drawer compose — grid · lead · triage-bug
  ok   /bugfix legacy #act- hash still opens its panel — triage-bug
  ok   /bugfix clicking writes the reading into the hash — #view=grid&role=lead&open=act-triage-bug
  ok   /bugfix clicking adds no history entry — 3 activities + a view · length 18 → 18
  ok   /bugfix a stale #open= drops itself from the hash — #view=grid
  ok   / #open= opens the team drawer on that panel — role:lead

exporting
  ok   export writes one file
  ok   export holds every document — 4 documents
  ok   export shows one document at a time — incident
  ok   export drawer works offline — acknowledge-page
  ok   export references no external asset
  ok   export restores document, view and drawer from one hash — bugfix · grid · triage-bug

34/34 checks passed