blun-king-cli 9.1.62 → 9.1.63
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.
- package/bin/context-performance-policy.cjs +18 -0
- package/bin/launcher-runtime.js +2 -2
- package/bin/package-regression-policy.cjs +77 -0
- package/bin/provider-idle-timeout-policy.cjs +14 -0
- package/bin/skill-listing-performance-policy.cjs +33 -0
- package/bin/standard-tools-bootstrap.js +80 -26
- package/bin/turn-thinking-policy.cjs +66 -0
- package/bin/turn-tool-performance-policy.cjs +141 -0
- package/blun.mjs +519 -220
- package/package.json +4 -1
- package/release-planned-removals.json +4 -0
- package/scripts/check-package-regression.js +38 -0
- package/standard-skills/agent-browser/SKILL.md +19 -0
- package/standard-skills/agent-browser/references/runtime.md +8 -0
- package/standard-skills/design-taste-frontend/SKILL.md +1206 -0
- package/standard-skills/full-output-enforcement/SKILL.md +49 -0
- package/standard-skills/high-end-visual-design/SKILL.md +98 -0
- package/standard-skills/image-to-code/SKILL.md +1228 -0
- package/standard-skills/industrial-brutalist-ui/SKILL.md +92 -0
- package/standard-skills/minimalist-ui/SKILL.md +85 -0
- package/standard-skills/motion-design-taste/SKILL.md +74 -0
- package/standard-skills/playwright-testing/SKILL.md +19 -0
- package/standard-skills/playwright-testing/references/runtime.md +7 -0
- package/standard-skills/premortem/SKILL.md +148 -0
- package/standard-skills/redesign-existing-projects/SKILL.md +178 -0
- package/standard-skills/screenshot-lesen/SKILL.md +52 -0
- package/standard-skills/stitch-design-taste/DESIGN.md +121 -0
- package/standard-skills/stitch-design-taste/SKILL.md +184 -0
- package/standard-skills/telegram-channel/SKILL.md +18 -0
- package/standard-skills/telegram-channel/references/runtime.md +7 -0
- package/standard-skills/translate-native/LICENSE +21 -0
- package/standard-skills/translate-native/SKILL.md +39 -0
- package/standard-skills/translate-native/VERSION +1 -0
- package/standard-skills/translate-native/provenance.json +7 -0
- package/standard-skills/translate-native/references/evaluation-protocol.md +95 -0
- package/standard-skills/translate-native/references/native-orthography.md +79 -0
- package/standard-skills/translate-native/references/native-translation-standard.md +94 -0
- package/standard-skills/translate-native/references/structured-content.md +72 -0
- package/standard-skills/translate-native/references/translationese-review.md +77 -0
- package/standard-skills/translate-native/scripts/blun_language_guard.py +686 -0
- package/standard-skills/translate-native/scripts/check_diacritics.py +353 -0
- package/standard-skills/translate-native/scripts/guard_service_client.py +82 -0
- package/standard-skills/translate-native/scripts/language_gateway.py +62 -0
- package/standard-skills/translate-native/scripts/language_quality.py +172 -0
- package/standard-skills/translate-native/scripts/pre_output_guard.py +67 -0
- package/standard-skills/translate-native/scripts/translation_guard.py +916 -0
- package/standard-skills/web-lesen/SKILL.md +58 -0
- package/standard-skills/windows-mcp/SKILL.md +19 -0
- package/standard-skills/windows-mcp/references/runtime.md +9 -0
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: screenshot-lesen
|
|
3
|
+
description: "Bilder und Screenshots inhaltlich auslesen (OCR und UI-Struktur), obwohl das Modell selbst keine Bilder sieht. Mandatory triggers: eine Telegram-Nachricht enthaelt image_path oder attachment mit Bild, 'was steht auf dem Bild', 'lies den Screenshot', 'schau dir das Bild an', 'analysiere das Foto'. Der Skill liefert das Kommando-Rezept: EasyOCR zuerst (installiert), Tesseract als Fallback, OmniParser fuer UI-Element-Struktur."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Screenshot lesen
|
|
7
|
+
|
|
8
|
+
Du kannst Bilder NICHT direkt sehen — aber du kannst sie mit lokalen
|
|
9
|
+
Werkzeugen in Text verwandeln und dann inhaltlich beantworten. Behaupte nie,
|
|
10
|
+
ein Bild gelesen zu haben, ohne eines dieser Werkzeuge wirklich ausgefuehrt
|
|
11
|
+
zu haben.
|
|
12
|
+
|
|
13
|
+
## Weg 1 (Standard): EasyOCR — liest allen Text im Bild
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
python -c "import easyocr; r = easyocr.Reader(['de','en'], verbose=False); print('\n'.join(x[1] for x in r.readtext(r'BILDPFAD')))"
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
- BILDPFAD = der `image_path` aus der Telegram-Nachricht (oder der Pfad einer
|
|
20
|
+
per download_attachment geholten Datei).
|
|
21
|
+
- Erster Lauf laedt Modelle (dauert kurz), danach schnell.
|
|
22
|
+
- Ergebnis: der Text im Bild, Zeile fuer Zeile. Fasse ihn sinnvoll zusammen,
|
|
23
|
+
zitiere die relevanten Stellen.
|
|
24
|
+
|
|
25
|
+
## Weg 2 (Fallback): Tesseract
|
|
26
|
+
|
|
27
|
+
Wenn EasyOCR fehlt oder haengt:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
"C:\Program Files\Tesseract-OCR\tesseract.exe" BILDPFAD stdout -l eng
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Fuer Deutsch: `deu.traineddata` von
|
|
34
|
+
https://github.com/tesseract-ocr/tessdata_fast/raw/main/deu.traineddata in
|
|
35
|
+
einen eigenen Ordner laden, `TESSDATA_PREFIX` auf dessen ELTERN-Ordner setzen
|
|
36
|
+
(der Ordner selbst muss `tessdata` heissen), dann `-l deu+eng`.
|
|
37
|
+
|
|
38
|
+
## Weg 3 (UI-Struktur): OmniParser
|
|
39
|
+
|
|
40
|
+
Wenn nicht nur TEXT gefragt ist, sondern WAS auf einer Oberflaeche ist
|
|
41
|
+
(Buttons, Felder, Layout): OmniParser-Repo (microsoft/OmniParser, lokal
|
|
42
|
+
geklont) nutzen — erkennt UI-Elemente mit Positionen. Schwergewichtig;
|
|
43
|
+
nur verwenden, wenn die Frage wirklich UI-Struktur oder Bedienbarkeit
|
|
44
|
+
betrifft, sonst reicht Weg 1.
|
|
45
|
+
|
|
46
|
+
## Regeln
|
|
47
|
+
|
|
48
|
+
- Immer ehrlich sagen, WOMIT du gelesen hast (z.B. "per OCR gelesen").
|
|
49
|
+
- OCR kann sich verlesen — bei kritischen Werten (Zahlen, Codes, Namen)
|
|
50
|
+
dazusagen, dass es OCR ist und Unsicherheit moeglich ist.
|
|
51
|
+
- Niemals Secrets aus Bildern im Klartext wiedergeben — Fundort und Art
|
|
52
|
+
nennen, Werte maskieren.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Design System: Taste Standard
|
|
2
|
+
**Skill:** stitch-design-taste
|
|
3
|
+
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Configuration — Set Your Style
|
|
7
|
+
Adjust these dials before using this design system. They control how creative, dense, and animated the output should be. Pick the level that fits your project.
|
|
8
|
+
|
|
9
|
+
| Dial | Level | Description |
|
|
10
|
+
|------|-------|-------------|
|
|
11
|
+
| **Creativity** | `8` | `1` = Ultra-minimal, Swiss, silent, monochrome. `5` = Balanced, clean but with personality. `10` = Expressive, editorial, bold typography experiments, inline images in headlines, strong asymmetry. Default: `8` |
|
|
12
|
+
| **Density** | `4` | `1` = Gallery-airy, massive whitespace. `5` = Balanced sections. `10` = Cockpit-dense, data-heavy. Default: `4` |
|
|
13
|
+
| **Variance** | `8` | `1` = Predictable, symmetric grids. `5` = Subtle offsets. `10` = Artsy chaotic, no two sections alike. Default: `8` |
|
|
14
|
+
| **Motion Intent** | `6` | `1` = Static, no animation noted. `5` = Subtle hover/entrance cues. `10` = Cinematic orchestration noted in every component. Default: `6` |
|
|
15
|
+
|
|
16
|
+
> **How to use:** Change the numbers above to match your project's vibe. At **Creativity 1–3**, the system produces clean, quiet, Notion-like interfaces. At **Creativity 7–10**, expect inline image typography, dramatic scale contrast, and strong editorial layouts. The rest of the rules below adapt to your chosen levels.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 1. Visual Theme & Atmosphere
|
|
21
|
+
A restrained, gallery-airy interface with confident asymmetric layouts and fluid spring-physics motion. The atmosphere is clinical yet warm — like a well-lit architecture studio where every element earns its place through function. Density is balanced (Level 4), variance runs high (Level 8) to prevent symmetrical boredom, and motion is fluid but never theatrical (Level 6). The overall impression: expensive, intentional, alive.
|
|
22
|
+
|
|
23
|
+
## 2. Color Palette & Roles
|
|
24
|
+
- **Canvas White** (#F9FAFB) — Primary background surface. Warm-neutral, never clinical blue-white
|
|
25
|
+
- **Pure Surface** (#FFFFFF) — Card and container fill. Used with whisper shadow for elevation
|
|
26
|
+
- **Charcoal Ink** (#18181B) — Primary text. Zinc-950 depth — never pure black
|
|
27
|
+
- **Steel Secondary** (#71717A) — Body text, descriptions, metadata. Zinc-500 warmth
|
|
28
|
+
- **Muted Slate** (#94A3B8) — Tertiary text, timestamps, disabled states
|
|
29
|
+
- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, structural 1px lines. Semi-transparent for depth
|
|
30
|
+
- **Diffused Shadow** (rgba(0,0,0,0.05)) — Card elevation. Wide-spreading, 40px blur, -15px offset. Never harsh
|
|
31
|
+
|
|
32
|
+
### Accent Selection (Pick ONE per project)
|
|
33
|
+
- **Emerald Signal** (#10B981) — For growth, success, positive data dashboards
|
|
34
|
+
- **Electric Blue** (#3B82F6) — For productivity, SaaS, developer tools
|
|
35
|
+
- **Deep Rose** (#E11D48) — For creative, editorial, fashion-adjacent projects
|
|
36
|
+
- **Amber Warmth** (#F59E0B) — For community, social, warm-toned products
|
|
37
|
+
|
|
38
|
+
### Banned Colors
|
|
39
|
+
- Purple/Violet neon gradients — the "AI Purple" aesthetic
|
|
40
|
+
- Pure Black (#000000) — always Off-Black or Zinc-950
|
|
41
|
+
- Oversaturated accents above 80% saturation
|
|
42
|
+
- Mixed warm/cool gray systems within one project
|
|
43
|
+
|
|
44
|
+
## 3. Typography Rules
|
|
45
|
+
- **Display:** `Geist`, `Satoshi`, `Cabinet Grotesk`, or `Outfit` — Track-tight (`-0.025em`), controlled fluid scale, weight-driven hierarchy (700–900). Not screaming. Leading compressed (`1.1`). Alternatives forced — `Inter` is BANNED for premium contexts
|
|
46
|
+
- **Body:** Same family at weight 400 — Relaxed leading (`1.65`), 65ch max-width, Steel Secondary color (#71717A)
|
|
47
|
+
- **Mono:** `Geist Mono` or `JetBrains Mono` — For code blocks, metadata, timestamps. When density exceeds Level 7, all numbers switch to monospace
|
|
48
|
+
- **Scale:** Display at `clamp(2.25rem, 5vw, 3.75rem)`. Body at `1rem/1.125rem`. Mono metadata at `0.8125rem`
|
|
49
|
+
|
|
50
|
+
### Banned Fonts
|
|
51
|
+
- `Inter` — banned everywhere in premium/creative contexts
|
|
52
|
+
- Generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`, `Palatino`) — BANNED. If serif is needed for editorial/creative, use only distinctive modern serifs like `Fraunces`, `Gambarino`, `Editorial New`, or `Instrument Serif`. Never use default browser serif stacks. Serif is always BANNED in dashboards or software UIs regardless
|
|
53
|
+
|
|
54
|
+
## 4. Component Stylings
|
|
55
|
+
* **Buttons:** Flat surface, no outer glow. Primary: accent fill with white text. Secondary: ghost/outline. Active state: `-1px translateY` or `scale(0.98)` for tactile push. Hover: subtle background shift, never glow
|
|
56
|
+
* **Cards/Containers:** Generously rounded corners (`2.5rem`). Pure white fill. Whisper border (`1px`, semi-transparent). Diffused shadow (`0 20px 40px -15px rgba(0,0,0,0.05)`). Internal padding `2rem–2.5rem`. Used ONLY when elevation communicates hierarchy — high-density layouts replace cards with `border-top` dividers or negative space
|
|
57
|
+
* **Inputs/Forms:** Label positioned above input. Helper text optional. Error text below in Deep Rose. Focus ring in accent color, `2px` offset. No floating labels. Standard `0.5rem` gap between label-input-error stack
|
|
58
|
+
* **Navigation:** Sleek, sticky. Icons scale on hover (Dock Magnification optional). No hamburger on desktop. Clean horizontal with generous spacing
|
|
59
|
+
* **Loaders:** Skeletal shimmer matching exact layout dimensions and rounded corners. Shifting light reflection across placeholder shapes. Never circular spinners
|
|
60
|
+
* **Empty States:** Composed illustration or icon composition with guidance text. Never just "No data found"
|
|
61
|
+
* **Error States:** Inline, contextual. Red accent underline or border. Clear recovery action
|
|
62
|
+
|
|
63
|
+
## 5. Hero Section
|
|
64
|
+
The Hero is the first impression — it must be striking, creative, and never generic.
|
|
65
|
+
- **Inline Image Typography:** Embed small, contextual photos or visuals directly between words or letters in the headline. Example: "We build [photo of hands typing] digital [photo of screen] products" — images sit inline at type-height, rounded, acting as visual punctuation between words. This is the signature creative technique
|
|
66
|
+
- **No Overlapping Elements:** Text must never overlap images or other text. Every element has its own clear spatial zone. No z-index stacking of content layers, no absolute-positioned headlines over images. Clean separation always
|
|
67
|
+
- **No Filler Text:** "Scroll to explore", "Swipe down", scroll arrow icons, bouncing chevrons, and any instructional UI chrome are BANNED. The user knows how to scroll. Let the content pull them in naturally
|
|
68
|
+
- **Asymmetric Structure:** Centered Hero layouts are BANNED at this variance level. Use Split Screen (50/50), Left-Aligned text / Right visual, or Asymmetric Whitespace with large empty zones
|
|
69
|
+
- **CTA Restraint:** Maximum one primary CTA button. No secondary "Learn more" links. No redundant micro-copy below the headline
|
|
70
|
+
|
|
71
|
+
## 6. Layout Principles
|
|
72
|
+
- **Grid-First:** CSS Grid for all structural layouts. Never flexbox percentage math (`calc(33% - 1rem)` is BANNED)
|
|
73
|
+
- **No Overlapping:** Elements must never overlap each other. No absolute-positioned layers stacking content on content. Every element occupies its own grid cell or flow position. Clean, separated spatial zones
|
|
74
|
+
- **Feature Sections:** The "3 equal cards in a row" pattern is BANNED. Use 2-column Zig-Zag, asymmetric Bento grids (2fr 1fr 1fr), or horizontal scroll galleries
|
|
75
|
+
- **Containment:** All content within `max-width: 1400px`, centered. Generous horizontal padding (`1rem` mobile, `2rem` tablet, `4rem` desktop)
|
|
76
|
+
- **Full-Height:** Use `min-height: 100dvh` — never `height: 100vh` (iOS Safari address bar jump)
|
|
77
|
+
- **Bento Architecture:** For feature grids, use Row 1: 3 columns | Row 2: 2 columns (70/30 split). Each tile contains a perpetual micro-animation
|
|
78
|
+
|
|
79
|
+
## 7. Responsive Rules
|
|
80
|
+
Every screen must work flawlessly across all viewports. **Responsive is not optional — it is a hard requirement. Every single element must be tested at 375px, 768px, and 1440px.**
|
|
81
|
+
- **Mobile-First Collapse (< 768px):** All multi-column layouts collapse to a strict single column. `width: 100%`, `padding: 1rem`, `gap: 1.5rem`. No exceptions
|
|
82
|
+
- **No Horizontal Scroll:** Horizontal overflow on mobile is a critical failure. All elements must fit within viewport width. If any element causes horizontal scroll, the design is broken
|
|
83
|
+
- **Typography Scaling:** Headlines scale down gracefully via `clamp()`. Body text stays `1rem` minimum. Never shrink body below `14px`. Headlines must remain readable on 375px screens
|
|
84
|
+
- **Touch Targets:** All interactive elements minimum `44px` tap target. Generous spacing between clickable items. Buttons must be full-width on mobile
|
|
85
|
+
- **Image Behavior:** Hero and inline images scale proportionally. Inline typography images (photos between words) stack below the headline on mobile instead of inline
|
|
86
|
+
- **Navigation:** Desktop horizontal nav collapses to a clean mobile menu (slide-in or full-screen overlay). No tiny hamburger icons without labels
|
|
87
|
+
- **Cards & Grids:** Bento grids and asymmetric layouts revert to stacked single-column cards with full-width. Maintain internal padding (`1rem`)
|
|
88
|
+
- **Spacing Consistency:** Vertical section gaps reduce proportionally on mobile (`clamp(3rem, 8vw, 6rem)`). Never cramped, never excessively airy
|
|
89
|
+
- **Testing Viewports:** Designs must be verified at: `375px` (iPhone SE), `390px` (iPhone 14), `768px` (iPad), `1024px` (small laptop), `1440px` (desktop)
|
|
90
|
+
|
|
91
|
+
## 8. Motion & Interaction (Code-Phase Intent)
|
|
92
|
+
> **Note:** Stitch generates static screens — it does not animate. This section documents the **intended motion behavior** so that the coding agent (Antigravity, Cursor, etc.) knows exactly how to implement animations when building the exported design into a live product.
|
|
93
|
+
|
|
94
|
+
- **Physics Engine:** Spring-based exclusively. `stiffness: 100, damping: 20`. No linear easing anywhere. Premium, weighty feel on all interactive elements
|
|
95
|
+
- **Perpetual Micro-Loops:** Every active dashboard component has an infinite-loop state — Pulse on status dots, Typewriter on search bars, Float on feature icons, Shimmer on loading states
|
|
96
|
+
- **Staggered Orchestration:** Lists and grids mount with cascaded delays (`animation-delay: calc(var(--index) * 100ms)`). Waterfall reveals, never instant mount
|
|
97
|
+
- **Layout Transitions:** Smooth re-ordering via shared element IDs. Items swap positions with physics, simulating real-time intelligence
|
|
98
|
+
- **Hardware Rules:** Animate ONLY `transform` and `opacity`. Never `top`, `left`, `width`, `height`. Grain/noise filters on fixed, pointer-events-none pseudo-elements only
|
|
99
|
+
- **Performance:** CPU-heavy perpetual animations isolated in microscopic leaf components. Never trigger parent re-renders. Target 60fps minimum
|
|
100
|
+
|
|
101
|
+
## 9. Anti-Patterns (Banned)
|
|
102
|
+
- No emojis — anywhere in UI, code, or alt text
|
|
103
|
+
- No `Inter` font — use `Geist`, `Outfit`, `Cabinet Grotesk`, `Satoshi`
|
|
104
|
+
- No generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`) — if serif is needed, use distinctive modern serifs only (`Fraunces`, `Instrument Serif`)
|
|
105
|
+
- No pure black (`#000000`) — Off-Black or Zinc-950 only
|
|
106
|
+
- No neon outer glows or default box-shadow glows
|
|
107
|
+
- No oversaturated accent colors above 80%
|
|
108
|
+
- No excessive gradient text on large headers
|
|
109
|
+
- No custom mouse cursors
|
|
110
|
+
- No overlapping elements — text never overlaps images or other content. Clean spatial separation always
|
|
111
|
+
- No 3-column equal card layouts for features
|
|
112
|
+
- No centered Hero sections (at this variance level)
|
|
113
|
+
- No filler UI text: "Scroll to explore", "Swipe down", "Discover more below", scroll arrows, bouncing chevrons — all BANNED
|
|
114
|
+
- No generic names: "John Doe", "Sarah Chan", "Acme", "Nexus", "SmartFlow"
|
|
115
|
+
- No fake round numbers: `99.99%`, `50%`, `1234567` — use organic data: `47.2%`, `+1 (312) 847-1928`
|
|
116
|
+
- No AI copywriting clichés: "Elevate", "Seamless", "Unleash", "Next-Gen", "Revolutionize"
|
|
117
|
+
- No broken Unsplash links — use `picsum.photos/seed/{id}/800/600` or SVG UI Avatars
|
|
118
|
+
- No generic `shadcn/ui` defaults — customize radii, colors, shadows to match this system
|
|
119
|
+
- No `z-index` spam — use only for Navbar, Modal, Overlay layer contexts
|
|
120
|
+
- No `h-screen` — always `min-h-[100dvh]`
|
|
121
|
+
- No circular loading spinners — skeletal shimmer only
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: stitch-design-taste
|
|
3
|
+
description: Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Stitch Design Taste — Semantic Design System Skill
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
This skill generates `DESIGN.md` files optimized for Google Stitch screen generation. It translates the battle-tested anti-slop frontend engineering directives into Stitch's native semantic design language — descriptive, natural-language rules paired with precise values that Stitch's AI agent can interpret to produce premium, non-generic interfaces.
|
|
10
|
+
|
|
11
|
+
The generated `DESIGN.md` serves as the **single source of truth** for prompting Stitch to generate new screens that align with a curated, high-agency design language. Stitch interprets design through **"Visual Descriptions"** supported by specific color values, typography specs, and component behaviors.
|
|
12
|
+
|
|
13
|
+
## Prerequisites
|
|
14
|
+
- Access to Google Stitch via [labs.google/stitch](https://labs.google/stitch)
|
|
15
|
+
- Optionally: Stitch MCP Server for programmatic integration with a compatible CLI
|
|
16
|
+
|
|
17
|
+
## The Goal
|
|
18
|
+
Generate a `DESIGN.md` file that encodes:
|
|
19
|
+
1. **Visual atmosphere** — the mood, density, and design philosophy
|
|
20
|
+
2. **Color calibration** — neutrals, accents, and banned patterns with hex codes
|
|
21
|
+
3. **Typographic architecture** — font stacks, scale hierarchy, and anti-patterns
|
|
22
|
+
4. **Component behaviors** — buttons, cards, inputs with interaction states
|
|
23
|
+
5. **Layout principles** — grid systems, spacing philosophy, responsive strategy
|
|
24
|
+
6. **Motion philosophy** — animation engine specs, spring physics, perpetual micro-interactions
|
|
25
|
+
7. **Anti-patterns** — explicit list of banned AI design clichés
|
|
26
|
+
|
|
27
|
+
## Analysis & Synthesis Instructions
|
|
28
|
+
|
|
29
|
+
### 1. Define the Atmosphere
|
|
30
|
+
Evaluate the target project's intent. Use evocative adjectives from the taste spectrum:
|
|
31
|
+
- **Density:** "Art Gallery Airy" (1–3) → "Daily App Balanced" (4–7) → "Cockpit Dense" (8–10)
|
|
32
|
+
- **Variance:** "Predictable Symmetric" (1–3) → "Offset Asymmetric" (4–7) → "Artsy Chaotic" (8–10)
|
|
33
|
+
- **Motion:** "Static Restrained" (1–3) → "Fluid CSS" (4–7) → "Cinematic Choreography" (8–10)
|
|
34
|
+
|
|
35
|
+
Default baseline: Variance 8, Motion 6, Density 4. Adapt dynamically based on user's vibe description.
|
|
36
|
+
|
|
37
|
+
### 2. Map the Color Palette
|
|
38
|
+
For each color provide: **Descriptive Name** + **Hex Code** + **Functional Role**.
|
|
39
|
+
|
|
40
|
+
**Mandatory constraints:**
|
|
41
|
+
- Maximum 1 accent color. Saturation below 80%
|
|
42
|
+
- The "AI Purple/Blue Neon" aesthetic is strictly BANNED — no purple button glows, no neon gradients
|
|
43
|
+
- Use absolute neutral bases (Zinc/Slate) with high-contrast singular accents
|
|
44
|
+
- Stick to one palette for the entire output — no warm/cool gray fluctuation
|
|
45
|
+
- Never use pure black (`#000000`) — use Off-Black, Zinc-950, or Charcoal
|
|
46
|
+
|
|
47
|
+
### 3. Establish Typography Rules
|
|
48
|
+
- **Display/Headlines:** Track-tight, controlled scale. Not screaming. Hierarchy through weight and color, not just massive size
|
|
49
|
+
- **Body:** Relaxed leading, max 65 characters per line
|
|
50
|
+
- **Font Selection:** `Inter` is BANNED for premium/creative contexts. Force unique character: `Geist`, `Outfit`, `Cabinet Grotesk`, or `Satoshi`
|
|
51
|
+
- **Serif Ban:** Generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`, `Palatino`) are BANNED. If serif is needed for editorial/creative contexts, use only distinctive modern serifs: `Fraunces`, `Gambarino`, `Editorial New`, or `Instrument Serif`. Serif is always BANNED in dashboards or software UIs
|
|
52
|
+
- **Dashboard Constraint:** Use Sans-Serif pairings exclusively (`Geist` + `Geist Mono` or `Satoshi` + `JetBrains Mono`)
|
|
53
|
+
- **High-Density Override:** When density exceeds 7, all numbers must use Monospace
|
|
54
|
+
|
|
55
|
+
### 4. Define the Hero Section
|
|
56
|
+
The Hero is the first impression and must be creative, striking, and never generic:
|
|
57
|
+
- **Inline Image Typography:** Embed small, contextual photos or visuals directly between words or letters in the headline. Images sit inline at type-height, rounded, acting as visual punctuation. This is the signature creative technique
|
|
58
|
+
- **No Overlapping:** Text must never overlap images or other text. Every element occupies its own clean spatial zone
|
|
59
|
+
- **No Filler Text:** "Scroll to explore", "Swipe down", scroll arrow icons, bouncing chevrons are BANNED. The content should pull users in naturally
|
|
60
|
+
- **Asymmetric Structure:** Centered Hero layouts BANNED when variance exceeds 4
|
|
61
|
+
- **CTA Restraint:** Maximum one primary CTA. No secondary "Learn more" links
|
|
62
|
+
|
|
63
|
+
### 5. Describe Component Stylings
|
|
64
|
+
For each component type, describe shape, color, shadow depth, and interaction behavior:
|
|
65
|
+
- **Buttons:** Tactile push feedback on active state. No neon outer glows. No custom mouse cursors
|
|
66
|
+
- **Cards:** Use ONLY when elevation communicates hierarchy. Tint shadows to background hue. For high-density layouts, replace cards with border-top dividers or negative space
|
|
67
|
+
- **Inputs/Forms:** Label above input, helper text optional, error text below. Standard gap spacing
|
|
68
|
+
- **Loading States:** Skeletal loaders matching layout dimensions — no generic circular spinners
|
|
69
|
+
- **Empty States:** Composed compositions indicating how to populate data
|
|
70
|
+
- **Error States:** Clear, inline error reporting
|
|
71
|
+
|
|
72
|
+
### 6. Define Layout Principles
|
|
73
|
+
- No overlapping elements — every element occupies its own clear spatial zone. No absolute-positioned content stacking
|
|
74
|
+
- Centered Hero sections are BANNED when variance exceeds 4 — force Split Screen, Left-Aligned, or Asymmetric Whitespace
|
|
75
|
+
- The generic "3 equal cards horizontally" feature row is BANNED — use 2-column Zig-Zag, asymmetric grid, or horizontal scroll
|
|
76
|
+
- CSS Grid over Flexbox math — never use `calc()` percentage hacks
|
|
77
|
+
- Contain layouts using max-width constraints (e.g., 1400px centered)
|
|
78
|
+
- Full-height sections must use `min-h-[100dvh]` — never `h-screen` (iOS Safari catastrophic jump)
|
|
79
|
+
|
|
80
|
+
### 7. Define Responsive Rules
|
|
81
|
+
Every design must work across all viewports:
|
|
82
|
+
- **Mobile-First Collapse (< 768px):** All multi-column layouts collapse to single column. No exceptions
|
|
83
|
+
- **No Horizontal Scroll:** Horizontal overflow on mobile is a critical failure
|
|
84
|
+
- **Typography Scaling:** Headlines scale via `clamp()`. Body text minimum `1rem`/`14px`
|
|
85
|
+
- **Touch Targets:** All interactive elements minimum `44px` tap target
|
|
86
|
+
- **Image Behavior:** Inline typography images (photos between words) stack below headline on mobile
|
|
87
|
+
- **Navigation:** Desktop horizontal nav collapses to clean mobile menu
|
|
88
|
+
- **Spacing:** Vertical section gaps reduce proportionally (`clamp(3rem, 8vw, 6rem)`)
|
|
89
|
+
|
|
90
|
+
### 8. Encode Motion Philosophy
|
|
91
|
+
- **Spring Physics default:** `stiffness: 100, damping: 20` — premium, weighty feel. No linear easing
|
|
92
|
+
- **Perpetual Micro-Interactions:** Every active component should have an infinite loop state (Pulse, Typewriter, Float, Shimmer)
|
|
93
|
+
- **Staggered Orchestration:** Never mount lists instantly — use cascade delays for waterfall reveals
|
|
94
|
+
- **Performance:** Animate exclusively via `transform` and `opacity`. Never animate `top`, `left`, `width`, `height`. Grain/noise filters on fixed pseudo-elements only
|
|
95
|
+
|
|
96
|
+
### 9. List Anti-Patterns (AI Tells)
|
|
97
|
+
Encode these as explicit "NEVER DO" rules in the DESIGN.md:
|
|
98
|
+
- No emojis anywhere
|
|
99
|
+
- No `Inter` font
|
|
100
|
+
- No generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`) — distinctive modern serifs only if needed
|
|
101
|
+
- No pure black (`#000000`)
|
|
102
|
+
- No neon/outer glow shadows
|
|
103
|
+
- No oversaturated accents
|
|
104
|
+
- No excessive gradient text on large headers
|
|
105
|
+
- No custom mouse cursors
|
|
106
|
+
- No overlapping elements — clean spatial separation always
|
|
107
|
+
- No 3-column equal card layouts
|
|
108
|
+
- No generic names ("John Doe", "Acme", "Nexus")
|
|
109
|
+
- No fake round numbers (`99.99%`, `50%`)
|
|
110
|
+
- No AI copywriting clichés ("Elevate", "Seamless", "Unleash", "Next-Gen")
|
|
111
|
+
- No filler UI text: "Scroll to explore", "Swipe down", scroll arrows, bouncing chevrons
|
|
112
|
+
- No broken Unsplash links — use `picsum.photos` or SVG avatars
|
|
113
|
+
- No centered Hero sections (for high-variance projects)
|
|
114
|
+
|
|
115
|
+
## Output Format (DESIGN.md Structure)
|
|
116
|
+
|
|
117
|
+
```markdown
|
|
118
|
+
# Design System: [Project Title]
|
|
119
|
+
|
|
120
|
+
## 1. Visual Theme & Atmosphere
|
|
121
|
+
(Evocative description of the mood, density, variance, and motion intensity.
|
|
122
|
+
Example: "A restrained, gallery-airy interface with confident asymmetric layouts
|
|
123
|
+
and fluid spring-physics motion. The atmosphere is clinical yet warm — like a
|
|
124
|
+
well-lit architecture studio.")
|
|
125
|
+
|
|
126
|
+
## 2. Color Palette & Roles
|
|
127
|
+
- **Canvas White** (#F9FAFB) — Primary background surface
|
|
128
|
+
- **Pure Surface** (#FFFFFF) — Card and container fill
|
|
129
|
+
- **Charcoal Ink** (#18181B) — Primary text, Zinc-950 depth
|
|
130
|
+
- **Muted Steel** (#71717A) — Secondary text, descriptions, metadata
|
|
131
|
+
- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, 1px structural lines
|
|
132
|
+
- **[Accent Name]** (#XXXXXX) — Single accent for CTAs, active states, focus rings
|
|
133
|
+
(Max 1 accent. Saturation < 80%. No purple/neon.)
|
|
134
|
+
|
|
135
|
+
## 3. Typography Rules
|
|
136
|
+
- **Display:** [Font Name] — Track-tight, controlled scale, weight-driven hierarchy
|
|
137
|
+
- **Body:** [Font Name] — Relaxed leading, 65ch max-width, neutral secondary color
|
|
138
|
+
- **Mono:** [Font Name] — For code, metadata, timestamps, high-density numbers
|
|
139
|
+
- **Banned:** Inter, generic system fonts for premium contexts. Serif fonts banned in dashboards.
|
|
140
|
+
|
|
141
|
+
## 4. Component Stylings
|
|
142
|
+
* **Buttons:** Flat, no outer glow. Tactile -1px translate on active. Accent fill for primary, ghost/outline for secondary.
|
|
143
|
+
* **Cards:** Generously rounded corners (2.5rem). Diffused whisper shadow. Used only when elevation serves hierarchy. High-density: replace with border-top dividers.
|
|
144
|
+
* **Inputs:** Label above, error below. Focus ring in accent color. No floating labels.
|
|
145
|
+
* **Loaders:** Skeletal shimmer matching exact layout dimensions. No circular spinners.
|
|
146
|
+
* **Empty States:** Composed, illustrated compositions — not just "No data" text.
|
|
147
|
+
|
|
148
|
+
## 5. Layout Principles
|
|
149
|
+
(Grid-first responsive architecture. Asymmetric splits for Hero sections.
|
|
150
|
+
Strict single-column collapse below 768px. Max-width containment.
|
|
151
|
+
No flexbox percentage math. Generous internal padding.)
|
|
152
|
+
|
|
153
|
+
## 6. Motion & Interaction
|
|
154
|
+
(Spring physics for all interactive elements. Staggered cascade reveals.
|
|
155
|
+
Perpetual micro-loops on active dashboard components. Hardware-accelerated
|
|
156
|
+
transforms only. Isolated Client Components for CPU-heavy animations.)
|
|
157
|
+
|
|
158
|
+
## 7. Anti-Patterns (Banned)
|
|
159
|
+
(Explicit list of forbidden patterns: no emojis, no Inter, no pure black,
|
|
160
|
+
no neon glows, no 3-column equal grids, no AI copywriting clichés,
|
|
161
|
+
no generic placeholder names, no broken image links.)
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## Best Practices
|
|
165
|
+
- **Be Descriptive:** "Deep Charcoal Ink (#18181B)" — not just "dark text"
|
|
166
|
+
- **Be Functional:** Explain what each element is used for
|
|
167
|
+
- **Be Consistent:** Same terminology throughout the document
|
|
168
|
+
- **Be Precise:** Include exact hex codes, rem values, pixel values in parentheses
|
|
169
|
+
- **Be Opinionated:** This is not a neutral template — it enforces a specific, premium aesthetic
|
|
170
|
+
|
|
171
|
+
## Tips for Success
|
|
172
|
+
1. Start with the atmosphere — understand the vibe before detailing tokens
|
|
173
|
+
2. Look for patterns — identify consistent spacing, sizing, and styling
|
|
174
|
+
3. Think semantically — name colors by purpose, not just appearance
|
|
175
|
+
4. Consider hierarchy — document how visual weight communicates importance
|
|
176
|
+
5. Encode the bans — anti-patterns are as important as the rules themselves
|
|
177
|
+
|
|
178
|
+
## Common Pitfalls to Avoid
|
|
179
|
+
- Using technical jargon without translation ("rounded-xl" instead of "generously rounded corners")
|
|
180
|
+
- Omitting hex codes or using only descriptive names
|
|
181
|
+
- Forgetting functional roles of design elements
|
|
182
|
+
- Being too vague in atmosphere descriptions
|
|
183
|
+
- Ignoring the anti-pattern list — these are what make the output premium
|
|
184
|
+
- Defaulting to generic "safe" designs instead of enforcing the curated aesthetic
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: telegram-channel
|
|
3
|
+
description: Operate and diagnose the bundled Telegram channel through its single managed plugin while preserving user credentials, pairing state, and process ownership.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Telegram Channel
|
|
7
|
+
|
|
8
|
+
Use this skill for Telegram pairing, inbound and outbound message diagnosis, access rules, and channel verification.
|
|
9
|
+
|
|
10
|
+
## Workflow
|
|
11
|
+
|
|
12
|
+
1. Read [references/runtime.md](references/runtime.md) before changing channel configuration.
|
|
13
|
+
2. Inspect the managed plugin and its current process state before proposing a restart or repair.
|
|
14
|
+
3. Keep bot credentials and pairing data in the product's private configuration. Never include them in skills, package manifests, logs, or test fixtures.
|
|
15
|
+
4. Use exactly one bridge and one Telegram MCP owner. Do not create a parallel global MCP entry.
|
|
16
|
+
5. Verify recovery end to end: one process lease, advancing heartbeat, inbound delivery, session handoff, and outbound response.
|
|
17
|
+
|
|
18
|
+
Do not start, stop, pair, or reconfigure the channel without explicit user authorization.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Telegram Runtime Contract
|
|
2
|
+
|
|
3
|
+
- Telegram is delivered by the bundled managed plugin, not by a seeded user MCP entry.
|
|
4
|
+
- The managed plugin is the sole owner of its bridge and MCP process.
|
|
5
|
+
- Bot credentials and access policy are supplied by the user after installation and never ship in the package.
|
|
6
|
+
- Existing pairing and access configuration wins. Do not replace it during package seeding or updates.
|
|
7
|
+
- A configured file is not runtime proof; verify the live lease and an inbound-to-outbound round trip.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Maykbiletti
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: translate-native
|
|
3
|
+
description: Translate, localize, rewrite, and review user-visible language with native orthography, structural fidelity, and a fail-closed BLUN release gate.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Translate Native
|
|
7
|
+
|
|
8
|
+
Use this skill for every translation, localization, translated rewrite, translation review, or user-visible internationalization edit.
|
|
9
|
+
|
|
10
|
+
This bundled adaptation is based on translate-native 6.41.1. Read [references/native-translation-standard.md](references/native-translation-standard.md) and [references/evaluation-protocol.md](references/evaluation-protocol.md) for the full quality contract. For structured data, also read [references/structured-content.md](references/structured-content.md).
|
|
11
|
+
|
|
12
|
+
## Seven-pass review
|
|
13
|
+
|
|
14
|
+
Treat every proposed target as an untrusted draft. Review it in seven distinct passes:
|
|
15
|
+
|
|
16
|
+
1. Meaning and omissions: preserve every claim, condition, negation, number, and relationship.
|
|
17
|
+
2. Native idiom: remove source-language syntax and translationese without changing meaning.
|
|
18
|
+
3. Register and audience: match locale, tone, formality, and product context.
|
|
19
|
+
4. Terminology and consistency: preserve protected names, commands, paths, placeholders, and repeated terms.
|
|
20
|
+
5. Orthography: use native script, diacritics, capitalization, punctuation, and typography.
|
|
21
|
+
6. Structure and integrity: preserve markup, keys, variables, links, code, and required formatting.
|
|
22
|
+
7. Independent release review: reread source and target as complete documents and attest only what was actually checked.
|
|
23
|
+
|
|
24
|
+
German `ss` is not deterministic evidence of broken native orthography because it may be correct. ASCII substitutions such as `ae`, `oe`, and `ue` require context-sensitive review against native spelling.
|
|
25
|
+
|
|
26
|
+
## Mandatory release gate
|
|
27
|
+
|
|
28
|
+
Before releasing target-language text, call the BLUN language guard tool `release_translation` with:
|
|
29
|
+
|
|
30
|
+
- the complete source and complete target;
|
|
31
|
+
- the exact language tag and content type;
|
|
32
|
+
- truthful attestations for all seven passes;
|
|
33
|
+
- `short_text_reviewed: true` only after an independent native review of a short UI string, title, or metadata field.
|
|
34
|
+
|
|
35
|
+
Release only when the response says `release_allowed: true`. Confirm its receipt using `verify_release_token` with the exact same source, target, language, content type, review status, version, and expiry. Never fabricate, edit, reuse, expose, request, or log a release token or signing key.
|
|
36
|
+
|
|
37
|
+
If the gate blocks, revise and run it again. If the enforced service is unavailable, fail closed for publication-grade or structured translation work. For ordinary conversational translation, run the bundled local guards, label the enforced gate unavailable, and keep the response provisional.
|
|
38
|
+
|
|
39
|
+
For programmatic integrations, return the verified `release_response` unchanged rather than reconstructing it.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
6.41.1
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "translate-native",
|
|
3
|
+
"version": "6.41.1",
|
|
4
|
+
"sourceCommit": "047aa2b4ba4c6a7b4797be8ed8ea6b7fd60728f0",
|
|
5
|
+
"sourceRepository": "https://github.com/Maykbiletti/translate-native",
|
|
6
|
+
"adaptation": "BLUN host policy replaces client-specific deployment text"
|
|
7
|
+
}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Native Translation Evaluation Protocol
|
|
2
|
+
|
|
3
|
+
## Release rule
|
|
4
|
+
|
|
5
|
+
Release a translation only when it has zero blocking defects and reads naturally for the specified community, audience, register, and medium. Fluency cannot compensate for changed meaning. Fidelity cannot compensate for obvious translationese.
|
|
6
|
+
|
|
7
|
+
## Classify defects
|
|
8
|
+
|
|
9
|
+
| Severity | Definition | Examples | Action |
|
|
10
|
+
| --- | --- | --- | --- |
|
|
11
|
+
| Blocking | Meaning, safety, structure, or identity is damaged | Reversed negation, missing caveat, wrong number, broken placeholder, invented claim, wrong script | Fix before delivery |
|
|
12
|
+
| Major | A native editor would rewrite it or the locale/register is materially wrong | Calque, unnatural syntax, grammatical-but-non-native collocation, broken parallelism, unnecessary borrowing, generic AI filler, wrong honorific, inconsistent terminology, regional mismatch | Fix before delivery |
|
|
13
|
+
| Minor | Meaning and nativeness survive but polish is imperfect | Slight repetition, optional punctuation refinement | Fix when feasible |
|
|
14
|
+
|
|
15
|
+
Do not average blocking defects into a numeric score. One blocking defect fails the translation.
|
|
16
|
+
|
|
17
|
+
Grammar is not a release category. A target with zero grammar errors still fails when it contains a major nativeness defect. Use [translationese-review.md](translationese-review.md) for the target-only procedure and worked regression case.
|
|
18
|
+
|
|
19
|
+
## Run a target-only native review
|
|
20
|
+
|
|
21
|
+
Temporarily hide the source and judge the target as original writing. Inspect:
|
|
22
|
+
|
|
23
|
+
- syntax and information order;
|
|
24
|
+
- collocations and idiomatic word choice;
|
|
25
|
+
- paragraph flow, cohesion, rhythm, and repetition;
|
|
26
|
+
- politeness, honorifics, directness, and social relationship;
|
|
27
|
+
- locale, script, punctuation, typography, and medium conventions;
|
|
28
|
+
- whether a native writer would choose the same headline, button, instruction, or transition.
|
|
29
|
+
|
|
30
|
+
Also inspect whether coordinated items belong to the same grammatical and semantic category, whether source-language technical vocabulary displaced an established native term, and whether polished-sounding AI filler hides a vague relationship.
|
|
31
|
+
|
|
32
|
+
Rewrite any passage that is merely understandable but not naturally chosen. Preserve protected tokens while moving them to the grammatically natural position.
|
|
33
|
+
|
|
34
|
+
## Run a source-aware fidelity review
|
|
35
|
+
|
|
36
|
+
Compare propositions rather than matching words. Account for every source fact, negation, quantity, entity, relationship, condition, exception, uncertainty marker, time reference, and call to action. Flag:
|
|
37
|
+
|
|
38
|
+
- omissions, additions, duplication, or unjustified explanation;
|
|
39
|
+
- stronger or weaker certainty, obligation, praise, warning, or promise;
|
|
40
|
+
- changed causal relationships, scope, chronology, or ambiguity;
|
|
41
|
+
- terminology drift and inconsistent names;
|
|
42
|
+
- cultural adaptation that changes factual content.
|
|
43
|
+
|
|
44
|
+
Use back-translation only to reveal possible loss or addition. Never use it as proof of native quality.
|
|
45
|
+
|
|
46
|
+
## Use independent review when stakes justify it
|
|
47
|
+
|
|
48
|
+
When another agent or qualified reviewer is available, provide only:
|
|
49
|
+
|
|
50
|
+
1. the complete source;
|
|
51
|
+
2. the candidate target;
|
|
52
|
+
3. target language, locale, script, audience, register, and medium;
|
|
53
|
+
4. required glossary and protected tokens;
|
|
54
|
+
5. this defect rubric.
|
|
55
|
+
|
|
56
|
+
Ask for a structured defect list with severity, target excerpt, reason, and minimal correction direction. Do not ask the reviewer to replace the whole translation, reveal an expected answer, or praise the draft. Revise centrally so terminology and voice remain coherent.
|
|
57
|
+
|
|
58
|
+
Use this release decision contract:
|
|
59
|
+
|
|
60
|
+
```text
|
|
61
|
+
status: PASS | FAIL
|
|
62
|
+
blocking_defects:
|
|
63
|
+
- excerpt: exact target fragment
|
|
64
|
+
class: meaning | completeness | precision | integrity | orthography
|
|
65
|
+
reason: concise evidence
|
|
66
|
+
major_defects:
|
|
67
|
+
- excerpt: exact target fragment
|
|
68
|
+
class: nativeness | locale | register | terminology | parallelism
|
|
69
|
+
reason: concise evidence
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Return `PASS` only when both defect lists are empty. Any blocking or major defect requires revision followed by a complete new native, fidelity, integrity, and orthography review. Never average defects into a passing numeric score.
|
|
73
|
+
|
|
74
|
+
For legal, medical, safety-critical, contractual, or public high-impact content, an AI reviewer is an additional check, not a substitute for a qualified native professional.
|
|
75
|
+
|
|
76
|
+
## Route by confidence
|
|
77
|
+
|
|
78
|
+
- **High:** Language variety and domain are well supported; all gates pass. Deliver normally.
|
|
79
|
+
- **Medium:** One or more usage, locale, or domain choices are uncertain. Verify them with authoritative native sources and rerun the review.
|
|
80
|
+
- **Low:** Reliable evidence is unavailable or varieties may be mixed. Do not present the result as assuredly native. State the limitation or request native review.
|
|
81
|
+
|
|
82
|
+
Confidence describes evidence, not how fluent the prose appears.
|
|
83
|
+
|
|
84
|
+
## Evaluate long documents
|
|
85
|
+
|
|
86
|
+
Create a translation brief before drafting. Record locale, script, audience, address form, voice, tense policy, glossary, names, units, and formatting. Maintain it across sections. After assembly, review the whole document for:
|
|
87
|
+
|
|
88
|
+
- terminology and capitalization drift;
|
|
89
|
+
- pronoun/reference continuity;
|
|
90
|
+
- headings, captions, lists, and cross-references;
|
|
91
|
+
- consistent voice, politeness, tense, and narrative distance;
|
|
92
|
+
- duplicated or missing content at section boundaries;
|
|
93
|
+
- global rhythm and repeated sentence patterns caused by chunking.
|
|
94
|
+
|
|
95
|
+
Do not declare a long document finished from section-level checks alone.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Native Orthography Gate
|
|
2
|
+
|
|
3
|
+
## Release rule
|
|
4
|
+
|
|
5
|
+
Write every target in its native orthography. Correct spelling, language-specific letters, diacritics, alphabet, script, punctuation, casing, spacing, and Unicode normalization are mandatory parts of translation quality, not optional typography.
|
|
6
|
+
|
|
7
|
+
Do not rely on a separate skill to perform this review. Do not release a translation while a confirmed orthographic defect remains.
|
|
8
|
+
|
|
9
|
+
## Mandatory review
|
|
10
|
+
|
|
11
|
+
1. Identify the exact target language, locale, script, and regional standard.
|
|
12
|
+
2. Review every natural-language segment, including headings, buttons, labels, metadata, accessibility text, and mixed-language passages.
|
|
13
|
+
3. Replace ASCII transliterations only when they stand in for native spelling: `schön`, not `schoen`; `förstår`, not `forstar`; `español`, not `espanol`; `čeština`, not `cestina`.
|
|
14
|
+
4. Use the native writing system by default. Do not romanize Greek, Cyrillic, Arabic, Hebrew, Indic, Southeast Asian, or East Asian text unless requested.
|
|
15
|
+
5. Apply locale-specific punctuation and typography, such as Spanish `¿…?` and `¡…!`, French spacing conventions, or Chinese and Japanese punctuation.
|
|
16
|
+
6. Preserve the canonical spelling of names, brands, quotations, and established technical terms. Verify uncertainty instead of inventing a mark.
|
|
17
|
+
7. Normalize newly written UTF-8 content to Unicode NFC. Preserve a different normalization only when a technical format explicitly requires it.
|
|
18
|
+
8. Re-run the full language and fidelity review after any orthographic correction that could change meaning.
|
|
19
|
+
|
|
20
|
+
## Coverage map
|
|
21
|
+
|
|
22
|
+
| Language or writing system | Preserve |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| German | `ä ö ü Ä Ö Ü ß`; use Swiss `ss` where required |
|
|
25
|
+
| Swedish | `å ä ö Å Ä Ö` as separate letters |
|
|
26
|
+
| Danish and Norwegian | `æ ø å Æ Ø Å` |
|
|
27
|
+
| Icelandic and Faroese | accents and letters such as `ð þ æ ö ø` |
|
|
28
|
+
| Spanish | `á é í ó ú ü ñ ¿ ¡` |
|
|
29
|
+
| French | accents, diaeresis, cedilla, and conventional ligatures |
|
|
30
|
+
| Portuguese | acute and circumflex accents, tildes, grave accents, and cedilla |
|
|
31
|
+
| Catalan, Galician, and Basque | native accents, diaeresis, cedilla, middle dot, and `ñ` where applicable |
|
|
32
|
+
| Czech and Slovak | every caron, acute, ring, circumflex, diaeresis, and language-specific consonant |
|
|
33
|
+
| Polish, Hungarian, Romanian | complete native diacritics; Romanian comma-below `ș ț`, not cedilla variants |
|
|
34
|
+
| Turkish and Azerbaijani | dotted and undotted `i`, `ç ğ ö ş ü`, and Azerbaijani `ə` |
|
|
35
|
+
| South Slavic Latin scripts | `č ć đ š ž` and the exact requested regional standard |
|
|
36
|
+
| Baltic languages | macrons, carons, dots, cedillas, and ogoneks |
|
|
37
|
+
| Vietnamese | complete tone and vowel marks, including stacked marks |
|
|
38
|
+
| Greek | Greek alphabet with correct tonos and dialytika; no Greeklish by default |
|
|
39
|
+
| Cyrillic languages | the exact language alphabet, including letters absent from Russian |
|
|
40
|
+
| Arabic-script languages | the correct language-specific letters and punctuation; optional vowel marks only when conventional |
|
|
41
|
+
| Hebrew | Hebrew script; preserve or add niqqud only when the task requires it |
|
|
42
|
+
| Indic scripts | native letters, vowel signs, conjuncts, nukta, virama, and punctuation |
|
|
43
|
+
| Thai, Lao, Khmer, and Myanmar | tone marks, vowel placement, combining marks, and native spacing conventions |
|
|
44
|
+
| Chinese | requested Simplified or Traditional characters and locale-appropriate punctuation |
|
|
45
|
+
| Japanese | appropriate kanji, kana, prolonged-sound and iteration marks, spacing, and punctuation |
|
|
46
|
+
| Korean | Hangul and correct Korean spacing; preserve hanja only when intended |
|
|
47
|
+
| Armenian, Georgian, Ethiopic, and other scripts | native alphabet, canonical spelling, and punctuation |
|
|
48
|
+
|
|
49
|
+
This map is illustrative, never exhaustive. Apply the same native-orthography rule to every human language and writing system.
|
|
50
|
+
|
|
51
|
+
## Technical exceptions
|
|
52
|
+
|
|
53
|
+
Keep exact ASCII or source spelling when modification could break behavior or fidelity:
|
|
54
|
+
|
|
55
|
+
- code identifiers, commands, environment variables, API fields, JSON keys, database columns, slugs, URLs, email addresses, paths, hashes, tokens, regular expressions, and protocol values;
|
|
56
|
+
- exact quotations, imported data, trademarks, and personal names whose canonical spelling is known;
|
|
57
|
+
- systems with a documented encoding limitation;
|
|
58
|
+
- explicit requests for transliteration, ASCII folding, search keys, or URL-safe text.
|
|
59
|
+
|
|
60
|
+
Technical exceptions never justify ASCII-only prose around protected values.
|
|
61
|
+
|
|
62
|
+
## Limits of automated checks
|
|
63
|
+
|
|
64
|
+
The bundled translation guard verifies UTF-8, Unicode NFC, protected tokens, and structure. The bundled diacritics linter flags frequent ASCII substitutions in many Latin-script languages while ignoring common technical spans. Neither can prove that a word contains the correct diacritic, that the requested script was chosen, or that spelling is native. Use deterministic checks as evidence, then complete the language-aware review manually or with a qualified native reviewer.
|
|
65
|
+
|
|
66
|
+
## Verification hierarchy
|
|
67
|
+
|
|
68
|
+
When usage, spelling, script, or locale conventions are uncertain, verify in this order:
|
|
69
|
+
|
|
70
|
+
1. the requested language community's academy, language council, government style guide, or other recognized normative body;
|
|
71
|
+
2. the [Unicode Standard](https://unicode.org/reports/tr15/) for normalization and character behavior;
|
|
72
|
+
3. [Unicode CLDR](https://cldr.unicode.org/) for locale identifiers, exemplar characters, punctuation sets, plural rules, number and date conventions, and script variants;
|
|
73
|
+
4. the [W3C Language Enablement Index](https://www.w3.org/International/typography/gap-analysis/language-matrix.html) for writing-system layout and typography;
|
|
74
|
+
5. the [IANA Language Subtag Registry](https://www.iana.org/assignments/language-subtag-registry) for language, region, and script tags;
|
|
75
|
+
6. contemporary native-edited dictionaries and monolingual corpora for usage and collocations.
|
|
76
|
+
|
|
77
|
+
Examples of authoritative language sources include Sweden's [Institutet för språk och folkminnen](https://www.isof.se/svenska-spraket/frageladan), the [Real Academia Española](https://www.rae.es/), the Czech Academy's [Czech Language Institute](https://ujc.cas.cz/), the [Institut d'Estudis Catalans](https://www.iec.cat/), and [Euskaltzaindia](https://www.euskaltzaindia.eus/).
|
|
78
|
+
|
|
79
|
+
Do not treat a translation engine, parallel corpus, search-result count, ASCII spell-checker, or another model's confidence as a normative source. Use them only to locate questions that still require native evidence.
|