# Brief (CW-027)

A family of CoWork skills that generate single-file HTML briefing infographics for
Message Point Media meetings — client/partner, internal, and project — on one shared
MPM-branded visual component system. Originates from a bilingual template Roger Lu
(Humax) shared with Bryan; reskinned entirely to MPM's brand (CW-001 / CW-028) and
English-only.

## Status: v0.2.0 — 1 of 6 skills built, real-world tested twice

| Skill | Status |
|---|---|
| `internal-meeting-brief` | **Built and installed.** Real-tested 2026-09-21 (APTA 2026 booth planning) and 2026-09-22 (Oshkosh GO Transit internal kickoff) — the second run was the first real invocation from the actual installed skill, not Claude hand-building it, and surfaced real fixes (see Changelog). |
| `vendor-partner-brief` | Not started |
| `status-update-brief` | Not started |
| `five-whys-brief` | Not started |
| `kickoff-brief` (3 audience variants) | Not started |
| `development-brief` (software/hardware/product) | Not started |

Full design history, the data/continuity architecture, and delivery/hosting plan
(deferred to CW-029, "Brief Server") live in CW-027's Concept.md on Drive — read that
before starting work on any of the remaining five skills.

## Architecture in one paragraph

Each skill pulls its own facts from connected tools (Plaud, Odoo, Gmail, Google Chat,
the MPM Technical Reference System) rather than requiring hand-assembled input,
maintains continuity per real-world project/topic via a Drive folder +
`_topic-state.md` manifest (not the ephemeral sandbox), and renders through one shared
component library (`skills/*/assets/brief-components.css`, tokens sourced from
CW-028) rather than per-brief CSS. Every brief produces both HTML and PDF (headless
Chromium via Playwright), archives the source transcript alongside itself, and — when
a topic has a real end-client agency — resolves and embeds that agency's identity
(legal name, transit brand name, logo, contact info). Hosting/publishing is
intentionally out of scope for this repo — see CW-029.

## Changelog

- **v0.2.0** (2026-09-22) — First real invocation from the installed skill (Oshkosh GO
  Transit kickoff) surfaced and fixed: a print-CSS bug causing blank PDF pages; SO/PO
  data wrongly excluded from this brief type by default; contact-info lookup and
  part-number/product verification (via the MPM Technical Reference System) added as
  standing steps; the real run's improved `_topic-state.md` schema (confidence tags,
  numbered-vs-proposed items, Findings/flags) folded back into the spec; meeting
  transcript archival made standing; PDF made a required parallel output instead of a
  manual export; end-agency identity enrichment added; a channel/pricing
  confidentiality Hard Rule recorded for future external-facing brief types. Also: the
  Plaud connector issue from v0.1.0 was root-caused (wrong connector + a web-URL id
  missing its `of_` prefix) and fixed, and the repo's `origin` remote — which had
  drifted to the stale `git.mpm.to` — was corrected to `git2.mpm.to`.
- **v0.1.0** (2026-09-21) — Initial build: `internal-meeting-brief`, canonical shared
  component CSS, fixed-vs-dynamic section-structure contract. Plaud connector
  non-functional at this point; brief built from a manually uploaded transcript.

## Known issues

None currently open for `internal-meeting-brief`. The Plaud connector problem from
v0.1.0 is resolved (see Changelog) — use the official `Plaud` connector only, resolve
recording ids via `list_files(query=...)`, never from a web-app URL directly.