Skip to content

feat(pipeline): ship InDesign pipeline agent, skill, CLI, and docs#103

Merged
PAMulligan merged 1 commit into
mainfrom
67-indesign-pipeline-claude-code-agent-skill-and-documentation-for-the-indesign-to-react-workflow
Jun 20, 2026
Merged

feat(pipeline): ship InDesign pipeline agent, skill, CLI, and docs#103
PAMulligan merged 1 commit into
mainfrom
67-indesign-pipeline-claude-code-agent-skill-and-documentation-for-the-indesign-to-react-workflow

Conversation

@PAMulligan

Copy link
Copy Markdown
Collaborator

Summary

Ships the InDesign pipeline as a first-class Aurelius workflow — the user-facing surface (#67) over the parser (#63), PDF ingestion (#64), token mapper (#65), and component generator (#66). This is the closing sub-issue of epic #62.

What's included

Agent — .claude/agents/indesign-to-react.md

Orchestrates the pipeline (validate → parse → map → generate → review → commit), reads the generation report and proposes concrete follow-ups (unmapped frames, font fallbacks, missing alt text, semantic-tag refinements), and is non-destructive (feature branch, never main). Referenced from the agent catalog.

Skill — .claude/skills/indesign-conversion/SKILL.md

When-to-use, prerequisites (exported IDML/PDF), expected outputs, common gotchas (CMYK→sRGB shifts, missing fonts, oversized print images, accessibility gaps), and a runnable worked example against the committed fixture.

CLI — aurelius pipeline indesign

aurelius pipeline indesign brochure.pdf --target react --styling tailwind --output ./src/indesign
  • --target next|vite|astro|react, --styling tailwind|css-modules, --output <dir>, --json
  • Honors aurelius.config.json (indesign section); flags win
  • Writes components + stories + barrel + tokens + extracted assets, and emits both a Markdown and a machine-readable JSON report

Documentation

  • docs/pipelines/indesign.md — exporting from InDesign (IDML & PDF), output, fidelity expectations, accessibility checklist, troubleshooting — linked from the README docs index
  • README Pipelines section now lists InDesign alongside Figma and Canva
  • Counts bumped to 56 agents / 23 skills across all enforced docs; CLAUDE.md catalog + command reference updated

Fixture + CI smoke

  • Committed tests/fixtures/indesign/sample.idml (binary, .gitattributes/.prettierignore handled)
  • An end-to-end smoke test runs the full aurelius pipeline indesign flow against the committed fixture and asserts the generated project builds (strict tsc) and renders (Storybook smoke ≈ react-dom/server). It runs in the existing pipeline-tests CI job.

Acceptance criteria (#67)

  • agents/indesign-to-react.md exists, matches the agent shape, referenced from the agent index
  • skills/indesign-conversion/SKILL.md exists with a runnable example
  • aurelius pipeline indesign --help prints documented usage
  • docs/pipelines/indesign.md published and linked from the docs index
  • README's Pipelines section lists InDesign
  • End-to-end CI smoke against the committed fixture asserts the generated project builds + passes a Storybook (render) smoke

Testing

  • pnpm --filter @aurelius/pipeline typecheck / test / build ✅ — 133 tests (5 new)
  • Repo-wide eslint . (0 errors), prettier --check ., and check-doc-counts (56 agents / 23 skills) ✅; lockfile unchanged
  • Verified the compiled aurelius bin generates a project from the committed fixture

Note on the CI "agent" smoke

A Claude Code agent can't execute in headless CI, so the end-to-end smoke runs the pipeline the agent drives (runPipelineCli) against the committed fixture and verifies build + render — the faithful, deterministic equivalent.

Closes #67
Closes #62

🤖 Generated with Claude Code

Make the InDesign pipeline a first-class Aurelius workflow — the user-facing
surface over the parser, mapper, and generator (#67, part of #62).

- Agent .claude/agents/indesign-to-react.md: orchestrates parse -> tokens ->
  generate on a feature branch, reads the report, proposes follow-ups
- Skill .claude/skills/indesign-conversion/SKILL.md: when-to-use, prerequisites,
  gotchas (CMYK->sRGB, fonts, a11y), and a runnable worked example
- CLI: aurelius pipeline indesign <input> [--target|--styling|--output|--json],
  honoring aurelius.config.json; emits Markdown + JSON reports
- Docs docs/pipelines/indesign.md (exporting, fidelity, a11y checklist,
  troubleshooting); README Pipelines + docs index now list InDesign
- Committed fixture tests/fixtures/indesign/sample.idml + an end-to-end smoke
  test that builds (strict tsc) and renders (storybook smoke) from it in CI
- Bump enforced counts to 56 agents / 23 skills across docs

Refs #67, #62

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@PAMulligan PAMulligan self-assigned this Jun 20, 2026
@PAMulligan PAMulligan added enhancement New feature or request javascript Pull requests that update javascript code pipeline Figma/Canva-to-React conversion pipeline react React-specific functionality labels Jun 20, 2026
@PAMulligan PAMulligan moved this from Todo to Done in PMDS Open Source Roadmap Jun 20, 2026
@PAMulligan PAMulligan added this to the v2.0.0 milestone Jun 20, 2026
@PAMulligan PAMulligan merged commit 1055632 into main Jun 20, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request javascript Pull requests that update javascript code pipeline Figma/Canva-to-React conversion pipeline react React-specific functionality

Projects

Development

Successfully merging this pull request may close these issues.

[InDesign pipeline] Claude Code agent, skill, and documentation for the InDesign-to-React workflow Add InDesign-to-React conversion pipeline

1 participant