Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ Keep static drawings, timelines, and playback responsibilities separate. Preserv

## Typography and records

Use Cal Sans with no added letter-spacing, `font-optical-sizing: auto`, one `GEOM` value per role, and `font-synthesis: none`. Keep text editable and use typeset punctuation (’ – − “ ”).
Use Cal Sans with no added letter-spacing, `font-optical-sizing: auto`, one `GEOM` value per role, and `font-synthesis: none`. The skill’s bundled `skills/plotter/assets/fonts/CalSansVF.woff2` stays identical to `public/fonts/CalSansVF.woff2`. Keep text editable and use typeset punctuation (’ – − “ ”).

Treat coss paths and evaluations under `skills/plotter/references/history/` as historical evidence. Keep current integration paths in `skills/plotter/references/implementation.md`. Report only inspection and verification actually performed; source generation does not establish visual approval.
Skill documents address a stranger’s agent, so maintainer rules belong here. The dated coss review record that lived under `skills/plotter/references/history/` was removed from the tree after commit `37f3464`; read it from git history when tracing an old decision. Keep revision IDs stable unless alternatives are requested. Appearance approval applies to a particular revision; gallery inclusion, production placement, and style-reference selection are separate decisions. `skills/plotter/references/drawings/manifest.json` records the reference snapshots’ source revisions and hashes. Keep current integration paths in [CONTRIBUTING.md](CONTRIBUTING.md#website-integration). Report only inspection and verification actually performed; source generation does not establish visual approval.

<!-- BEGIN:nextjs-agent-rules -->

Expand Down
4 changes: 2 additions & 2 deletions ATTRIBUTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ Extraction baseline: coss commit `54c5a6dd2527d91127bd5efd0dfe2ee055570f27` on `

The extraction preserves the Plotter skill package originally located at `apps/ui/skills/plotter`, the illustration catalogue and related components from `apps/ui/app/plotter`, and the associated generation and export scripts from `apps/ui/scripts`.

The skill’s bundled reference manifest records the source revisions of its approved SVG snapshots. Dated feedback and audits remain under `skills/plotter/references/history/`. Repository paths and routes inside those records describe the original coss context.
The skill’s bundled reference manifest records the source revisions of its approved SVG snapshots. Dated feedback and audits from the coss period were removed from the tree after commit `37f3464` and remain in git history.

## License record

Plotter and its portable skill package use the [MIT license](LICENSE), selected by the maintainer on 2026-11-08. The notices retain the coss.com and Origin UI copyright and add Pasquale Vitiello’s copyright for Plotter. The current coss source also uses MIT.

For historical provenance, the initial extraction carried an AGPL-3.0 root license alongside an MIT declaration in `apps/ui/package.json`. That was the extraction record; the current project and packaged skill licenses are MIT.

Cal Sans is credited to Mark Davis, WORDMARK × Cal.com. The site’s font package and any bundled third-party assets retain their own accompanying license information. Reference images and historical material remain part of the preserved source record.
Cal Sans is credited to Mark Davis, WORDMARK × Cal.com. The skill bundles one copy of the variable font with its SIL Open Font License 1.1 at `skills/plotter/assets/fonts/`. The site’s font package and any bundled third-party assets retain their own accompanying license information. Earlier reference images and review records remain in git history.
38 changes: 32 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Start with the [local setup](README.md#run-the-website) and [repository guidelin
| `content/docs/` | Website documentation |
| `scripts/` | Website adapters, generators, and export scripts |

Edit SVG sources before regenerating drawing components. Foundation runtime data, CSS, and reference tables derive from `standard.json`. Keep approved reference revisions and stable catalogue codes intact; historical records are evidence, not current instructions.
Edit SVG sources before regenerating drawing components. Foundation runtime data, CSS, and reference tables derive from `standard.json`. Keep approved reference revisions and stable catalogue codes intact.

Drawings use a native `560 × 440` viewBox and scale proportionally in the website. Every current illustration uses 1-unit visible strokes. Shared role-token customization currently covers **AGT-01, MEC-05, GEO-11, SYS-06, and CRF-06**. Other drawings retain their authored opacity and dash patterns; uniform width does not imply a catalogue-wide token migration.

Expand All @@ -34,7 +34,7 @@ bun run downloads # Catalogue, downloads, and public

After a shared-standard change, regenerate the drawing components that consume it. After a catalogue change, refresh the bundled catalogue. `bun run build` also refreshes the documentation copies in `public/docs` before building the website.

The [website integration guide](skills/plotter/references/implementation.md) maps individual adapters and export paths. Generation produces files; it does not establish visual correctness.
Generation produces files; it does not establish visual correctness.

Repository previews live in `.github/assets/`. The README’s galleries are in `showcase/`:

Expand All @@ -48,6 +48,32 @@ The fourteen static selections come from the existing [approved reference set](s

These are presentation compositions of the original catalogue SVGs, with unused margins cropped and each drawing scaled proportionally. Preview SVGs outline typography for consistent rendering and have 3200-pixel-wide PNG companions. The **MEC-01** iris GIF is exported at twice its displayed size and has a static SVG fallback for reduced motion. Editable text and drawing sources remain in the catalogue and animation components; refresh these presentation exports when the featured artwork changes, and use new filenames so cached README images do not show the old artwork.

## Website integration

The installed skill does not depend on the website. These paths are relative to the repository root.

| Responsibility | Source |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Gallery SVG wrapper and role-style opt-in | `components/plotter/blueprint-drawing.tsx` |
| Catalogue compiler and SVG serializer | `scripts/build-plotter-drawings.py`, `scripts/plotter_svg.py` |
| Bundled catalogue SVGs and index | `skills/plotter/references/catalogue/`, generated by `scripts/build-plotter-catalogue.tsx` |
| AGT-01 helper-fragment recipe | `skills/plotter/assets/examples/render-registration.mjs` |
| AGT-01 host file adapter | `scripts/build-plotter-registration.mjs` |
| Static MEC-05 and OBJ-05 | `components/plotter/engineering-studies.tsx` |
| MEC-05 shared core hatching | `components/plotter/production-chain-hatching.tsx` |
| MEC-05 and OBJ-05 timelines | `components/plotter/production-chain-motion-drawing.tsx`, `components/plotter/newtons-cradle-motion-drawing.tsx` |
| Engineering playback, fallback, and visibility | `components/plotter/engineering-motion-preview.tsx` |
| Resolved pilot export adapter | `scripts/export-plotter-pilots.tsx` |
| Download artifact generator | `scripts/build-plotter-downloads.tsx` |

`BlueprintDrawing` opts into shared roles with `roles`. The independent highlight-opacity token is used by TIM-01, TIM-03, and TIM-05 without changing their stroke-role adoption. The SVG-to-JSX builder preserves supported root styles, removes standalone fixed ink and the root font family so the gallery inherits its theme and loaded font, and gives repeated definitions local IDs. Font weight, optical sizing, and GEOM settings remain authored. Standalone SVGs retain their own font stack.

Catalogue codes are a three-letter family prefix (`familyPrefix` in `components/plotter/study-types.ts`) and a number, without gaps within a family. A new drawing takes the next number in its family; a retired drawing keeps its code reserved in `retiredStudies`. Keep study IDs stable and keep removed studies out of active metadata.

MEC-05’s static and animated core faces share a hatch component; its carrier frames remain unhatched. Timeline edits preserve the chosen still unless redesign is requested. Grammar isolation keeps focused marks at their original appearance, and supplemental grid segments restore only portions hidden with a form.

`bun scripts/export-plotter-pilots.tsx /tmp/plotter-exports` renders the selected static MEC-05 drawing and sends it, with AGT-01, through the packaged exporter. Neither a resolved static SVG nor an animated HTML file should rely on website imports.

## Formatting and checks

Biome formats handwritten JavaScript/TypeScript, JSON, CSS, Markdown, and YAML: two spaces, 80 columns, double quotes, and trailing commas. Use the recommended Biome editor extension for formatting on save.
Expand All @@ -64,12 +90,12 @@ bun run plotter:check

Formatting does not apply lint fixes. Linting uses Biome’s recommended rules and reports Tailwind class ordering; it is separate from the formatting CI job. Neither fix command enables unsafe fixes.

Generated drawing components, foundation outputs, public assets, and historical records are excluded in `biome.json`. SVG sources and HTML examples are excluded to preserve reference hashes and embedded stylesheet checks. Markdown code blocks stay as authored. Python is outside Biome’s scope.
Generated drawing components, foundation outputs, and public assets are excluded in `biome.json`. SVG sources and HTML examples are excluded to preserve reference hashes and embedded stylesheet checks. Markdown code blocks stay as authored. Python is outside Biome’s scope.

## Review and portable output

Include the brief and relevant before/after drawings when proposing visual changes. Inspect the drawing at its intended size and, for motion, watch a complete cycle and inspect its fallback. Report the review actually performed; sampled frames establish poses, not playback rhythm.
Include the brief and relevant before/after drawings when proposing visual changes. Inspect the drawing at its intended size with `python3 skills/plotter/scripts/render.py` and, for motion, watch a complete cycle and inspect its fallback. Report the review actually performed; sampled frames establish poses, not playback rhythm.

Keep exports independent of the website. Resolved static SVG carries its own appearance and definitions. Standalone animation includes its editable timeline and required local resources, or inlines them in one HTML file. Exact Cal Sans appearance requires the font to be available; SVG text remains editable with a sans-serif fallback.
Keep exports independent of the website. Resolved static SVG carries its own appearance and definitions. Standalone animation includes its editable timeline and required local resources, or inlines them in one HTML file. Exact Cal Sans appearance requires the font to be available; SVG text remains editable with a sans-serif fallback. The skill bundles the font for previews and for exports made with `--embed-font`.

The skill’s historical coss paths and review records remain as provenance. Preserve [ATTRIBUTION.md](ATTRIBUTION.md), [LICENSE](LICENSE), and accompanying third-party license information.
The skill’s dated coss review records were removed from the tree after commit `37f3464` and remain in git history. Preserve [ATTRIBUTION.md](ATTRIBUTION.md), [LICENSE](LICENSE), and accompanying third-party license information.
1 change: 0 additions & 1 deletion biome.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@
"!bun.lock",
"!next-env.d.ts",
"!public",
"!skills/plotter/references/history",
"!skills/plotter/references/catalogue",
"!components/plotter/expanded-studies.tsx",
"!components/plotter/visual-grammar-drawings.tsx",
Expand Down
2 changes: 1 addition & 1 deletion content/docs/drawing.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,6 @@ Download the resolved [AGT-01 registration SVG](/plotter/downloads/agent-registr

## Review the result

Compare the candidate with its chosen reference at the intended size and as a thumbnail. For a revision, compare with the previous drawing too. Inspect the host’s themes and narrow layout when those are part of delivery.
Render the candidate with `python3 scripts/render.py drawing.svg`, adding `--width` for the size it will be shown at and `--theme both` for a dark host. Compare it with its chosen reference at the intended size and as a thumbnail. For a revision, compare with the previous drawing too. Inspect the host’s themes and narrow layout when those are part of delivery.

Confirm that the focal relationship reads, guides remain subordinate, labels have space, transparent forms keep their meaning, and numeric or behavioral claims match their evidence. Deliver the editable source and requested export, naming any visual review that remains pending. Source generation alone does not establish visual approval.
4 changes: 2 additions & 2 deletions content/docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,9 +41,9 @@ For an existing drawing, attach its editable source and describe the change. To

## What you need

Reading the skill and opening its bundled SVGs needs no package manager or website checkout. The registration authoring example uses Node.js; the resolved static SVG exporter uses Python 3. The animation example opens in a modern browser with its packaged local stylesheet.
Reading the skill and opening its bundled SVGs needs no package manager or website checkout. The registration authoring example uses Node.js; the resolved static SVG exporter and the preview renderer use Python 3. The renderer needs a Chromium-based browser such as Chrome, Edge, or Brave, or another SVG renderer such as `rsvg-convert`; without one, the agent delivers the drawing with its visual review marked as pending. The animation example opens in a modern browser with its packaged local stylesheet.

Recipients opening an exported SVG need neither Node.js nor Python. Cal Sans is optional for opening the files; a sans-serif fallback keeps labels editable, while exact text metrics depend on the font being available.
Recipients opening an exported SVG need neither Node.js nor Python. The skill bundles Cal Sans, so previews show the intended typography. A delivered SVG still names the font without containing it: load Cal Sans on your site, or ask for an export with the font embedded (`--embed-font`, about 200 KB). Otherwise labels fall back to a sans-serif and stay editable.

## Run the website

Expand Down
39 changes: 0 additions & 39 deletions design-directions.md

This file was deleted.

Loading
Loading