The Periodic Table of Code. A global deterministic addressing standard for AI agents, modular systems, and human-machine interoperability.
HTML
2
173 commits
updated Sep 24, 2026
📜 Official CERN Zenodo DOI:
10.5281/zenodo.22934668
🛡️ Rospatent RF Application: No. 2026603415 / 7927650015
🌐 Official Portal: https://index.utyanskiy.ru
[!TIP]
⭐ Support & Feedback
I’d be genuinely grateful for your feedback! If the Utyansky Index helped you tame AI hallucinations, save tokens, or streamline your architecture — please consider supporting this project with a ⭐ Star (click the Star button in the top-right corner of this page).
As an independent author, your star is the greatest motivation to keep advancing this open standard!
🏛️ Rospatent RF Application and Priority Timeline
- Copyright Object: Computer Software «Deterministic Coordinate Navigation and Data Routing System for Artificial Intelligence and Software "Utyansky Index" (Utyansky Index v2.0)»
- Intellectual Property Office: Federal Service for Intellectual Property (Rospatent RF / FIPS)
- Official Application Number: № 2026603415 (Priority Date: 22.08.2026)
- Author & Copyright Holder: Vladislav Anatolyevich Utyansky
📅 Timeline of Verified Priority:
- March 22, 2026 (19:17 MSK) — Initial worldwide public disclosure of the architecture (Public Release v1.0 on GitHub, commit
51584ac).- August 22, 2026 (16:42 MSK) — Official software registration filed at Rospatent RF (Application № 2026603415, Gosuslugi docket 7927650015).
- September 11, 2026 (11:20 MSK) — v2.1 Industrial Edition Release: implementation of deterministic AST slot isolation engine
utyansky_ast_engine.js(Babel AST context lock O(1), defensive coordinate validation[ERR: 10451], and dependency trackingImportDeclaration).- September 12, 2026 (21:55 MSK) — v2.2 Web Coordinate Standard & AI Vision Release: open standard for deterministic DOM coordinate markup (
70000–79999), interactive HUD DOM Inspector («AI Vision») for instant agent orientation, zero hallucinations, and regression prevention.- September 20, 2026 (11:00 MSK) — v2.3 Telegram Bot, Zero-Lock & Vibe-Coding Release: open standard for deterministic slot isolation $O(1)$ in Telegram API and asynchronous bots. Hardware 64-byte
callback_datapayload bypass (zeroBUTTON_DATA_INVALID), zero context loss during vibe-coding, 360° customer dossier module («Microscope»), establishment of the Zero-Lock & Conditional Constraint Class (-00000…-00099) for deterministic mutation control, and expansion of the Periodic Table to 10 Classes (00–09).
🚀 NEW: Telegram Bot Architecture, 64-Byte Bypass & Vibe-Coding ($O(1)$ Telegram Bot Standard)
How to build multi-screen resilient Telegram bots with AI and 1 developer:
- ⚡ 64-Byte Payload Bypass: Compact slot addressing (12–22 bytes) permanently prevents fatal
BUTTON_DATA_INVALIDerrors.- 🛡️ Zero Regression During Vibe-Coding: AI assistants (Cursor, Claude Code, Windsurf) edit cards and menus with surgical precision without breaking neighbor event handlers.
- 🔬 «Microscope» 360° Dossier: Instant inspection of client LTV, payment history, referral graph, bandwidth usage, and 2-way support ticket desk directly in admin chat.
- 💰 80% API Budget Savings: Token consumption drops from 120k to 25k per feature with a 6x–8x development acceleration.
👉 📖 READ CASE STUDY & GUIDE (RU) ➔ | 🌐 Interactive Live Case Page ➔
🌐 Web Coordinate Standard & AI Vision ($O(1)$ DOM Navigation)
Turn any website layout into a deterministic coordinate map for AI agents:
- 🚫 Eliminate AI Blindness: Neural networks no longer drown in chaotic Tailwind
<div>structures.- 🛡️ Zero Regression: AI assistants (Cursor, Claude Code, Windsurf) target the exact node
data-idx="7XXXX"without corrupting adjacent markup.- 🤖 100% Search Accuracy: Yandex Neuro, Perplexity, and ChatGPT Search extract prices, offers, and buttons without hallucinating.
👉 🌐 READ WEB INDEXING GUIDE (RU) ➔ | 🇬🇧 Read in English ➔ | 💻 Live HTML Demo ➔
🧭 Choose Your Track for Fast Navigation:
- 🌐 Web Site AI Optimization (AIO) & DOM Markup (70000–79999) ➔ (AIO specification, HTML/React DOM tagging, zero AI blindness, 0% markup regressions, live demo and HUD inspector)
- 💼 For Executives, Founders & Business (Business Value, ROI, 7 Sins) ➔ (Real-world analogies, 85% token cost reduction, regression immunity, financial ROI, and Engineering Center plans)
- ⚙️ For Architects, CTOs & Lead Engineers (Technical Specification) ➔ (Periodic matrix of 9 domains 10000–99999, AST parsing, pgvector 1.5M+ coordinate sharding, UVWI math, and TOP-20 technical FAQ)
The Utyansky Index is an end-to-end 5-digit coordinate industrial standard (10000 – 99999) engineered for vibe coding, multi-agent AI systems, React DOM interfaces, marketing ROI quantification (UVWI Viral Resonance metric), and isolated vector memory.
Instead of forcing AI to "guess" functions via imprecise keywords in stochastic RAG searches, the Utyansky Index assigns every UI element, backend module, and function a rigid, deterministic 5-digit coordinate passport.
Standard Philosophy: «Stop Searching. Start Addressing.»
Just as an electrical socket during building construction is placed at an exact 30 cm height according to engineering building codes rather than "somewhere visually nice", code elements must possess rigid numeric coordinates so AI never breaks working systems again.
| Principle | Description | Without Index (Stochastic Chaos) | With Utyansky Index (Determinism) |
|---|---|---|---|
| 🧱 LEGO Compatibility | Modules snap together automatically via identical 5-digit coordinate slots. | Integration hell: fragile custom glue breaks on every API update. | 100% component compatibility by pin numbers. |
| 🌐 Cross-Stack Address Bus | Universal highway connecting React DOM, Python, Rust, amoCRM, and SQL. | AI blurs stack boundaries and generates incompatible interfaces. | AI generates precise glue code in <1s for slot [IDX: 98100]. |
| 🛡️ Aerospace Reliability | Modular invulnerability and hot-swapping blocks with Zero Downtime. | Spaghetti code: fixing a scraper breaks auth and crashes prod. | Isolation: swap node 20100 on the fly with zero system downtime. |
[!NOTE] 💡 What does "O(1) addressing" mean in simple terms for non-engineers:
In computer science, O(1) (Big-O of 1) simply means "hitting the exact target in 1 single step":
- Without the Index (Blind Search): The AI reads through 1,000+ lines of code from top to bottom just to find one button (like looking for a needle in a haystack). It gets confused, hallucinates, and burns expensive tokens.
- With Utyansky Index O(1): Every element receives a rigid 5-digit coordinate passport (e.g.,
71080). The AI jumps directly to the targeted node in 1 action (in 0.05s) without re-reading or corrupting adjacent code.
(Based on real developer community discussions across Reddit r/Cursor, r/ChatGPTCoding, Hacker News & Habr)
| 🔍 Search Query / Real Pain Point | 💥 Root Cause of AI Failure | 🛡️ Solution via «Utyansky Index v2.0» |
|---|---|---|
«Cursor deletes functions and replaces code» (// rest of code unchanged) | Context compression causes LLMs to become lazy, substituting code with comments. | Isolated slot data-idx="7XXXX": AI sees and edits strictly 40 lines of the target container. 0% code overwrite. |
| «AI agents burn 80-90% of tokens on search» (Token Burn Rate) | Agents query dozens of files blindly, burning up to 150,000 tokens just locating code. | Deterministic Slot Targeting: Instant direct jump to coordinate [IDX: 80104] without scanning files. 85% token savings. |
| «Vibe coding breaks working features» (Code Regression) | Lack of hard boundaries across React DOM, backend, and hooks (useEffect, routes). | «Iron Dome» Coordinate Cage: Complete mutation protection and domain isolation across 9 classes. |
| «Multiple AI agents overwrite each other» (Merge Conflict) | Autonomous workers edit overlapping modules, creating merge collisions. | Channelized Range Allocation: Analytics writes in 20000–29999, Media in 30000–39999, UI in 70000–79999. |
| «Graph RAG blindness in large repositories» | Graphs map semantic concepts but are blind inside physical 1000-line files. | Physical Node ID: Rigid coordinates 10000–99999 like "door apartment numbers". 99.9% precision. |
| «Fragility of Hashline and AST UI blindness» | Line hashes fail on 1 whitespace change; AST is blind in DOM with 15 identical buttons. | End-to-End Passport: data-idx="71080" connects visual buttons directly to CRM webhooks and backend logs. |
| «Out Of Memory (OOM) on billions of vectors» | Flat HNSW graphs across terabytes of data exhaust RAM and crash nodes. | 2-Level Coordinate Sharding: Partitioning PostgreSQL pgvector across slots 98000–99999 (1B+ to 1T+ vectors). |
🏠 Executive Analogy: Home Renovation & Marketplace Fulfillment Center
- Vibe Coding without Index (Chaos): Like a construction crew renovating an apartment without architectural blueprints. You ask to "hang a wall picture", and the worker drills directly into hidden electrical wiring, blacking out the entire building. Or like a massive Amazon/Wildberries fulfillment center with 1,000,000 items piled into one chaotic mountain in the center of the warehouse — locating a single box requires 20 workers to tear the whole warehouse apart.
- Engineering with the Utyansky Index (Determinism): Every electrical outlet and plumbing pipe has strict numerical coordinates compliant with engineering building standards. In the warehouse, every item has an exact coordinate bin (Aisle 7, Rack 10, Shelf 80). The automated robot glides over in 1 second, picks the exact item, and leaves adjacent inventory 100% undisturbed.
// rest of code unchanged. Screen turns white, everything is broken!»data-idx="71080" (40 lines). The AI physically cannot see or mutate the other 960 lines. 0% accidental regressions.UTYANSKY_INDEX_REGISTRY.json. The AI accesses exact numerical bins via direct $O(1)$ addressing without needing to hold the whole project in working memory.10000–99999) and 10 physical database columns. Code is structured according to industrial engineering blueprints from day one.STATUS: OK and active block auto-audit. Once a component is indexed with a 5-digit passport, AI locks it against parasitic side-effects..cursorrules / AGENTS.md. Any AI assistant (Cursor, Claude Code, Windsurf, Antigravity) and any human engineer reads the 5-digit coordinate map in 5 minutes.| Performance Metric | Without Utyansky Index (Chaos) | With Utyansky Index (Determinism) | Business Savings |
|---|---|---|---|
| Time to implement surgical tweak | 30–60 minutes (with debugging) | 2–3 minutes | 10x–20x Acceleration |
| AI / LLM API Token Invoices | 100% (up to $1,500/mo) | 15–20% (up to $200/mo) | 80–85% Token Cost Reduction |
| Accidental UI / Code Regressions | 35–50% of edits break adjacent features | 0% Regressions | 100% Production Stability |
| New Developer / AI Onboarding | 3–5 working days | 15 minutes (reading registry) | Saves up to 40 Senior dev hours |
| Codebase Lifetime & Scalability | 2–3 months (until complete rewrite) | Unlimited (Modular Framework) | Preserves Software Capital |
To rigorously evaluate the standard without marketing bias, the complete specification was submitted for independent double-blind audit to nine frontier AI leaders across Russia, the USA, and China.
All 9 independent systems converged on the same engineering consensus:
| Model / Origin | Primary Technical Assessment & Verdict |
|---|---|
| 🇷🇺 GigaChat (Sber / Russia) | «Not an algorithmic gimmick, but a solid industrial protocol... Restricting model focus to a 40-line slot physically eliminates hallucinations and mathematically grounds up to 85% token cost savings. data-idx provides unbreakable selectors for Playwright/Cypress.» |
| 🇷🇺 Alice (Yandex / Russia) | «Baseline national standard for protecting code during vibecoding. Forms the reliability triad: TypeScript (types) + ESLint (style) + Utyansky Index (AI scope boundaries). Pre-commit validation at 0.006s provides zero-drift guarantee.» |
| 🌐 Claude (Anthropic / USA) | «In large production apps with 15 identical buttons, semantic RAG search frequently confuses targets. Direct coordinate addressing solves this like an automated fulfillment warehouse. It is sound engineering practice that realistically saves colossal developer-hours at scale.» |
| 🇺🇸 ChatGPT (OpenAI / USA) | «RAG answers: "What should I read?", IDX answers: "Where am I allowed to work?". This unlocks a powerful architecture: IDX-Constrained RAG, strictly locking the agent within its declared contract boundary.» |
| 🇨🇳 DeepSeek (China) | «Principle of Least Privilege. Radically slashes token entropy. The claimed 80–85% savings is conservative (empirically up to 99.3%). First control, then intelligence. Unconditionally adopt for AI agents!» |
| 🇨🇳 Qwen 2.5 (Alibaba / China) | «The only mathematically provable solution for O(1) context isolation in AI agent systems. Conclusively outperforms LSP, MCP edit_file, and metadata-filtered vector search. BEM for the LLM Era. Audit complete, objections withdrawn!» |
| 🇺🇸 Google Gemini (Google / USA) | «DNS for code: cross-stack addressing from UI to backend. Token economy mathematically proven at 84% via formal context profiling. data-idx stability is absolute and immune to physical line shifts (persistent AST node UUID). Barrier against vibecoding garbage.» |
| 🇺🇸 Perplexity AI (USA) | «Write Authorization Layer for code (Capability-Based Security). Slashes blast radius and mathematically confirms 82.5% token economy. Coined Golden Formula: RAG finds, LSP understands, IDX restricts, TS verifies, CI enforces!» |
| 🇺🇸 Grok (xAI / Musk) | «Orthogonal axis of control (First Principles). The triad separates failure modes: TS catches types, linters catch style, the Index is the write-authorization layer. It is an axis TS and linters do not cover. Cheap 0.006s gate turns prompt discipline into a verifiable invariant.» |
🏛️ The Golden Engineering Formula of Safe AI Coding (G9 Synthesis):
"RAG helps find; LSP helps understand; IDX helps accurately address and restrict; TypeScript & tests help verify; CI enforces the rules."
AI_SYSTEM_PROMPT.md) and guards commits with a 0.006s pre-commit gate and GitHub Actions CI (examples/validate-index.js).IDX-Constrained RAGDuring the stress test, frontier model ChatGPT (OpenAI) conceded technical victory to the standard and coined a foundational new principle: IDX-Constrained RAG (Scope-Bounded Retrieval).
🔥 The Core Axiom of the Paradigm:
«RAG answers: "What should I read?"
IDX answers: "Where am I allowed to work?"»
[IDX: 71080]), forcing RAG to retrieve context strictly inside this authorized perimeter, delivering 0% unintended edits and up to 85–99% token cost reduction.👉 Read the Official Global AI Peer Review Report (docs/en/LLM_INDEPENDENT_AUDIT_EN.md) ➔
🔬 Verify Yourself: Protocol for Skeptics (Blind Test) ➔
| Tool | Defense Layer | What It Verifies |
|---|---|---|
| TypeScript | Type Safety | Type compatibility, interface signatures, null-safety |
| ESLint | Code Style & Patterns | Linting rules, anti-patterns, hygiene and best practices |
| Utyansky Index | AI Scope Boundaries | Coordinate slot isolation, collision defense, physical slot registry |
Separation of Concerns Principle:
TypeScript and ESLint verify code quality. The Utyansky Index governs authorized modification boundaries for AI agents. Their responsibilities do not overlap: TypeScript cannot prevent an LLM from wiping an adjacent component, and ESLint cannot detect when an agent mutates an unregistered slot. Each layer mitigates distinct systemic risks.
| Parameter | Stochastic RAG | IDX-Constrained (Utyansky Index) |
|---|---|---|
| Context Ingestion | Top-K by cosine similarity (pulls up to 30 files with similar tokens) | Single target file via exact coordinate $O(1)$ |
| Editing Boundaries | Undefined — model rewrites entire file | data-idx establishes an unbreachable slot boundary |
| Code Overwrite Defense | None (// rest of code unchanged) | Exact coordinate isolates specific sub-block |
| Multi-Agent Collisions | Undetected (race conditions) | Pre-commit and CI block duplicate slot collisions |
| Infrastructure Overhead | Vector DB, embeddings, chunking, Top-K calibration | Single lightweight JSON registry + 0.006s validator |
The Synergy Formula: RAG answers «What is relevant?». Coordinate addressing answers «What is permitted to touch?». They are complementary layers that multiply developer velocity.
UTYANSKY_INDEX_REGISTRY.json in repo root with domain ranges (CORE 10000, ANALYTICS 20000, UI 70000, DATA 90000).data-idx on key components — start with high-traffic AI editing touchpoints (buttons, forms, cards).validate-index.js to pre-commit hook (Husky / Git hook) for bidirectional cross-checking: registry ↔ source code ↔ disk..github/workflows/validate-index.yml) — automated cloud verification in 0.006s.data-idx. Never rewrite whole files — output only modified lines»."status": "LOCKED" in the registry — readable by LLMs, but mutation forbidden.📌 10-Point Technical Summary on AIO:
- AI Blindness in Traditional Code: Standard HTML with thousands of nested
<div>and utility CSS classes (Tailwind) encodes visual layout, but contains zero semantic clues for LLMs.- Multi-Component Ambiguity: When 15 identical buttons ("Order", "Submit", "Learn More") coexist on a single page, AI confuses context and breaks adjacent code.
- Indelible Coordinate Passport: Each functional node receives a strict 5-digit coordinate
data-idx="7XXXX"(range70000–79999) and bilingual semantic roledata-desc="...".- Surgical $O(1)$ Slot Isolation: AI assistants (Cursor, Claude Code, Windsurf) edit strictly the targeted 40-line container without touching the surrounding 1,000 lines.
- 0% Code Overwrites & Regressions: LLMs are physically prevented from leaving
// rest of code unchangedplaceholders that break pages into blank crash screens.- Clarity for Next-Gen AI Search: ChatGPT Search, Perplexity, and Google Gemini accurately extract prices, CTAs, and offers without hallucinations.
- End-to-End Traceability to CRM: One coordinate links a browser button, analytics goal, backend API handler, and amoCRM deal pipeline.
- Unbreakable E2E Test Locators: Playwright and Cypress selectors (
page.locator('[data-idx="74010"]')) never break upon visual redesigns.- Interactive DOM Inspector: The lightweight client script
src/utyansky-web-inspector.jsenables instant coordinate X-Ray ("AI Vision") on any site via a single script tag.- Ready-to-Use Reference Template: A complete, interactive production landing page layout is published at
examples/website-coordinate-markup.html.
<!-- Example of coordinate markup on a primary conversion button -->
<div
data-idx="74010"
data-desc="[BUTTON] Primary commercial checkout button triggering CRM pipeline"
class="relative flex items-center justify-between p-4 bg-slate-800 rounded-2xl">
<span>Order Now</span>
</div>
👉 📖 READ FULL WEB SITE INDEXING GUIDE (EN) ➔
👉 🇷🇺 Читать на Русском ➔ | 💻 Live HTML Demo ➔ | 🛠️ utyansky-web-inspector.js ➔
CURSOR_RULES_INTEGRATION.md / AI_SYSTEM_PROMPT.md (or in Russian / docs/ru/CURSOR_RULES_INTEGRATION.md) — ready system prompt and .cursorrules blueprint for your AI assistant.examples/UTYANSKY_INDEX_REGISTRY.json — coordinate registry file for storing project slots.examples/validate-index.js — CLI validator script checking index uniqueness in 0.1s..cursorrules file in your project root and paste the contents of CURSOR_RULES_INTEGRATION.md (or AI_SYSTEM_PROMPT.md).AGENTS.md file (or paste into your custom system instructions).https://raw.githubusercontent.com/vlad-utyansky/utyansky-index/main/AI_SYSTEM_PROMPT.md[IDX: 71080] [BTN] Launch Analysis Button, [IDX: 72100] [FORM] Admin Panel Form.[ERR: 40101] Invalid Index Format, [ERR: 40102] Coordinate Collision, [ERR: 50010] LLM Deviation.| Range | Standard Class | Domain Purpose | Coordinate Examples |
|---|---|---|---|
00000 – 00099 | 00. Ring-0 Master Locks | Invariants, mutation locks, quarantine TTL, immutable layout | 70050-00000 (Master Lock), 70050-00001 (TTL) |
10000 – 19999 | 01. System Core | System architecture, initialization, routing, global configs | 10010 (Router), 10050 (Init Engine) |
20000 – 29999 | 02. Search & Analytics | Scrapers, search engines, web crawlers, trend radars | 20100 (Parser), 20150 (Radar) |
30000 – 39999 | 03. Media Production | Script synthesis, AI voiceover, video montage, storyboards | 30010 (Brief), 30100 (Timeline) |
40000 – 49999 | 04. SMM Engine | Content calendars, auto-publishing, social distribution | 40050 (Telegram), 40100 (SMM Grid) |
50000 – 59999 | 05. External Integrations | amoCRM, WhatsApp, Telegram Bot API, telephony | 50010 (CRM Webhook), 50020 (MAX Messenger) |
60000 – 69999 | 06. Analytics & Reports | Business KPI dashboards, PDF/Excel export, data scoring | 60010 (Dashboard), 60100 (PDF Export) |
70000 – 79999 | 07. Visual UI / DOM | Buttons, cards, modals, interactive React DOM forms | 71080 (Action Btn), 71200 (Modal Window) |
80000 – 89999 | 08. Marketing & ROI (UVWI) | Viral resonance metric (UVWI), token billing, limits | 85010 (UVWI Calc), 88010 (Billing Bus) |
90000 – 99999 | 09. Archives & Memory | Vector database (pgvector HNSW), memory dumps, audit | 98000 (Vector Search), 99010 (Audit Log) |
The standard translates subjective "likes and vanity views" into exact mathematical ROI predictions:
$\text{UVWI [85010]} = \frac{\text{Verified Positive WOW Responses [21303]}}{\text{Total Audience Reach [92020]}} \times 100%$
-00000 – -00099):When a 5-digit sub-index with leading zeros (-00000 through -00099) is appended to a base coordinate, it serves as a mandatory architectural constraint trigger for AI agents, compilers, and developers.
🛑 The Zero-Lock Directive: Before touching, moving, or refactoring any node with a
-00XXXsuffix, the system MUST inspect the semantic instructions indata-descor the project Change Contract to determine the exact restriction level, reason, and conditional unlock criteria.
| Suffix | Security Class | Architectural Constraint & Release Conditions |
|---|---|---|
XXXXX-00000 | 🔒 Master Invariant (Absolute Lock) | Total ban on mutations, deletions, or repositioning. Node is sacred. Changes allowed strictly with direct, step-by-step developer authorization. |
XXXXX-00001 | ⏳ Temporal / TTL Lock (Time Quarantine) | Restricted by date, countdown, or TTL period (e.g. "14-day quarantine", "Do not touch before Release 25.09.2026"). Automatically unlocked upon expiration. |
XXXXX-00002 | 🌐 External Dependency Lock | Blocked until verified external event occurs (API version transition, App Store approval, partner contractual sign-off). |
XXXXX-00003 | 👨💻 Developer Review Lock | Mutations permitted only after mandatory pre-flight review with the lead architect. |
XXXXX-00004 | 📐 Layout & Position Lock | Node position and hierarchy are immutable; localized styling/copy cosmetic edits are permitted. |
XXXXX-00005 | ✍️ Copywriting & Meaning Lock | Brand voice, offers, and text are protected; technical layout refinements are permitted. |
XXXXX-00006 – -00099 | 📦 Reserved Safe Slots | Open expansion range for team-specific governance and dynamic business constraints. |
UTYANSKY_INDEX_REGISTRY.json){
"project": "MyAwesomeProject",
"standard": "Utyansky Index v2.0",
"registry": {
"10010": { "domain": "CORE", "type": "ROUTER", "desc": "Main Router", "file": "src/App.jsx" },
"71080": { "domain": "UI_DOM", "type": "BTN", "desc": "Launch Analysis Button", "file": "src/components/ActionButton.jsx" },
"85010": { "domain": "METRICS_ROI", "type": "CALC", "desc": "UVWI Calculator", "file": "src/utils/uvwi.js" }
}
}
Knowledge graphs show WHAT is connected, but are blind inside 1000-line files. The Utyansky Index is the 'apartment number on the door': it assigns rigid 5-digit coordinates 10000–99999 and protects surrounding code from accidental AI overwrites during localized slot edits.
| Factor | ❌ BEFORE Index (Stochastic Chaos) | ✅ AFTER Utyansky Index (Determinism) |
|---|---|---|
| Code Breakage | AI modifies 1 button and breaks surrounding layout or styles. | 0% Regressions. All modifications are isolated inside data-idx. |
| Token Consumption | The entire 1500-line file is loaded into context, burning budget. | 80–85% Token Savings. Only the target 40-line slot is fed to the LLM. |
| Prompt Simplicity | Lengthy descriptions: «find the blue button in bottom right...» | 1 Concise Line: «In slot [71080] change button color». |
AI reads coordinates directly from UTYANSKY_INDEX_REGISTRY.json or in-place data-idx DOM tags. Coordinates are deterministic integers that never shift randomly.
AST sees class hierarchies but is blind in visual UI where 15 identical <button> elements exist. data-idx="71080" creates a physical coordinate passport linking UI directly to CRM webhooks and backend logs.
Line hashes break upon any whitespace change. MCP is a tool calling transport protocol. The Utyansky Index is a system-wide deterministic coordinate address bus across the full software lifecycle.
In tiny 50-line files LLMs are reliable. But in 1000+ line production files, models truncate code as // rest of code unchanged. The Utyansky Index coordinate cage physically eliminates this flaw.
Yes. The Utyansky Index was designed as a cross-stack highway connecting React DOM, Python workers, 1C, amoCRM, PostgreSQL pgvector, and CAD metadata.
Uppercase filenames receive highest priority indexing across major AI IDE parsers (Cursor, Windsurf, Claude Code, Antigravity).
Zero rewrite needed: paste AI_SYSTEM_PROMPT.md into .cursorrules / AGENTS.md, tag active components with data-idx="7XXXX", and validate uniqueness via node examples/validate-index.js.
The built-in CLI validator validate-index.js integrates into your pre-commit pipeline (Husky/Git hooks) to halt commits with [ERR: 40102] Coordinate collision in 0.1s.
data-idx="71080" and data-desc="..." are official W3C HTML5 standard dataset attributes. They are 100% native in TypeScript JSX and never conflict with Tailwind utility classes.
Impact is exactly 0.00%. 5-digit dataset attributes add less than 0.04% to raw HTML, compressing to virtually zero under Gzip/Brotli.
One single event listener document.addEventListener("click", e => ...) captures target.dataset.idx and triggers analytics goals seamlessly.
Yes. Multi-agent workers are locked inside bounded numerical ranges (e.g. Support in 20000–29999), instantly aborting cross-domain injection attempts with [ERR: 40301].
The Utyansky Index is the world most resilient E2E selector: page.locator("[data-idx=71080]").click(). Tests never break during redesigns or CSS renaming.
Yes. Microservices pass coordinates via standard tracing headers X-Utyansky-Coordinate: 20150 or annotations, enabling end-to-end tracing from browser to SQL database.
Wrap legacy boundaries in coordinate slots [IDX: 95000-LEGACY-AUTH]. AI agents respect legacy borders without breaking dependencies.
Only functional nodes, buttons, forms, cards, and domain containers are indexed. Decorative styling wrappers remain clean and untouched.
MCP is the tool calling transport protocol, while Utyansky Index is the master coordinate map providing deterministic addressing for MCP tool servers.
The «Utyansky Index» standard is distributed under a transparent hybrid Open-Core model:
| Edition / Tier | Pricing | Target Audience | What is Included |
|---|---|---|---|
| 🆓 Community Edition | 100% Free (MIT) | Vibe coders, indie hackers, open-source projects, students | • Open 5-digit coordinate grid (10000–99999)• React DOM markup ( data-idx="7XXXX")• Ready rule templates for Cursor AI, Claude Code, Windsurf • CLI collision validator script validate-index.js |
| 🛠️ Turnkey Express Setup & Audit | from 120,000 ₽ (one-time) | Startups, digital agencies, businesses with existing vibe-coding MVPs | • Express codebase audit for hidden regressions and hallucinated leaks • End-to-end 5-digit DOM and backend indexing • Generation of UTYANSKY_INDEX_REGISTRY.json master map• Git Pre-commit hook & CI/CD pipeline integration • Team training and customized AI prompt rules |
| 💼 Monthly Retainer (Small Business) | 5,000 – 10,000 ₽ / mo | Niche SaaS, local services, e-commerce stores | • Monthly coordinate registry updates for new features • Context cleanliness audit and commit verification • Priority AI agent integration consultations |
| 🏢 Monthly Retainer (Mid-Market) | 25,000 – 45,000 ₽ / mo | Product IT companies, CRM/ERP ecosystems, high-volume e-commerce | • Multi-agent system architecture supervision • LLM token cost optimization and invoice monitoring • Vector memory isolation setup ( pgvector)• VAU EFFECT Engineering Group supervision & architecture board under the author guidance |
| 🏛️ Enterprise & Corporations | 90,000 – 150,000 ₽ / mo | Banks, fintech, closed corporate holdings, enterprise brands | • Personal architecture supervision by Vladislav Utyansky + priority SLA of VAU EFFECT Engineering Center • Proprietary API access for viral resonance calculation (UVWI [IDX: 85010])• High-scale vector sharding for 1B+ records • Official AI Precision Brand-Certificate |
data-idx="7XXXX"), semantic styling isolation & BEM structuring.allowed_idx, read_context_idx, protected_idx).utyansky_ast_engine.js.[ERR: 10451].ImportDeclaration.70000–79999) for AI Search optimization (AIO: ChatGPT Search, Perplexity, Yandex Neuro).utyansky-web-inspector.js / "AI Vision").callback_data (zero BUTTON_DATA_INVALID).-00000 … -00099): Master Invariants, TTL quarantine, external triggers, and developer review workflows.00 – 09).ProtectedSurface) via CODEOWNERS and GitHub Rulesets.173 commits
HTML
94.0%
JavaScript
6.0%
The Periodic Table of Code. A global deterministic addressing standard for AI agents, modular systems, and human-machine interoperability.
HTML
2
173 commits
updated Sep 24, 2026
📜 Official CERN Zenodo DOI:
10.5281/zenodo.22934668
🛡️ Rospatent RF Application: No. 2026603415 / 7927650015
🌐 Official Portal: https://index.utyanskiy.ru
[!TIP]
⭐ Support & Feedback
I’d be genuinely grateful for your feedback! If the Utyansky Index helped you tame AI hallucinations, save tokens, or streamline your architecture — please consider supporting this project with a ⭐ Star (click the Star button in the top-right corner of this page).
As an independent author, your star is the greatest motivation to keep advancing this open standard!
🏛️ Rospatent RF Application and Priority Timeline
- Copyright Object: Computer Software «Deterministic Coordinate Navigation and Data Routing System for Artificial Intelligence and Software "Utyansky Index" (Utyansky Index v2.0)»
- Intellectual Property Office: Federal Service for Intellectual Property (Rospatent RF / FIPS)
- Official Application Number: № 2026603415 (Priority Date: 22.08.2026)
- Author & Copyright Holder: Vladislav Anatolyevich Utyansky
📅 Timeline of Verified Priority:
- March 22, 2026 (19:17 MSK) — Initial worldwide public disclosure of the architecture (Public Release v1.0 on GitHub, commit
51584ac).- August 22, 2026 (16:42 MSK) — Official software registration filed at Rospatent RF (Application № 2026603415, Gosuslugi docket 7927650015).
- September 11, 2026 (11:20 MSK) — v2.1 Industrial Edition Release: implementation of deterministic AST slot isolation engine
utyansky_ast_engine.js(Babel AST context lock O(1), defensive coordinate validation[ERR: 10451], and dependency trackingImportDeclaration).- September 12, 2026 (21:55 MSK) — v2.2 Web Coordinate Standard & AI Vision Release: open standard for deterministic DOM coordinate markup (
70000–79999), interactive HUD DOM Inspector («AI Vision») for instant agent orientation, zero hallucinations, and regression prevention.- September 20, 2026 (11:00 MSK) — v2.3 Telegram Bot, Zero-Lock & Vibe-Coding Release: open standard for deterministic slot isolation $O(1)$ in Telegram API and asynchronous bots. Hardware 64-byte
callback_datapayload bypass (zeroBUTTON_DATA_INVALID), zero context loss during vibe-coding, 360° customer dossier module («Microscope»), establishment of the Zero-Lock & Conditional Constraint Class (-00000…-00099) for deterministic mutation control, and expansion of the Periodic Table to 10 Classes (00–09).
🚀 NEW: Telegram Bot Architecture, 64-Byte Bypass & Vibe-Coding ($O(1)$ Telegram Bot Standard)
How to build multi-screen resilient Telegram bots with AI and 1 developer:
- ⚡ 64-Byte Payload Bypass: Compact slot addressing (12–22 bytes) permanently prevents fatal
BUTTON_DATA_INVALIDerrors.- 🛡️ Zero Regression During Vibe-Coding: AI assistants (Cursor, Claude Code, Windsurf) edit cards and menus with surgical precision without breaking neighbor event handlers.
- 🔬 «Microscope» 360° Dossier: Instant inspection of client LTV, payment history, referral graph, bandwidth usage, and 2-way support ticket desk directly in admin chat.
- 💰 80% API Budget Savings: Token consumption drops from 120k to 25k per feature with a 6x–8x development acceleration.
👉 📖 READ CASE STUDY & GUIDE (RU) ➔ | 🌐 Interactive Live Case Page ➔
🌐 Web Coordinate Standard & AI Vision ($O(1)$ DOM Navigation)
Turn any website layout into a deterministic coordinate map for AI agents:
- 🚫 Eliminate AI Blindness: Neural networks no longer drown in chaotic Tailwind
<div>structures.- 🛡️ Zero Regression: AI assistants (Cursor, Claude Code, Windsurf) target the exact node
data-idx="7XXXX"without corrupting adjacent markup.- 🤖 100% Search Accuracy: Yandex Neuro, Perplexity, and ChatGPT Search extract prices, offers, and buttons without hallucinating.
👉 🌐 READ WEB INDEXING GUIDE (RU) ➔ | 🇬🇧 Read in English ➔ | 💻 Live HTML Demo ➔
🧭 Choose Your Track for Fast Navigation:
- 🌐 Web Site AI Optimization (AIO) & DOM Markup (70000–79999) ➔ (AIO specification, HTML/React DOM tagging, zero AI blindness, 0% markup regressions, live demo and HUD inspector)
- 💼 For Executives, Founders & Business (Business Value, ROI, 7 Sins) ➔ (Real-world analogies, 85% token cost reduction, regression immunity, financial ROI, and Engineering Center plans)
- ⚙️ For Architects, CTOs & Lead Engineers (Technical Specification) ➔ (Periodic matrix of 9 domains 10000–99999, AST parsing, pgvector 1.5M+ coordinate sharding, UVWI math, and TOP-20 technical FAQ)
The Utyansky Index is an end-to-end 5-digit coordinate industrial standard (10000 – 99999) engineered for vibe coding, multi-agent AI systems, React DOM interfaces, marketing ROI quantification (UVWI Viral Resonance metric), and isolated vector memory.
Instead of forcing AI to "guess" functions via imprecise keywords in stochastic RAG searches, the Utyansky Index assigns every UI element, backend module, and function a rigid, deterministic 5-digit coordinate passport.
Standard Philosophy: «Stop Searching. Start Addressing.»
Just as an electrical socket during building construction is placed at an exact 30 cm height according to engineering building codes rather than "somewhere visually nice", code elements must possess rigid numeric coordinates so AI never breaks working systems again.
| Principle | Description | Without Index (Stochastic Chaos) | With Utyansky Index (Determinism) |
|---|---|---|---|
| 🧱 LEGO Compatibility | Modules snap together automatically via identical 5-digit coordinate slots. | Integration hell: fragile custom glue breaks on every API update. | 100% component compatibility by pin numbers. |
| 🌐 Cross-Stack Address Bus | Universal highway connecting React DOM, Python, Rust, amoCRM, and SQL. | AI blurs stack boundaries and generates incompatible interfaces. | AI generates precise glue code in <1s for slot [IDX: 98100]. |
| 🛡️ Aerospace Reliability | Modular invulnerability and hot-swapping blocks with Zero Downtime. | Spaghetti code: fixing a scraper breaks auth and crashes prod. | Isolation: swap node 20100 on the fly with zero system downtime. |
[!NOTE] 💡 What does "O(1) addressing" mean in simple terms for non-engineers:
In computer science, O(1) (Big-O of 1) simply means "hitting the exact target in 1 single step":
- Without the Index (Blind Search): The AI reads through 1,000+ lines of code from top to bottom just to find one button (like looking for a needle in a haystack). It gets confused, hallucinates, and burns expensive tokens.
- With Utyansky Index O(1): Every element receives a rigid 5-digit coordinate passport (e.g.,
71080). The AI jumps directly to the targeted node in 1 action (in 0.05s) without re-reading or corrupting adjacent code.
(Based on real developer community discussions across Reddit r/Cursor, r/ChatGPTCoding, Hacker News & Habr)
| 🔍 Search Query / Real Pain Point | 💥 Root Cause of AI Failure | 🛡️ Solution via «Utyansky Index v2.0» |
|---|---|---|
«Cursor deletes functions and replaces code» (// rest of code unchanged) | Context compression causes LLMs to become lazy, substituting code with comments. | Isolated slot data-idx="7XXXX": AI sees and edits strictly 40 lines of the target container. 0% code overwrite. |
| «AI agents burn 80-90% of tokens on search» (Token Burn Rate) | Agents query dozens of files blindly, burning up to 150,000 tokens just locating code. | Deterministic Slot Targeting: Instant direct jump to coordinate [IDX: 80104] without scanning files. 85% token savings. |
| «Vibe coding breaks working features» (Code Regression) | Lack of hard boundaries across React DOM, backend, and hooks (useEffect, routes). | «Iron Dome» Coordinate Cage: Complete mutation protection and domain isolation across 9 classes. |
| «Multiple AI agents overwrite each other» (Merge Conflict) | Autonomous workers edit overlapping modules, creating merge collisions. | Channelized Range Allocation: Analytics writes in 20000–29999, Media in 30000–39999, UI in 70000–79999. |
| «Graph RAG blindness in large repositories» | Graphs map semantic concepts but are blind inside physical 1000-line files. | Physical Node ID: Rigid coordinates 10000–99999 like "door apartment numbers". 99.9% precision. |
| «Fragility of Hashline and AST UI blindness» | Line hashes fail on 1 whitespace change; AST is blind in DOM with 15 identical buttons. | End-to-End Passport: data-idx="71080" connects visual buttons directly to CRM webhooks and backend logs. |
| «Out Of Memory (OOM) on billions of vectors» | Flat HNSW graphs across terabytes of data exhaust RAM and crash nodes. | 2-Level Coordinate Sharding: Partitioning PostgreSQL pgvector across slots 98000–99999 (1B+ to 1T+ vectors). |
🏠 Executive Analogy: Home Renovation & Marketplace Fulfillment Center
- Vibe Coding without Index (Chaos): Like a construction crew renovating an apartment without architectural blueprints. You ask to "hang a wall picture", and the worker drills directly into hidden electrical wiring, blacking out the entire building. Or like a massive Amazon/Wildberries fulfillment center with 1,000,000 items piled into one chaotic mountain in the center of the warehouse — locating a single box requires 20 workers to tear the whole warehouse apart.
- Engineering with the Utyansky Index (Determinism): Every electrical outlet and plumbing pipe has strict numerical coordinates compliant with engineering building standards. In the warehouse, every item has an exact coordinate bin (Aisle 7, Rack 10, Shelf 80). The automated robot glides over in 1 second, picks the exact item, and leaves adjacent inventory 100% undisturbed.
// rest of code unchanged. Screen turns white, everything is broken!»data-idx="71080" (40 lines). The AI physically cannot see or mutate the other 960 lines. 0% accidental regressions.UTYANSKY_INDEX_REGISTRY.json. The AI accesses exact numerical bins via direct $O(1)$ addressing without needing to hold the whole project in working memory.10000–99999) and 10 physical database columns. Code is structured according to industrial engineering blueprints from day one.STATUS: OK and active block auto-audit. Once a component is indexed with a 5-digit passport, AI locks it against parasitic side-effects..cursorrules / AGENTS.md. Any AI assistant (Cursor, Claude Code, Windsurf, Antigravity) and any human engineer reads the 5-digit coordinate map in 5 minutes.| Performance Metric | Without Utyansky Index (Chaos) | With Utyansky Index (Determinism) | Business Savings |
|---|---|---|---|
| Time to implement surgical tweak | 30–60 minutes (with debugging) | 2–3 minutes | 10x–20x Acceleration |
| AI / LLM API Token Invoices | 100% (up to $1,500/mo) | 15–20% (up to $200/mo) | 80–85% Token Cost Reduction |
| Accidental UI / Code Regressions | 35–50% of edits break adjacent features | 0% Regressions | 100% Production Stability |
| New Developer / AI Onboarding | 3–5 working days | 15 minutes (reading registry) | Saves up to 40 Senior dev hours |
| Codebase Lifetime & Scalability | 2–3 months (until complete rewrite) | Unlimited (Modular Framework) | Preserves Software Capital |
To rigorously evaluate the standard without marketing bias, the complete specification was submitted for independent double-blind audit to nine frontier AI leaders across Russia, the USA, and China.
All 9 independent systems converged on the same engineering consensus:
| Model / Origin | Primary Technical Assessment & Verdict |
|---|---|
| 🇷🇺 GigaChat (Sber / Russia) | «Not an algorithmic gimmick, but a solid industrial protocol... Restricting model focus to a 40-line slot physically eliminates hallucinations and mathematically grounds up to 85% token cost savings. data-idx provides unbreakable selectors for Playwright/Cypress.» |
| 🇷🇺 Alice (Yandex / Russia) | «Baseline national standard for protecting code during vibecoding. Forms the reliability triad: TypeScript (types) + ESLint (style) + Utyansky Index (AI scope boundaries). Pre-commit validation at 0.006s provides zero-drift guarantee.» |
| 🌐 Claude (Anthropic / USA) | «In large production apps with 15 identical buttons, semantic RAG search frequently confuses targets. Direct coordinate addressing solves this like an automated fulfillment warehouse. It is sound engineering practice that realistically saves colossal developer-hours at scale.» |
| 🇺🇸 ChatGPT (OpenAI / USA) | «RAG answers: "What should I read?", IDX answers: "Where am I allowed to work?". This unlocks a powerful architecture: IDX-Constrained RAG, strictly locking the agent within its declared contract boundary.» |
| 🇨🇳 DeepSeek (China) | «Principle of Least Privilege. Radically slashes token entropy. The claimed 80–85% savings is conservative (empirically up to 99.3%). First control, then intelligence. Unconditionally adopt for AI agents!» |
| 🇨🇳 Qwen 2.5 (Alibaba / China) | «The only mathematically provable solution for O(1) context isolation in AI agent systems. Conclusively outperforms LSP, MCP edit_file, and metadata-filtered vector search. BEM for the LLM Era. Audit complete, objections withdrawn!» |
| 🇺🇸 Google Gemini (Google / USA) | «DNS for code: cross-stack addressing from UI to backend. Token economy mathematically proven at 84% via formal context profiling. data-idx stability is absolute and immune to physical line shifts (persistent AST node UUID). Barrier against vibecoding garbage.» |
| 🇺🇸 Perplexity AI (USA) | «Write Authorization Layer for code (Capability-Based Security). Slashes blast radius and mathematically confirms 82.5% token economy. Coined Golden Formula: RAG finds, LSP understands, IDX restricts, TS verifies, CI enforces!» |
| 🇺🇸 Grok (xAI / Musk) | «Orthogonal axis of control (First Principles). The triad separates failure modes: TS catches types, linters catch style, the Index is the write-authorization layer. It is an axis TS and linters do not cover. Cheap 0.006s gate turns prompt discipline into a verifiable invariant.» |
🏛️ The Golden Engineering Formula of Safe AI Coding (G9 Synthesis):
"RAG helps find; LSP helps understand; IDX helps accurately address and restrict; TypeScript & tests help verify; CI enforces the rules."
AI_SYSTEM_PROMPT.md) and guards commits with a 0.006s pre-commit gate and GitHub Actions CI (examples/validate-index.js).IDX-Constrained RAGDuring the stress test, frontier model ChatGPT (OpenAI) conceded technical victory to the standard and coined a foundational new principle: IDX-Constrained RAG (Scope-Bounded Retrieval).
🔥 The Core Axiom of the Paradigm:
«RAG answers: "What should I read?"
IDX answers: "Where am I allowed to work?"»
[IDX: 71080]), forcing RAG to retrieve context strictly inside this authorized perimeter, delivering 0% unintended edits and up to 85–99% token cost reduction.👉 Read the Official Global AI Peer Review Report (docs/en/LLM_INDEPENDENT_AUDIT_EN.md) ➔
🔬 Verify Yourself: Protocol for Skeptics (Blind Test) ➔
| Tool | Defense Layer | What It Verifies |
|---|---|---|
| TypeScript | Type Safety | Type compatibility, interface signatures, null-safety |
| ESLint | Code Style & Patterns | Linting rules, anti-patterns, hygiene and best practices |
| Utyansky Index | AI Scope Boundaries | Coordinate slot isolation, collision defense, physical slot registry |
Separation of Concerns Principle:
TypeScript and ESLint verify code quality. The Utyansky Index governs authorized modification boundaries for AI agents. Their responsibilities do not overlap: TypeScript cannot prevent an LLM from wiping an adjacent component, and ESLint cannot detect when an agent mutates an unregistered slot. Each layer mitigates distinct systemic risks.
| Parameter | Stochastic RAG | IDX-Constrained (Utyansky Index) |
|---|---|---|
| Context Ingestion | Top-K by cosine similarity (pulls up to 30 files with similar tokens) | Single target file via exact coordinate $O(1)$ |
| Editing Boundaries | Undefined — model rewrites entire file | data-idx establishes an unbreachable slot boundary |
| Code Overwrite Defense | None (// rest of code unchanged) | Exact coordinate isolates specific sub-block |
| Multi-Agent Collisions | Undetected (race conditions) | Pre-commit and CI block duplicate slot collisions |
| Infrastructure Overhead | Vector DB, embeddings, chunking, Top-K calibration | Single lightweight JSON registry + 0.006s validator |
The Synergy Formula: RAG answers «What is relevant?». Coordinate addressing answers «What is permitted to touch?». They are complementary layers that multiply developer velocity.
UTYANSKY_INDEX_REGISTRY.json in repo root with domain ranges (CORE 10000, ANALYTICS 20000, UI 70000, DATA 90000).data-idx on key components — start with high-traffic AI editing touchpoints (buttons, forms, cards).validate-index.js to pre-commit hook (Husky / Git hook) for bidirectional cross-checking: registry ↔ source code ↔ disk..github/workflows/validate-index.yml) — automated cloud verification in 0.006s.data-idx. Never rewrite whole files — output only modified lines»."status": "LOCKED" in the registry — readable by LLMs, but mutation forbidden.📌 10-Point Technical Summary on AIO:
- AI Blindness in Traditional Code: Standard HTML with thousands of nested
<div>and utility CSS classes (Tailwind) encodes visual layout, but contains zero semantic clues for LLMs.- Multi-Component Ambiguity: When 15 identical buttons ("Order", "Submit", "Learn More") coexist on a single page, AI confuses context and breaks adjacent code.
- Indelible Coordinate Passport: Each functional node receives a strict 5-digit coordinate
data-idx="7XXXX"(range70000–79999) and bilingual semantic roledata-desc="...".- Surgical $O(1)$ Slot Isolation: AI assistants (Cursor, Claude Code, Windsurf) edit strictly the targeted 40-line container without touching the surrounding 1,000 lines.
- 0% Code Overwrites & Regressions: LLMs are physically prevented from leaving
// rest of code unchangedplaceholders that break pages into blank crash screens.- Clarity for Next-Gen AI Search: ChatGPT Search, Perplexity, and Google Gemini accurately extract prices, CTAs, and offers without hallucinations.
- End-to-End Traceability to CRM: One coordinate links a browser button, analytics goal, backend API handler, and amoCRM deal pipeline.
- Unbreakable E2E Test Locators: Playwright and Cypress selectors (
page.locator('[data-idx="74010"]')) never break upon visual redesigns.- Interactive DOM Inspector: The lightweight client script
src/utyansky-web-inspector.jsenables instant coordinate X-Ray ("AI Vision") on any site via a single script tag.- Ready-to-Use Reference Template: A complete, interactive production landing page layout is published at
examples/website-coordinate-markup.html.
<!-- Example of coordinate markup on a primary conversion button -->
<div
data-idx="74010"
data-desc="[BUTTON] Primary commercial checkout button triggering CRM pipeline"
class="relative flex items-center justify-between p-4 bg-slate-800 rounded-2xl">
<span>Order Now</span>
</div>
👉 📖 READ FULL WEB SITE INDEXING GUIDE (EN) ➔
👉 🇷🇺 Читать на Русском ➔ | 💻 Live HTML Demo ➔ | 🛠️ utyansky-web-inspector.js ➔
CURSOR_RULES_INTEGRATION.md / AI_SYSTEM_PROMPT.md (or in Russian / docs/ru/CURSOR_RULES_INTEGRATION.md) — ready system prompt and .cursorrules blueprint for your AI assistant.examples/UTYANSKY_INDEX_REGISTRY.json — coordinate registry file for storing project slots.examples/validate-index.js — CLI validator script checking index uniqueness in 0.1s..cursorrules file in your project root and paste the contents of CURSOR_RULES_INTEGRATION.md (or AI_SYSTEM_PROMPT.md).AGENTS.md file (or paste into your custom system instructions).https://raw.githubusercontent.com/vlad-utyansky/utyansky-index/main/AI_SYSTEM_PROMPT.md[IDX: 71080] [BTN] Launch Analysis Button, [IDX: 72100] [FORM] Admin Panel Form.[ERR: 40101] Invalid Index Format, [ERR: 40102] Coordinate Collision, [ERR: 50010] LLM Deviation.| Range | Standard Class | Domain Purpose | Coordinate Examples |
|---|---|---|---|
00000 – 00099 | 00. Ring-0 Master Locks | Invariants, mutation locks, quarantine TTL, immutable layout | 70050-00000 (Master Lock), 70050-00001 (TTL) |
10000 – 19999 | 01. System Core | System architecture, initialization, routing, global configs | 10010 (Router), 10050 (Init Engine) |
20000 – 29999 | 02. Search & Analytics | Scrapers, search engines, web crawlers, trend radars | 20100 (Parser), 20150 (Radar) |
30000 – 39999 | 03. Media Production | Script synthesis, AI voiceover, video montage, storyboards | 30010 (Brief), 30100 (Timeline) |
40000 – 49999 | 04. SMM Engine | Content calendars, auto-publishing, social distribution | 40050 (Telegram), 40100 (SMM Grid) |
50000 – 59999 | 05. External Integrations | amoCRM, WhatsApp, Telegram Bot API, telephony | 50010 (CRM Webhook), 50020 (MAX Messenger) |
60000 – 69999 | 06. Analytics & Reports | Business KPI dashboards, PDF/Excel export, data scoring | 60010 (Dashboard), 60100 (PDF Export) |
70000 – 79999 | 07. Visual UI / DOM | Buttons, cards, modals, interactive React DOM forms | 71080 (Action Btn), 71200 (Modal Window) |
80000 – 89999 | 08. Marketing & ROI (UVWI) | Viral resonance metric (UVWI), token billing, limits | 85010 (UVWI Calc), 88010 (Billing Bus) |
90000 – 99999 | 09. Archives & Memory | Vector database (pgvector HNSW), memory dumps, audit | 98000 (Vector Search), 99010 (Audit Log) |
The standard translates subjective "likes and vanity views" into exact mathematical ROI predictions:
$\text{UVWI [85010]} = \frac{\text{Verified Positive WOW Responses [21303]}}{\text{Total Audience Reach [92020]}} \times 100%$
-00000 – -00099):When a 5-digit sub-index with leading zeros (-00000 through -00099) is appended to a base coordinate, it serves as a mandatory architectural constraint trigger for AI agents, compilers, and developers.
🛑 The Zero-Lock Directive: Before touching, moving, or refactoring any node with a
-00XXXsuffix, the system MUST inspect the semantic instructions indata-descor the project Change Contract to determine the exact restriction level, reason, and conditional unlock criteria.
| Suffix | Security Class | Architectural Constraint & Release Conditions |
|---|---|---|
XXXXX-00000 | 🔒 Master Invariant (Absolute Lock) | Total ban on mutations, deletions, or repositioning. Node is sacred. Changes allowed strictly with direct, step-by-step developer authorization. |
XXXXX-00001 | ⏳ Temporal / TTL Lock (Time Quarantine) | Restricted by date, countdown, or TTL period (e.g. "14-day quarantine", "Do not touch before Release 25.09.2026"). Automatically unlocked upon expiration. |
XXXXX-00002 | 🌐 External Dependency Lock | Blocked until verified external event occurs (API version transition, App Store approval, partner contractual sign-off). |
XXXXX-00003 | 👨💻 Developer Review Lock | Mutations permitted only after mandatory pre-flight review with the lead architect. |
XXXXX-00004 | 📐 Layout & Position Lock | Node position and hierarchy are immutable; localized styling/copy cosmetic edits are permitted. |
XXXXX-00005 | ✍️ Copywriting & Meaning Lock | Brand voice, offers, and text are protected; technical layout refinements are permitted. |
XXXXX-00006 – -00099 | 📦 Reserved Safe Slots | Open expansion range for team-specific governance and dynamic business constraints. |
UTYANSKY_INDEX_REGISTRY.json){
"project": "MyAwesomeProject",
"standard": "Utyansky Index v2.0",
"registry": {
"10010": { "domain": "CORE", "type": "ROUTER", "desc": "Main Router", "file": "src/App.jsx" },
"71080": { "domain": "UI_DOM", "type": "BTN", "desc": "Launch Analysis Button", "file": "src/components/ActionButton.jsx" },
"85010": { "domain": "METRICS_ROI", "type": "CALC", "desc": "UVWI Calculator", "file": "src/utils/uvwi.js" }
}
}
Knowledge graphs show WHAT is connected, but are blind inside 1000-line files. The Utyansky Index is the 'apartment number on the door': it assigns rigid 5-digit coordinates 10000–99999 and protects surrounding code from accidental AI overwrites during localized slot edits.
| Factor | ❌ BEFORE Index (Stochastic Chaos) | ✅ AFTER Utyansky Index (Determinism) |
|---|---|---|
| Code Breakage | AI modifies 1 button and breaks surrounding layout or styles. | 0% Regressions. All modifications are isolated inside data-idx. |
| Token Consumption | The entire 1500-line file is loaded into context, burning budget. | 80–85% Token Savings. Only the target 40-line slot is fed to the LLM. |
| Prompt Simplicity | Lengthy descriptions: «find the blue button in bottom right...» | 1 Concise Line: «In slot [71080] change button color». |
AI reads coordinates directly from UTYANSKY_INDEX_REGISTRY.json or in-place data-idx DOM tags. Coordinates are deterministic integers that never shift randomly.
AST sees class hierarchies but is blind in visual UI where 15 identical <button> elements exist. data-idx="71080" creates a physical coordinate passport linking UI directly to CRM webhooks and backend logs.
Line hashes break upon any whitespace change. MCP is a tool calling transport protocol. The Utyansky Index is a system-wide deterministic coordinate address bus across the full software lifecycle.
In tiny 50-line files LLMs are reliable. But in 1000+ line production files, models truncate code as // rest of code unchanged. The Utyansky Index coordinate cage physically eliminates this flaw.
Yes. The Utyansky Index was designed as a cross-stack highway connecting React DOM, Python workers, 1C, amoCRM, PostgreSQL pgvector, and CAD metadata.
Uppercase filenames receive highest priority indexing across major AI IDE parsers (Cursor, Windsurf, Claude Code, Antigravity).
Zero rewrite needed: paste AI_SYSTEM_PROMPT.md into .cursorrules / AGENTS.md, tag active components with data-idx="7XXXX", and validate uniqueness via node examples/validate-index.js.
The built-in CLI validator validate-index.js integrates into your pre-commit pipeline (Husky/Git hooks) to halt commits with [ERR: 40102] Coordinate collision in 0.1s.
data-idx="71080" and data-desc="..." are official W3C HTML5 standard dataset attributes. They are 100% native in TypeScript JSX and never conflict with Tailwind utility classes.
Impact is exactly 0.00%. 5-digit dataset attributes add less than 0.04% to raw HTML, compressing to virtually zero under Gzip/Brotli.
One single event listener document.addEventListener("click", e => ...) captures target.dataset.idx and triggers analytics goals seamlessly.
Yes. Multi-agent workers are locked inside bounded numerical ranges (e.g. Support in 20000–29999), instantly aborting cross-domain injection attempts with [ERR: 40301].
The Utyansky Index is the world most resilient E2E selector: page.locator("[data-idx=71080]").click(). Tests never break during redesigns or CSS renaming.
Yes. Microservices pass coordinates via standard tracing headers X-Utyansky-Coordinate: 20150 or annotations, enabling end-to-end tracing from browser to SQL database.
Wrap legacy boundaries in coordinate slots [IDX: 95000-LEGACY-AUTH]. AI agents respect legacy borders without breaking dependencies.
Only functional nodes, buttons, forms, cards, and domain containers are indexed. Decorative styling wrappers remain clean and untouched.
MCP is the tool calling transport protocol, while Utyansky Index is the master coordinate map providing deterministic addressing for MCP tool servers.
The «Utyansky Index» standard is distributed under a transparent hybrid Open-Core model:
| Edition / Tier | Pricing | Target Audience | What is Included |
|---|---|---|---|
| 🆓 Community Edition | 100% Free (MIT) | Vibe coders, indie hackers, open-source projects, students | • Open 5-digit coordinate grid (10000–99999)• React DOM markup ( data-idx="7XXXX")• Ready rule templates for Cursor AI, Claude Code, Windsurf • CLI collision validator script validate-index.js |
| 🛠️ Turnkey Express Setup & Audit | from 120,000 ₽ (one-time) | Startups, digital agencies, businesses with existing vibe-coding MVPs | • Express codebase audit for hidden regressions and hallucinated leaks • End-to-end 5-digit DOM and backend indexing • Generation of UTYANSKY_INDEX_REGISTRY.json master map• Git Pre-commit hook & CI/CD pipeline integration • Team training and customized AI prompt rules |
| 💼 Monthly Retainer (Small Business) | 5,000 – 10,000 ₽ / mo | Niche SaaS, local services, e-commerce stores | • Monthly coordinate registry updates for new features • Context cleanliness audit and commit verification • Priority AI agent integration consultations |
| 🏢 Monthly Retainer (Mid-Market) | 25,000 – 45,000 ₽ / mo | Product IT companies, CRM/ERP ecosystems, high-volume e-commerce | • Multi-agent system architecture supervision • LLM token cost optimization and invoice monitoring • Vector memory isolation setup ( pgvector)• VAU EFFECT Engineering Group supervision & architecture board under the author guidance |
| 🏛️ Enterprise & Corporations | 90,000 – 150,000 ₽ / mo | Banks, fintech, closed corporate holdings, enterprise brands | • Personal architecture supervision by Vladislav Utyansky + priority SLA of VAU EFFECT Engineering Center • Proprietary API access for viral resonance calculation (UVWI [IDX: 85010])• High-scale vector sharding for 1B+ records • Official AI Precision Brand-Certificate |
data-idx="7XXXX"), semantic styling isolation & BEM structuring.allowed_idx, read_context_idx, protected_idx).utyansky_ast_engine.js.[ERR: 10451].ImportDeclaration.70000–79999) for AI Search optimization (AIO: ChatGPT Search, Perplexity, Yandex Neuro).utyansky-web-inspector.js / "AI Vision").callback_data (zero BUTTON_DATA_INVALID).-00000 … -00099): Master Invariants, TTL quarantine, external triggers, and developer review workflows.00 – 09).ProtectedSurface) via CODEOWNERS and GitHub Rulesets.173 commits
HTML
94.0%
JavaScript
6.0%