Chatgpt Multi Format Attachments

# ChatGPT Pro Multi-Format Attachments Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Extend `chatgpt-collaboration-harness` with a direct-first, evidence-labeled attachment workflow for common images, PDFs, documents, spreadsheets, presentations, text files, and ZIP archives, then synchronize and independently validate the installed runtime copy.

**Architecture:** Keep `SKILL.md` as the compact router, keep Chrome chooser diagnosis and permission remediation in `references/chrome-chatgpt-pro.md`, and move transport selection, the bounded format/MIME matrix, clipboard qualification, and manual handoff into `references/file-artifact-exchange.md`. Drive the repository change with contract tests, gather browser evidence using valid synthetic files without sending, and promote only transport/format pairs that produce unambiguous composer previews.

**Tech Stack:** Markdown skills and references, Python 3 `unittest`, bundled Python artifact libraries (`Pillow`, `reportlab`, `python-docx`, `pypdf`) for ordinary/image/PDF/DOCX fixtures, bundled Node.js plus `@oai/artifact-tool` for XLSX/PPTX authoring and rendering, Poppler and the installed document/presentation render helpers for visual QA, Chrome browser-client runtime, Codex skill validator with PyYAML, `rsync`, Git.

---

## File Structure

- Modify: `tests/test_skill_catalog.py`
- Modify: `skills/chatgpt-collaboration-harness/SKILL.md`
- Modify: `skills/chatgpt-collaboration-harness/references/chrome-chatgpt-pro.md`
- Modify: `skills/chatgpt-collaboration-harness/references/file-artifact-exchange.md`
- Read as source of truth: `docs/superpowers/specs/2026-07-13-chatgpt-multi-format-attachments-design.md`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-generate-20260713.py`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-artifact-workspace-20260713/xlsx/build-xlsx.mjs`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-artifact-workspace-20260713/pptx/build-pptx.mjs`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-smoke-20260713/`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-qa-20260713/`
- Create temporarily outside Git: `/tmp/chatgpt-multi-format-validated-root-20260713.txt` (synthetic coordination pointer; preserve it through browser staging)
- Synchronize after repository validation: `~/.codex/skills/chatgpt-collaboration-harness/`

Do not add a repository script, dependency, binary fixture, global Codex config
option, browser-profile edit, or second skill. The user-controlled Chrome
permission is already enabled and remains environment state.

### Task 1: Replace The PNG-Only Contracts With RED Multi-Format Contracts

**Files:**
- Modify: `tests/test_skill_catalog.py:321-435`
- Test: `tests/test_skill_catalog.py`

- [ ] **Step 1: Replace the four PNG-only behavior tests**

Replace the methods beginning with
`test_chatgpt_collaboration_harness_documents_verified_clipboard_fallback`
and ending with
`test_chatgpt_collaboration_harness_uses_the_virtual_clipboard_paste_call`
with these tests: