@mutmutco/pi-plugin 4.3.63 → 4.3.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/package.json +1 -1
  2. package/skills/brand/SKILL.md +74 -0
  3. package/skills/brand/references/logos/mmd-lockup-dark.svg +1 -0
  4. package/skills/brand/references/logos/mmd-lockup-light.svg +1 -0
  5. package/skills/brand/references/logos/mmd-mark-held.svg +1 -0
  6. package/skills/brand/references/logos/mmd-mark.svg +1 -0
  7. package/skills/brand/references/recipes.md +96 -0
  8. package/skills/brand/references/tokens.json +206 -0
  9. package/skills/brand/references/typography-and-layout.md +100 -0
  10. package/skills/mmi-help/SKILL.md +2 -1
  11. package/skills/org-guide/references/getting-started.md +3 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mutmutco/pi-plugin",
3
- "version": "4.3.63",
3
+ "version": "4.3.65",
4
4
  "description": "MMI workflow skills and org gates delivery.",
5
5
  "author": {
6
6
  "name": "MMI Future",
package/skills/brand/SKILL.md ADDED
@@ -0,0 +1,74 @@
1
+ ---
2
+ name: brand
3
+ description: Mutatis Mutandis brand for company documents, reports, decks, and artifacts.
4
+ ---
5
+
6
+ # Mutatis Mutandis brand
7
+
8
+ The visual authority for company-facing documents and generated artifacts. Do not invent a
9
+ second identity, and do not derive one from a screenshot.
10
+
11
+ ## Scope
12
+
13
+ **In scope:** reports, PDFs, one-pagers, briefs, slide decks, data features, printable pages,
14
+ social cards, email signatures, and any artifact an agent generates on the company's behalf.
15
+
16
+ **Out of scope:** a product's own web or application design. A project's UI follows that
17
+ project's design system. This skill never overrides it, and MMD colour variables must not be
18
+ injected into product styles.
19
+
20
+ The source kit is the Mutatis Mutandis Design (MMD) identity carrying the shared company
21
+ foundations. Colour, typography, layout, and voice apply company-wide. Only the logo is
22
+ division-specific.
23
+
24
+ ## Non-negotiable rules
25
+
26
+ - **Masthead.** A company-wide document carries **no logo**. Lead with the organisation name
27
+ set in Archivo Black, then the document title. The MMD tile lockup — black tile, white MM,
28
+ blue D `#3B82F6` — is the Design division's mark and appears only on Design-division
29
+ artifacts. Never restyle the tile for another division, and never recolour the D.
30
+ - **One voice per block.** Pick Instrument, Paper, or Billboard (below) and stay in it.
31
+ Two blocks may use different voices only with an obvious boundary between them.
32
+ - **Type roles are fixed.** Archivo Black for display and major titles. Questrial regular for
33
+ body and secondary headings. Roboto Mono for dates, IDs, counts, and figures.
34
+ - **No synthetic bold, ever.** Archivo Black ships as a heavy Regular; Questrial has no bold.
35
+ Set `font-synthesis: none`. Faking a weight is a visible defect.
36
+ - **Division colours identify, they do not decorate.** Intelligence `#1AA572`,
37
+ Design `#3B82F6`, Creative `#EB4233`, Games `#EAA100`, Strategy `#8B5CF6`. Use them as
38
+ markers and swatches, never as body text.
39
+ - **Banned.** Gradients, emoji, faux bold, coloured-left-border cards, drop shadows for depth,
40
+ and centre-aligned body text. Type is left-aligned; empty space is generous.
41
+ - **Colour never carries meaning alone.** Label every data series directly.
42
+ - **Contrast floors hold.** 4.5:1 for normal text, 3:1 for large text and essential edges.
43
+ Recheck the actual pairing you used; the kit certifies the core inks, not every wash.
44
+ - **Only supplied facts.** No invented figures, promises, Pantone matches, or CMYK recipes.
45
+ Replace every bracketed placeholder before export.
46
+
47
+ ## Choose a voice
48
+
49
+ | Voice | Use for | Ground | Text | Accent |
50
+ | --- | --- | --- | --- | --- |
51
+ | **Instrument** | Tools, dashboards, app-adjacent artifacts | one named theme from [tokens](references/tokens.json) | that theme's `text` | that theme's `accent` |
52
+ | **Paper** | Reports, briefs, printed and print-like documents | stock `#EFE9DD` | body `#3A3024`, headings `#1A140C` | kicker `#9A3B2E`; display hit `#D63F2E` at 24px and above only |
53
+ | **Billboard** | Data features, cover pages, big-figure statements | ground `#060606` | white `#FFFFFF`, muted `#8A8A8A` | hit `#F5E14B` |
54
+
55
+ Paper is the default for a company report. Billboard is for a cover or a single dominant
56
+ figure. Instrument is for anything that sits beside a running product.
57
+
58
+ ## Read one reference
59
+
60
+ | Task | Reference |
61
+ | --- | --- |
62
+ | Exact colours, spacing, radii, themes | [tokens.json](references/tokens.json) |
63
+ | Font loading, type sizes, margins, page and slide geometry, contrast, print | [Typography and layout](references/typography-and-layout.md) |
64
+ | Build a report, one-pager, deck, data feature, social card, or signature | [Recipes](references/recipes.md) |
65
+ | Design-division logo files | [logos/](references/logos) |
66
+
67
+ ## Before you hand over
68
+
69
+ - One voice per block, no mixed palettes.
70
+ - No logo on a company-wide document; MMD lockup only on Design artifacts.
71
+ - Every placeholder replaced, every figure sourced.
72
+ - Fonts loaded, or the substitution disclosed in the handover note.
73
+ - Contrast checked on the pairings actually used.
74
+ - Editable source returned alongside the PDF or PNG.
package/skills/brand/references/logos/mmd-lockup-dark.svg ADDED
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="306" height="48" viewBox="0 0 306 48" role="img" aria-label="Mutatis Mutandis Design"><rect width="48" height="48" rx="10" fill="#FFFFFF"/><g transform="translate(8 8)"><rect width="32" height="32" rx="7" fill="#000000"/><path fill="#FFFFFF" transform="translate(2.5035,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(11.9155,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#3B82F6" transform="translate(21.3275,19.6120) scale(0.01050000, -0.01050000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/></g><path fill="#FFFFFF" transform="translate(60.0000,29.0000) scale(0.01500000, -0.01500000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(74.3100,29.0000) scale(0.01500000, -0.01500000)" d="M417 -12Q253 -12 163.5 62.0Q74 136 74 277V688H295V280Q295 222 326.0 187.5Q357 153 416 153Q475 153 506.5 188.0Q538 223 538 280V688H759V277Q759 136 670.0 62.0Q581 -12 417 -12Z"/><path fill="#FFFFFF" transform="translate(86.9550,29.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#FFFFFF" transform="translate(97.9350,29.0000) scale(0.01500000, -0.01500000)" d="M535 0 506 97H265L236 0H10L261 688H518L769 0ZM311 251H460L388 496H384Z"/><path fill="#FFFFFF" transform="translate(109.7550,29.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#FFFFFF" transform="translate(120.7350,29.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#FFFFFF" transform="translate(126.7200,29.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#FFFFFF" transform="translate(137.7000,29.0000) scale(0.01500000, -0.01500000)" d=""/><path fill="#FFFFFF" transform="translate(142.8450,29.0000) scale(0.01500000, -0.01500000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(157.1550,29.0000) scale(0.01500000, -0.01500000)" d="M417 -12Q253 -12 163.5 62.0Q74 136 74 277V688H295V280Q295 222 326.0 187.5Q357 153 416 153Q475 153 506.5 188.0Q538 223 538 280V688H759V277Q759 136 670.0 62.0Q581 -12 417 -12Z"/><path fill="#FFFFFF" transform="translate(169.8000,29.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#FFFFFF" transform="translate(180.7800,29.0000) scale(0.01500000, -0.01500000)" d="M535 0 506 97H265L236 0H10L261 688H518L769 0ZM311 251H460L388 496H384Z"/><path fill="#FFFFFF" transform="translate(192.6000,29.0000) scale(0.01500000, -0.01500000)" d="M566 0 277 334V0H74V688H267L556 349V688H759V0Z"/><path fill="#FFFFFF" transform="translate(205.2450,29.0000) scale(0.01500000, -0.01500000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/><path fill="#FFFFFF" transform="translate(217.0650,29.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#FFFFFF" transform="translate(223.0500,29.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#FFFFFF" transform="translate(234.0300,29.0000) scale(0.01500000, -0.01500000)" d=""/><path fill="#3B82F6" transform="translate(239.1750,29.0000) scale(0.01500000, -0.01500000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/><path fill="#3B82F6" transform="translate(250.9950,29.0000) scale(0.01500000, -0.01500000)" d="M74 688H669V523H295V428H615V270H295V165H676V0H74Z"/><path fill="#3B82F6" transform="translate(261.9750,29.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#3B82F6" transform="translate(272.9550,29.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#3B82F6" transform="translate(278.9400,29.0000) scale(0.01500000, -0.01500000)" d="M770 439H559Q559 482 521.0 508.5Q483 535 429 535Q351 535 311.0 493.5Q271 452 271 376V312Q271 236 311.0 194.5Q351 153 429 153Q483 153 521.0 178.5Q559 204 559 244H403V384H770V0H656L634 68Q540 -12 388 -12Q217 -12 131.0 77.5Q45 167 45 344Q45 519 142.5 609.5Q240 700 420 700Q519 700 598.0 670.0Q677 640 723.5 581.5Q770 523 770 439Z"/><path fill="#3B82F6" transform="translate(291.5850,29.0000) scale(0.01500000, -0.01500000)" d="M566 0 277 334V0H74V688H267L556 349V688H759V0Z"/></svg>
package/skills/brand/references/logos/mmd-lockup-light.svg ADDED
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="290" height="32" viewBox="0 0 290 32" role="img" aria-label="Mutatis Mutandis Design"><rect width="32" height="32" rx="7" fill="#000000"/><path fill="#FFFFFF" transform="translate(2.5035,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(11.9155,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#3B82F6" transform="translate(21.3275,19.6120) scale(0.01050000, -0.01050000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/><path fill="#000000" transform="translate(44.0000,21.0000) scale(0.01500000, -0.01500000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#000000" transform="translate(58.3100,21.0000) scale(0.01500000, -0.01500000)" d="M417 -12Q253 -12 163.5 62.0Q74 136 74 277V688H295V280Q295 222 326.0 187.5Q357 153 416 153Q475 153 506.5 188.0Q538 223 538 280V688H759V277Q759 136 670.0 62.0Q581 -12 417 -12Z"/><path fill="#000000" transform="translate(70.9550,21.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#000000" transform="translate(81.9350,21.0000) scale(0.01500000, -0.01500000)" d="M535 0 506 97H265L236 0H10L261 688H518L769 0ZM311 251H460L388 496H384Z"/><path fill="#000000" transform="translate(93.7550,21.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#000000" transform="translate(104.7350,21.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#000000" transform="translate(110.7200,21.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#000000" transform="translate(121.7000,21.0000) scale(0.01500000, -0.01500000)" d=""/><path fill="#000000" transform="translate(126.8450,21.0000) scale(0.01500000, -0.01500000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#000000" transform="translate(141.1550,21.0000) scale(0.01500000, -0.01500000)" d="M417 -12Q253 -12 163.5 62.0Q74 136 74 277V688H295V280Q295 222 326.0 187.5Q357 153 416 153Q475 153 506.5 188.0Q538 223 538 280V688H759V277Q759 136 670.0 62.0Q581 -12 417 -12Z"/><path fill="#000000" transform="translate(153.8000,21.0000) scale(0.01500000, -0.01500000)" d="M470 512V0H249V512H23V688H695V512Z"/><path fill="#000000" transform="translate(164.7800,21.0000) scale(0.01500000, -0.01500000)" d="M535 0 506 97H265L236 0H10L261 688H518L769 0ZM311 251H460L388 496H384Z"/><path fill="#000000" transform="translate(176.6000,21.0000) scale(0.01500000, -0.01500000)" d="M566 0 277 334V0H74V688H267L556 349V688H759V0Z"/><path fill="#000000" transform="translate(189.2450,21.0000) scale(0.01500000, -0.01500000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/><path fill="#000000" transform="translate(201.0650,21.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#000000" transform="translate(207.0500,21.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#000000" transform="translate(218.0300,21.0000) scale(0.01500000, -0.01500000)" d=""/><path fill="#3B82F6" transform="translate(223.1750,21.0000) scale(0.01500000, -0.01500000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/><path fill="#3B82F6" transform="translate(234.9950,21.0000) scale(0.01500000, -0.01500000)" d="M74 688H669V523H295V428H615V270H295V165H676V0H74Z"/><path fill="#3B82F6" transform="translate(245.9750,21.0000) scale(0.01500000, -0.01500000)" d="M667 488V476H460V480Q460 510 438.0 530.0Q416 550 371 550Q327 550 303.5 537.0Q280 524 280 505Q280 478 312.0 465.0Q344 452 415 438Q498 421 551.5 402.5Q605 384 645.0 342.0Q685 300 686 228Q686 106 603.5 47.0Q521 -12 383 -12Q222 -12 132.5 42.0Q43 96 43 233H252Q252 181 279.0 163.5Q306 146 363 146Q405 146 432.5 155.0Q460 164 460 192Q460 217 429.5 229.5Q399 242 330 256Q246 274 191.0 293.5Q136 313 95.0 358.0Q54 403 54 480Q54 593 141.5 646.5Q229 700 363 700Q495 700 580.0 646.5Q665 593 667 488Z"/><path fill="#3B82F6" transform="translate(256.9550,21.0000) scale(0.01500000, -0.01500000)" d="M84 0V688H305V0Z"/><path fill="#3B82F6" transform="translate(262.9400,21.0000) scale(0.01500000, -0.01500000)" d="M770 439H559Q559 482 521.0 508.5Q483 535 429 535Q351 535 311.0 493.5Q271 452 271 376V312Q271 236 311.0 194.5Q351 153 429 153Q483 153 521.0 178.5Q559 204 559 244H403V384H770V0H656L634 68Q540 -12 388 -12Q217 -12 131.0 77.5Q45 167 45 344Q45 519 142.5 609.5Q240 700 420 700Q519 700 598.0 670.0Q677 640 723.5 581.5Q770 523 770 439Z"/><path fill="#3B82F6" transform="translate(275.5850,21.0000) scale(0.01500000, -0.01500000)" d="M566 0 277 334V0H74V688H267L556 349V688H759V0Z"/></svg>
package/skills/brand/references/logos/mmd-mark-held.svg ADDED
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Mutatis Mutandis Design"><rect width="48" height="48" rx="10" fill="#FFFFFF"/><g transform="translate(8 8)"><rect width="32" height="32" rx="7" fill="#000000"/><path fill="#FFFFFF" transform="translate(2.5035,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(11.9155,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#3B82F6" transform="translate(21.3275,19.6120) scale(0.01050000, -0.01050000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/></g></svg>
package/skills/brand/references/logos/mmd-mark.svg ADDED
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32" role="img" aria-label="Mutatis Mutandis Design"><rect width="32" height="32" rx="7" fill="#000000"/><path fill="#FFFFFF" transform="translate(2.5035,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#FFFFFF" transform="translate(11.9155,19.6120) scale(0.01050000, -0.01050000)" d="M665 0V248Q665 294 668.5 342.5Q672 391 676.0 424.0Q680 457 681 466H677L550 0H377L249 465H245Q246 456 250.5 423.5Q255 391 259.0 342.5Q263 294 263 248V0H60V688H372L476 291H480L583 688H884V0Z"/><path fill="#3B82F6" transform="translate(21.3275,19.6120) scale(0.01050000, -0.01050000)" d="M733 344Q733 0 372 0H74V688H372Q733 688 733 344ZM295 165H368Q507 165 507 314V374Q507 523 368 523H295Z"/></svg>
package/skills/brand/references/recipes.md ADDED
@@ -0,0 +1,96 @@
1
+ # Recipes
2
+
3
+ Worked use cases. Each names the voice, the masthead, and what to hand back.
4
+
5
+ ## 1. Company report or PDF
6
+
7
+ Voice **Paper**. Masthead: organisation name in Archivo Black, no logo. Cover may switch to
8
+ **Billboard** if it carries one dominant figure — that is a separate block, so the boundary is
9
+ the page edge.
10
+
11
+ Structure: cover, one-paragraph summary, then sections at 16pt headings. Figures in Roboto
12
+ Mono. Source line for every number. Date and document ID in mono metadata at 13pt.
13
+
14
+ Generate HTML and print to PDF. Skeleton:
15
+
16
+ ```html
17
+ <!doctype html>
18
+ <html lang="en">
19
+ <head>
20
+ <meta charset="utf-8">
21
+ <title>[Report title]</title>
22
+ <link href="https://fonts.googleapis.com/css2?family=Archivo+Black&family=Questrial&family=Roboto+Mono:wght@400;500&display=swap" rel="stylesheet">
23
+ <style>
24
+ @page{size:A4 portrait;margin:20mm}
25
+ :root{font-synthesis:none;--display:"Archivo Black","Arial Black",sans-serif;
26
+ --sans:Questrial,Arial,sans-serif;--mono:"Roboto Mono","Courier New",monospace;
27
+ --stock:#EFE9DD;--ink:#1A140C;--body:#3A3024;--kicker:#9A3B2E}
28
+ body{background:var(--stock);color:var(--body);font-family:var(--sans);
29
+ font-size:11pt;line-height:1.5;margin:0}
30
+ .org{font-family:var(--display);font-size:14pt;color:var(--ink);letter-spacing:.005em}
31
+ h1{font-family:var(--display);font-size:24pt;line-height:1.1;color:var(--ink);margin:8mm 0 4mm}
32
+ h2{font-size:16pt;font-weight:400;line-height:1.2;color:var(--ink);margin:10mm 0 3mm}
33
+ .meta{font-family:var(--mono);font-size:9pt;color:var(--kicker)}
34
+ .figure{font-family:var(--mono);font-size:11pt}
35
+ table{border-collapse:collapse;width:100%}
36
+ th{text-align:left;font-weight:400;border-bottom:2px solid var(--ink);padding:2mm 0}
37
+ td{border-bottom:1px solid #D4D1C7;padding:2mm 0}
38
+ </style>
39
+ </head>
40
+ <body>
41
+ <div class="org">Mutatis Mutandis</div>
42
+ <h1>[Report title]</h1>
43
+ <p class="meta">[YYYY-MM-DD] · [DOC-ID]</p>
44
+ <h2>[Section]</h2>
45
+ <p>[Body]</p>
46
+ </body>
47
+ </html>
48
+ ```
49
+
50
+ Hand back: the HTML and the PDF.
51
+
52
+ ## 2. One-pager or brief
53
+
54
+ Voice **Paper**. One page, A4, 20mm margins. Title at 24pt, a two-line standfirst, then at most
55
+ three sections. No table of contents, no cover. Left-aligned throughout, generous empty space
56
+ at the foot — do not fill the page for the sake of filling it.
57
+
58
+ ## 3. Slide deck
59
+
60
+ Voice **Billboard** for title and section slides, **Paper** or **Instrument** for content —
61
+ switch only at a slide boundary. 16:9. Titles 32–42pt in Archivo Black, body 20–24pt Questrial,
62
+ figures in Roboto Mono. One idea per slide. No bullet nesting past one level. Keep content
63
+ clear of the outer 5% of the frame.
64
+
65
+ Hand back: the editable deck plus a PDF for faithful viewing.
66
+
67
+ ## 4. Data feature or cover figure
68
+
69
+ Voice **Billboard**. Ground `#060606`, figure in white at the largest size the frame allows,
70
+ label in muted `#8A8A8A`, one accent in hit `#F5E14B` — one accent, not three. Rule lines in
71
+ muted, 1px. Label every series directly on the chart; a colour key alone is not labelling.
72
+ Axis and tick text in Roboto Mono.
73
+
74
+ ## 5. Social card
75
+
76
+ Voice **Paper** or **Billboard**. 1080 × 1080 square or 1080 × 1350 portrait. Key text at least
77
+ 64px from every edge. Display copy may be uppercase; body copy may not. Check the destination
78
+ platform's crop before export. Export PNG, and hand back the editable SVG with it.
79
+
80
+ ## 6. Email signature
81
+
82
+ Live text only — Arial, no webfont, no remote image. Name, role, contact. Replace both the
83
+ visible contact text and the `mailto:` target. Test by sending to yourself. If a logo is
84
+ wanted, insert the PNG through the mail client's own signature editor.
85
+
86
+ ## 7. Reviewing someone else's artifact
87
+
88
+ Check in this order, and report findings as a short list:
89
+
90
+ 1. Logo: is an MMD lockup on a company-wide document that should carry none?
91
+ 2. Voice: two palettes mixed inside one block?
92
+ 3. Type: any faked bold, any Questrial heading pretending to be heavy?
93
+ 4. Colour: a division hue used as body text, or colour carrying meaning alone?
94
+ 5. Banned styling: gradients, emoji, coloured-left-border cards, centred body text?
95
+ 6. Contrast: measure the pairings actually used, not the ones intended.
96
+ 7. Placeholders: any bracketed text left in the export?
package/skills/brand/references/tokens.json ADDED
@@ -0,0 +1,206 @@
1
+ {
2
+ "source": "https://claude.ai/artifact/1BtZiyMGXN8myPepBETNRh",
3
+ "retrieved": "2026-09-17",
4
+ "brand": {
5
+ "ink": "#000000",
6
+ "paper": "#FFFFFF",
7
+ "off-paper": "#F4F3EF",
8
+ "off-ink": "#121212",
9
+ "yellow": "#F5E14B",
10
+ "red": "#E5352B",
11
+ "blue": "#2B4BE5",
12
+ "green": "#1F8A5E"
13
+ },
14
+ "divisions": {
15
+ "Intelligence": "#1AA572",
16
+ "Design": "#3B82F6",
17
+ "Creative": "#EB4233",
18
+ "Games": "#EAA100",
19
+ "Strategy": "#8B5CF6"
20
+ },
21
+ "paper": {
22
+ "stock": "#EFE9DD",
23
+ "ink": "#1A140C",
24
+ "kicker": "#9A3B2E",
25
+ "hit": "#D63F2E",
26
+ "body": "#3A3024"
27
+ },
28
+ "billboard": {
29
+ "ground": "#060606",
30
+ "ink": "#FFFFFF",
31
+ "muted": "#8A8A8A",
32
+ "hit": "#F5E14B"
33
+ },
34
+ "neutral": [
35
+ "#F7F6F2",
36
+ "#EAE8E1",
37
+ "#D4D1C7",
38
+ "#B8B4A6",
39
+ "#8F8B7D",
40
+ "#6A6758",
41
+ "#4A483D",
42
+ "#2E2D26",
43
+ "#1A1A16",
44
+ "#0A0A08"
45
+ ],
46
+ "entity": [
47
+ "#1FD18A",
48
+ "#3B9DFF",
49
+ "#FFD93D",
50
+ "#6C5CE7",
51
+ "#FF6B6B",
52
+ "#00E5CC",
53
+ "#FF9F40",
54
+ "#EB4233"
55
+ ],
56
+ "spacing": [
57
+ 0,
58
+ 4,
59
+ 8,
60
+ 12,
61
+ 16,
62
+ 24,
63
+ 32,
64
+ 48,
65
+ 64,
66
+ 96,
67
+ 128
68
+ ],
69
+ "radius": {
70
+ "r-0": 0,
71
+ "r-1": 2,
72
+ "r-2": 6,
73
+ "r-3": 12,
74
+ "r-4": 20,
75
+ "r-pill": 999
76
+ },
77
+ "durationMs": [
78
+ 110,
79
+ 180,
80
+ 240,
81
+ 600
82
+ ],
83
+ "themes": {
84
+ "default": {
85
+ "bg": "#FFFFFF",
86
+ "surface": "#FFFFFF",
87
+ "text": "#111111",
88
+ "text-muted": "#333333",
89
+ "accent": "#0A6D4A",
90
+ "coral": "#A83535",
91
+ "yellow": "#765C00",
92
+ "purple": "#5647C9",
93
+ "blue": "#2D619E",
94
+ "success": "#0A6D4A",
95
+ "warn": "#805800",
96
+ "error": "#AD2E2E",
97
+ "info": "#2761A0"
98
+ },
99
+ "p-studio": {
100
+ "bg": "#070707",
101
+ "surface": "#161616",
102
+ "text": "#EDEDED",
103
+ "text-muted": "#8A8A8A",
104
+ "accent": "#1FD18A",
105
+ "coral": "#FF6B6B",
106
+ "yellow": "#FFD93D",
107
+ "purple": "#9B90EF",
108
+ "blue": "#3C9EFF",
109
+ "success": "#1FD18A",
110
+ "warn": "#FFC53D",
111
+ "error": "#FF6565",
112
+ "info": "#3C9EFF"
113
+ },
114
+ "p-void": {
115
+ "bg": "#050510",
116
+ "surface": "#12122A",
117
+ "text": "#E8E8F0",
118
+ "text-muted": "#8888A6",
119
+ "accent": "#00FF88",
120
+ "coral": "#FF5C84",
121
+ "yellow": "#FFEE00",
122
+ "purple": "#B77EFF",
123
+ "blue": "#00CCFF",
124
+ "success": "#1FD18A",
125
+ "warn": "#FFC53D",
126
+ "error": "#FF6060",
127
+ "info": "#3B9DFF"
128
+ },
129
+ "p-ember": {
130
+ "bg": "#0F0805",
131
+ "surface": "#1E1410",
132
+ "text": "#F5E6D8",
133
+ "text-muted": "#9C8472",
134
+ "accent": "#FF6F0E",
135
+ "coral": "#FF6784",
136
+ "yellow": "#FFAA00",
137
+ "purple": "#FF69B4",
138
+ "blue": "#4ECDC4",
139
+ "success": "#1FD18A",
140
+ "warn": "#FFC53D",
141
+ "error": "#FF6B6B",
142
+ "info": "#3B9DFF"
143
+ },
144
+ "p-deepsea": {
145
+ "bg": "#060D1A",
146
+ "surface": "#0E1A2E",
147
+ "text": "#D4E5F7",
148
+ "text-muted": "#6A8AA8",
149
+ "accent": "#00E5CC",
150
+ "coral": "#FF7EB3",
151
+ "yellow": "#7DFFC7",
152
+ "purple": "#9F94FF",
153
+ "blue": "#00B4FF",
154
+ "success": "#1FD18A",
155
+ "warn": "#FFC53D",
156
+ "error": "#FF6B6B",
157
+ "info": "#4AA4FF"
158
+ },
159
+ "p-pastel": {
160
+ "bg": "#0D0D0D",
161
+ "surface": "#1C1C1C",
162
+ "text": "#EBEBEB",
163
+ "text-muted": "#8C8C8C",
164
+ "accent": "#B8D4E3",
165
+ "coral": "#F2A7C3",
166
+ "yellow": "#F5E6A3",
167
+ "purple": "#C3A6F2",
168
+ "blue": "#A3E8D0",
169
+ "success": "#1FD18A",
170
+ "warn": "#FFC53D",
171
+ "error": "#FF7777",
172
+ "info": "#4CA6FF"
173
+ },
174
+ "p-uv": {
175
+ "bg": "#0D0015",
176
+ "surface": "#1A0A2E",
177
+ "text": "#F0E6FF",
178
+ "text-muted": "#9B7DCF",
179
+ "accent": "#E45BFC",
180
+ "coral": "#00FFFF",
181
+ "yellow": "#FFD700",
182
+ "purple": "#CE6DFF",
183
+ "blue": "#40E0FF",
184
+ "success": "#1FD18A",
185
+ "warn": "#FFC53D",
186
+ "error": "#FF5D5D",
187
+ "info": "#3B9DFF"
188
+ },
189
+ "light": {
190
+ "bg": "#FAFAFA",
191
+ "surface": "#FFFFFF",
192
+ "text": "#0F0F0F",
193
+ "text-muted": "#6B6B6B",
194
+ "accent": "#0A6948",
195
+ "coral": "#A33434",
196
+ "yellow": "#735A00",
197
+ "purple": "#5647C9",
198
+ "blue": "#2C5F97",
199
+ "success": "#0A6948",
200
+ "warn": "#7C5600",
201
+ "error": "#A82D2D",
202
+ "info": "#255F9A"
203
+ }
204
+ },
205
+ "scope": "Portable core subset, not a replacement for the full source component library."
206
+ }
package/skills/brand/references/typography-and-layout.md ADDED
@@ -0,0 +1,100 @@
1
+ # Typography, layout, and production
2
+
3
+ Exact values. Where a channel is not listed, follow the document column and say what you
4
+ adapted.
5
+
6
+ ## Fonts
7
+
8
+ Three faces, three jobs:
9
+
10
+ | Role | Face | Weight | Fallback |
11
+ | --- | --- | --- | --- |
12
+ | Display, major titles | Archivo Black | native Regular (heavy by design) | Arial Black |
13
+ | Body, secondary headings | Questrial | 400 only | Arial |
14
+ | Dates, IDs, counts, figures | Roboto Mono | 400; 500 for inline emphasis | Courier New |
15
+
16
+ All three are open-licence Google Fonts. In generated HTML, load them from Google Fonts and
17
+ set `font-synthesis: none`:
18
+
19
+ ```html
20
+ <link rel="preconnect" href="https://fonts.googleapis.com">
21
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
22
+ <link href="https://fonts.googleapis.com/css2?family=Archivo+Black&family=Questrial&family=Roboto+Mono:wght@400;500&display=swap" rel="stylesheet">
23
+ ```
24
+
25
+ ```css
26
+ :root{
27
+ font-synthesis:none;
28
+ --font-display:"Archivo Black","Arial Black",sans-serif;
29
+ --font-sans:Questrial,Arial,sans-serif;
30
+ --font-mono:"Roboto Mono","Courier New",monospace;
31
+ }
32
+ ```
33
+
34
+ When the environment is offline or the renderer cannot load a webfont, use the fallback column
35
+ and **state the substitution in the handover note**, then recheck line breaks — Arial sets
36
+ shorter than Questrial. Outlined SVG logos need no fonts at all.
37
+
38
+ ## Digital type scale
39
+
40
+ | Element | Size | Line height | Face |
41
+ | --- | --- | --- | --- |
42
+ | h1 | `clamp(32px, 5vw, 48px)` | 1.1 | display |
43
+ | h2 | 32px | 1.1 | sans |
44
+ | h3 | 24px | 1.25 | sans |
45
+ | body | 16px | 1.5 | sans |
46
+ | metadata | 13px | 1.3 | mono |
47
+
48
+ Links take the voice's accent with an underline. Focus rings are a 2px accent outline at 2px
49
+ offset. Respect `prefers-reduced-motion`. Motion durations, when used at all: 110, 180, 240,
50
+ 600 ms.
51
+
52
+ ## Channel geometry
53
+
54
+ | Channel | Page | Title | Headings | Body | Margins |
55
+ | --- | --- | --- | --- | --- | --- |
56
+ | Document, report, PDF | A4 portrait, white paper | 24pt | 16pt section | 11pt | 20mm |
57
+ | Slides | 16:9 | 32–42pt | — | 20–24pt | keep clear of the outer 5% |
58
+ | Social square | 1080 × 1080 | — | — | — | key text 64px from every edge |
59
+ | Social portrait | 1080 × 1350 | — | — | — | key text 64px from every edge |
60
+ | Email signature | live system text, no remote images | — | — | — | — |
61
+
62
+ Check the target platform's crop before shipping a social card. An email signature uses live
63
+ Arial text; attach a PNG logo through the mail client rather than hotlinking one.
64
+
65
+ ## Spacing and radii
66
+
67
+ Spacing steps, in px: 0, 4, 8, 12, 16, 24, 32, 48, 64, 96, 128. Use them; do not interpolate.
68
+
69
+ Radii: `r-0` 0, `r-1` 2, `r-2` 6, `r-3` 12, `r-4` 20, pill 999. Documents and reports sit at
70
+ 0–6. Nothing in a report needs a pill.
71
+
72
+ ## Icons and imagery
73
+
74
+ One outlined icon family throughout: 24px canvas, 2px stroke, round ends. The company icon
75
+ library is not bundled — pick one open outlined set per artifact and keep it consistent.
76
+ People take circular avatars; organisations take rounded-square avatars.
77
+
78
+ ## Accessibility
79
+
80
+ - Normal text 4.5:1. Large text and essential control edges 3:1.
81
+ - The core theme inks were verified against each theme's `bg` and `surface` — 176 pairings, all
82
+ at or above 4.5:1. Mixed washes, interaction states, and chart pairings were **not** verified:
83
+ check the pairing you actually used.
84
+ - Division hues may fail normal-text contrast on white. Put a dark label beside the swatch.
85
+ - Keep visible keyboard focus and 44px touch targets on anything interactive.
86
+ - Let prose wrap. Ellipsis truncation is only for a constrained single-line label that has an
87
+ accessible full label.
88
+
89
+ ## Writing
90
+
91
+ Precise, confident, understated. Short statements and specific figures. No invented promises.
92
+ Uppercase is for short display copy and labels, never paragraphs. Set the content language
93
+ explicitly, and respect Turkish casing: i/İ and ı/I.
94
+
95
+ ## Print
96
+
97
+ These are RGB masters, not press-ready artwork. For anything going on a press: use the
98
+ printer's output profile, approve a physical proof, and do not invent a Pantone or CMYK match.
99
+ Logo working minimum is a 32px tile digitally or 8mm in print, validated at actual size, with
100
+ clear space of a quarter of the tile width.
package/skills/mmi-help/SKILL.md CHANGED
@@ -18,7 +18,8 @@ Print a friendly, human-readable **MMI help** card of at most 180 words:
18
18
  2. Show the npm install command, `mmi-hub install`, and the read-only `mmi-hub status` check.
19
19
  3. Summarize the essentials: automatic updates, vault/keyless secrets, no repository environment
20
20
  files or personal agent instructions, and approved MMI release workflows.
21
- 4. Name the org-guide skill for details and board, secrets, stage, and release for common tasks.
21
+ 4. Name the org-guide skill for details, board, secrets, stage, and release for common tasks, and
22
+ brand when a company document, report, deck, or artifact needs the house identity.
22
23
  Render invocation syntax for the current host only, using the forms above with the skill name
23
24
  substituted. If the host is unknown, use plain skill names rather than guessing.
24
25
 
package/skills/org-guide/references/getting-started.md CHANGED
@@ -17,7 +17,9 @@ Do not edit plugin caches or installation records by hand.
17
17
  Complete the host's trust and reload step: reload plugins or restart Claude Code, restart Codex,
18
18
  reload the Cursor window, restart JervCode, or start a fresh Hermes process. An existing session
19
19
  may still hold the old skill catalog until then. The updater manages the MMI plugin on each
20
- supported host present on the machine; it does not grant repository or vault access.
20
+ supported host present on the machine, and on Hermes that means every profile home as well as the
21
+ default one; each running profile needs its own fresh process. It does not grant repository or
22
+ vault access.
21
23
 
22
24
  Authenticate GitHub for your assigned repository. In its checkout, run `mmi-cli onboard` for
23
25
  readiness and `mmi-cli oracle board read` for work. Use `mmi-cli commands --json` to discover routes