{
  "name": "twin3 Design Guidelines",
  "version": "2.2",
  "updated": "2026-09-27",
  "canonical": "https://communication.twin3.ai/",
  "markdown": "https://communication.twin3.ai/design.md",
  "agent_index": "https://communication.twin3.ai/llms.txt",
  "philosophy": {
    "twin": {
      "meaning": "Two sides born together; each gives the other its shape.",
      "zh": "雙生",
      "pairs": [
        {
          "en": [
            "Physical",
            "Imaginary"
          ],
          "zh": [
            "實",
            "虛"
          ],
          "reading": "An object and its reflection"
        },
        {
          "en": [
            "Stillness",
            "Motion"
          ],
          "zh": [
            "靜",
            "動"
          ],
          "reading": "The same form at rest and in flight"
        },
        {
          "en": [
            "Complete",
            "Abstract"
          ],
          "zh": [
            "完整",
            "抽象"
          ],
          "reading": "Every detail, and the essence behind it"
        },
        {
          "en": [
            "Square",
            "Circle"
          ],
          "zh": [
            "方",
            "圓"
          ],
          "reading": "One shape: half rule, half flow"
        },
        {
          "en": [
            "Human",
            "Agent"
          ],
          "zh": [
            "人",
            "代理"
          ],
          "reading": "A person and the twin that acts for them"
        }
      ]
    },
    "mark_anatomy": [
      {
        "element": "forest half",
        "color": "#28382D",
        "means": "physical world: rooted, still, complete",
        "zh": "實"
      },
      {
        "element": "cream half",
        "color": "#E5DEC4",
        "means": "imaginary world: light, moving, abstract",
        "zh": "虛"
      },
      {
        "element": "circle",
        "means": "compass: continuity, wholeness, the human",
        "zh": "規"
      },
      {
        "element": "squares",
        "means": "set square: rules, structure, the machine; each half carries a seed of its twin",
        "zh": "矩"
      },
      {
        "element": "centre seed",
        "means": "the one: origin and interface of exchange",
        "zh": "一"
      }
    ],
    "genesis": [
      {
        "en": "One",
        "zh": "一"
      },
      {
        "en": "One begets two",
        "zh": "一生二",
        "is": "twin"
      },
      {
        "en": "Two beget three",
        "zh": "二生三",
        "is": "twin3, the bond between human and agent"
      },
      {
        "en": "Three beget all things",
        "zh": "三生萬物",
        "is": "xHuman.ID, xAgent.ID, TCG cards, SDK, every agent"
      }
    ],
    "principles": [
      "Pair, don't divide",
      "Carry the seed",
      "Circles for people, squares for machines",
      "Grow from the centre"
    ]
  },
  "tokens": {
    "color": {
      "bg": "#F7F7F4",
      "bg-sub": "#F2F1ED",
      "bg-raise": "#EDECE8",
      "chip": "#E1E0DB",
      "ink": "#26251E",
      "ink2": "#55544D",
      "muted": "#787771",
      "green": "#3B9878",
      "blue": "#3F6FD8",
      "accent": "#F54E00",
      "allow": "#10B981",
      "ask": "#F59E0B",
      "deny": "#EF4444",
      "mark-forest": "#28382D",
      "mark-cream": "#E5DEC4"
    },
    "font": {
      "sans": "Geist",
      "mono": "Geist Mono"
    },
    "css": "https://communication.twin3.ai/assets/twin3-tokens.css"
  },
  "mark": {
    "svg": "https://communication.twin3.ai/assets/twin3-logo.svg",
    "avatar_svg": "https://communication.twin3.ai/assets/twin3-logo-avatar.svg",
    "variants": [
      "standard",
      "reversed",
      "mirrored",
      "ink",
      "white"
    ],
    "clear_space": "one inner square (15% of mark width)",
    "min_size": {
      "screen_px": 16,
      "print_mm": 6
    },
    "do": [
      "mirrored mark on split forest/cream fields",
      "reversed mark on forest or dark photos",
      "physical (forest) on the left"
    ],
    "dont": [
      "recolour",
      "rotate",
      "stretch",
      "outline, shadow or gradient",
      "separate halves or remove squares or seed"
    ]
  },
  "brands": {
    "xHuman.ID": {
      "role": "Personal Agent",
      "color": "#3B9878",
      "glow": "#65DFB4",
      "chain": "BNB Chain",
      "logo_svg": "https://communication.twin3.ai/assets/brands/xhuman-id/logo.svg",
      "logo_png": "https://communication.twin3.ai/assets/brands/xhuman-id/logo.png",
      "logo_reversed_svg": "https://communication.twin3.ai/assets/brands/xhuman-id/logo-reversed.svg",
      "logo_reversed_png": "https://communication.twin3.ai/assets/brands/xhuman-id/logo-reversed.png",
      "square_mark_status": "not_published",
      "brand_kit": "https://communication.twin3.ai/assets/brands/xhuman-id-brand-kit.zip",
      "card": {
        "front": "https://communication.twin3.ai/assets/brands/xhuman-id/card-front.jpg",
        "back": "https://communication.twin3.ai/assets/brands/xhuman-id/card-back.jpg",
        "front_content": "portrait, display name, handle, tagline, Human Score 0-255",
        "back_content": "human record, permissions, linked profiles, JSON/LLM/policy"
      }
    },
    "xAgent.ID": {
      "role": "Business Agent",
      "color": "#3F6FD8",
      "glow": "#38BDF8",
      "chain": "Base",
      "logo_svg": "https://communication.twin3.ai/assets/brands/xagent-id/logo.svg",
      "logo_png": "https://communication.twin3.ai/assets/brands/xagent-id/logo.png",
      "logo_reversed_svg": "https://communication.twin3.ai/assets/brands/xagent-id/logo-reversed.svg",
      "logo_reversed_png": "https://communication.twin3.ai/assets/brands/xagent-id/logo-reversed.png",
      "square_mark_status": "not_published",
      "brand_kit": "https://communication.twin3.ai/assets/brands/xagent-id-brand-kit.zip",
      "card": {
        "front": "https://communication.twin3.ai/assets/brands/xagent-id/card-front.png",
        "back": "https://communication.twin3.ai/assets/brands/xagent-id/card-back.png",
        "front_content": "claim status, LEI status, company name, website, agent ID",
        "back_content": "AI-readable assets and their status",
        "skin": "surface takes the company brand colour; layout, type and zones fixed"
      }
    },
    "rules": {
      "do": [
        "same height side by side (shared 38px cap-height)",
        "green for people, blue for businesses",
        "keep three zones and 5:7 ratio",
        "reversed wordmark on dark"
      ],
      "dont": [
        "swap brand colours or use twin3 forest/cream in badges",
        "re-set the wordmark or drop the ID badge",
        "crop to other ratios or round beyond 14px",
        "present unclaimed business cards as endorsements"
      ]
    },
    "card_embed": {
      "html": "<div data-company-card data-host=\"example.com\"></div>",
      "script": "https://xagent.id/assets/company-card-embed.js",
      "events": {
        "request_flip": "xagent-card:flip",
        "flipped": "xagent-card:flipped"
      },
      "rule": "one official embed on every site; never copy card code or data"
    }
  },
  "tcg_card": {
    "print_mm": [
      63.5,
      88.9
    ],
    "css_px": [
      340,
      476
    ],
    "aspect_ratio": "2.5 / 3.5",
    "radius_px": 14,
    "spec": "https://communication.twin3.ai/assets/tcg-card-specification.txt",
    "css": "https://communication.twin3.ai/assets/tcg-card.css"
  },
  "media_kits": {
    "social": {
      "zip": "https://communication.twin3.ai/assets/media/twin3-social-kit.zip",
      "files": [
        "https://communication.twin3.ai/assets/media/social/README.md",
        "https://communication.twin3.ai/assets/media/social/instagram-post-1080x1080.png",
        "https://communication.twin3.ai/assets/media/social/instagram-post-1080x1080.svg",
        "https://communication.twin3.ai/assets/media/social/instagram-story-1080x1920.png",
        "https://communication.twin3.ai/assets/media/social/instagram-story-1080x1920.svg",
        "https://communication.twin3.ai/assets/media/social/linkedin-banner-1584x396.png",
        "https://communication.twin3.ai/assets/media/social/linkedin-banner-1584x396.svg",
        "https://communication.twin3.ai/assets/media/social/og-card-1200x630.png",
        "https://communication.twin3.ai/assets/media/social/og-card-1200x630.svg",
        "https://communication.twin3.ai/assets/media/social/x-header-1500x500.png",
        "https://communication.twin3.ai/assets/media/social/x-header-1500x500.svg"
      ]
    },
    "presentation": {
      "zip": "https://communication.twin3.ai/assets/media/twin3-presentation-kit.zip",
      "files": [
        "https://communication.twin3.ai/assets/media/presentation/README.md",
        "https://communication.twin3.ai/assets/media/presentation/slide-closing-1920x1080.png",
        "https://communication.twin3.ai/assets/media/presentation/slide-closing-1920x1080.svg",
        "https://communication.twin3.ai/assets/media/presentation/slide-section-1920x1080.png",
        "https://communication.twin3.ai/assets/media/presentation/slide-section-1920x1080.svg",
        "https://communication.twin3.ai/assets/media/presentation/slide-title-1920x1080.png",
        "https://communication.twin3.ai/assets/media/presentation/slide-title-1920x1080.svg"
      ]
    },
    "video": {
      "zip": "https://communication.twin3.ai/assets/media/twin3-video-kit.zip",
      "files": [
        "https://communication.twin3.ai/assets/media/video/README.md",
        "https://communication.twin3.ai/assets/media/video/end-card-1920x1080.png",
        "https://communication.twin3.ai/assets/media/video/end-card-1920x1080.svg",
        "https://communication.twin3.ai/assets/media/video/lower-third-1920x1080.png",
        "https://communication.twin3.ai/assets/media/video/lower-third-1920x1080.svg",
        "https://communication.twin3.ai/assets/media/video/watermark-256.png",
        "https://communication.twin3.ai/assets/media/video/watermark-256.svg"
      ]
    },
    "print": {
      "zip": "https://communication.twin3.ai/assets/media/twin3-print-kit.zip",
      "files": [
        "https://communication.twin3.ai/assets/media/print/README.md",
        "https://communication.twin3.ai/assets/media/print/business-card-back-96x60mm.png",
        "https://communication.twin3.ai/assets/media/print/business-card-back-96x60mm.svg",
        "https://communication.twin3.ai/assets/media/print/business-card-front-96x60mm.png",
        "https://communication.twin3.ai/assets/media/print/business-card-front-96x60mm.svg",
        "https://communication.twin3.ai/assets/media/print/letterhead-a4.png",
        "https://communication.twin3.ai/assets/media/print/letterhead-a4.svg",
        "https://communication.twin3.ai/assets/media/print/sticker-64mm.png",
        "https://communication.twin3.ai/assets/media/print/sticker-64mm.svg"
      ]
    },
    "web": {
      "zip": "https://communication.twin3.ai/assets/media/twin3-web-kit.zip",
      "files": [
        "https://communication.twin3.ai/assets/media/web/README.md",
        "https://communication.twin3.ai/assets/media/web/avatar-2048.png",
        "https://communication.twin3.ai/assets/media/web/email-signature.html",
        "https://communication.twin3.ai/assets/media/web/favicon-16.png",
        "https://communication.twin3.ai/assets/media/web/favicon-180.png",
        "https://communication.twin3.ai/assets/media/web/favicon-192.png",
        "https://communication.twin3.ai/assets/media/web/favicon-32.png",
        "https://communication.twin3.ai/assets/media/web/favicon-48.png",
        "https://communication.twin3.ai/assets/media/web/favicon-512.png",
        "https://communication.twin3.ai/assets/media/web/favicon.ico",
        "https://communication.twin3.ai/assets/media/web/twin3-mark-ink.svg",
        "https://communication.twin3.ai/assets/media/web/twin3-mark-mirrored.svg",
        "https://communication.twin3.ai/assets/media/web/twin3-mark-reversed.svg",
        "https://communication.twin3.ai/assets/media/web/twin3-mark-standard.svg",
        "https://communication.twin3.ai/assets/media/web/twin3-mark-white.svg"
      ]
    }
  },
  "media_kit_all": "https://communication.twin3.ai/assets/media/twin3-media-kit-all.zip"
}