菜单
Use when working on the Codex Lore Layer of silken_net (app/**/codex/**, codex_* tables) — the gamified read-only narrative layer over telemetry (Realms/Nodes/Citations, Battle Arena Elo, Discovery, Fractions). Routes to the canon docs and the load-bearing ADR invariants.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when working on the silken_net frontend — the Phlex component tree (app/views/components/ + shared/ui|iot|web3/), the Tailwind v4 @theme design-token system (gaia-* surfaces/text, status-*, token-* blockchain, gaia-input-*), the ApplicationComponent base (the tokens() TailwindMerge wrapper + class-autoscoped t() i18n + Turbo-broadcast-safe delegated helpers), the 8 Stimulus controllers, and Turbo Streams/Frames. Knows the non-obvious gotchas — NO tailwind.config.js (SSOT = app/assets/tailwind/application.css @theme), raw Tailwind forbidden in shared components (use status-*/gaia-* tokens), register a new font-size in CUSTOM_TEXT_SCALE for TailwindMerge, NO DB queries in a Phlex initialize, t('.key') autoscopes by class name, specs default to English, Turbo broadcast_* runs in model context (no current_user). Routes to 04_04 (the design-system SSOT) + CLAUDE.md §6, does not restate. Examples: 'add a Phlex component', 'add a design token', 'why isn't my color class merging', 'add a Stimulus controller', 'i1
Use when working on the silken_net telemetry / Proof-of-Growth pipeline — the uplink→verification→minting flow (CoAP intake → UnpackTelemetryWorker / TelemetryUnpackerService → IoTeX verify → Chainlink oracle → mint), the Sidekiq strict-priority queues, TelemetryLog (RANGE-partitioned, KENOSIS — validations live in valid_sensor_data?, not the model), and the dual-computation integrity (server Float Lorenz ≡ firmware mruby). Knows the gotchas — DID=0 in a batch is DEAD (ARCH.54: Queen pulse rides the signed QATT-v2 header → enqueue_envelope_health, both eras drop DID=0), oracle_status_*? enum methods, strict queue drain (uplink fully before alerts), find_with_partition_pruning. Routes to CLAUDE.md §5/§6 + the 05_02 canon, does not restate. Examples: "add a telemetry field", "change minting logic / guards", "why is an alert delayed", "decode the uplink packet", "why does server Z differ from device Z".
Use when working on the silken_net Web3 / on-chain surface — the 12-chain Proof-of-Growth pipeline (app/services/ + workers): SCC/SFC Solidity contracts, batchMint + Binary-Search poisoned-record isolation, the BlockchainTransaction AASM (incl. manual_review double-spend guard), minting guard-clauses (IoTeX / Chainlink / Hadron KYC), Dynamic Tax, slashing / penalty-factor de-correlation, Solana micro-rewards (Ed25519, batch payouts), DAO / Governor / Timelock, WEB3_STRICT_MODE. Routes to CLAUDE.md §1 (12-chain overview) + §6 (web3 gotchas) + the 05_01..05_06 canon (solc One-Home = 05_03), does not restate. Examples: "add a chain integration", "change the minting threshold", "why is a tx stuck in manual_review", "batchMint reverts on dry-run", "edit the slashing penalty", "Solana reward formula / batch payout".
Use when working on the silken_net Rails 'Web2 core' — data models (app/models/ + concerns), the REST API v1 controllers (app/controllers/api/v1/), auth/RBAC (Bearer + salt-bound session cookie, M2M Ed25519, Pundit policies), the non-money services/workers (app/services/, app/workers/), and the MaintenanceRecord / Evidence-Protocol domain. Knows the non-obvious gotchas — role enum prefix:true (role_admin?, NOT admin?; no 'patrol' role exists), the IDOR sibling-guard for client-supplied FKs (foreign-but-existing → 404, missing → 422), the session[:ps] password-salt stamp, M2M token = full org-admin scope (SEC.16), Idempotency-Key → 400 not 422, the webhook HMAC fail-closed pattern, exact HKDF info-strings per owner type, Gateway#online? = config_sleep_interval_s * 1.2, self.primary_key = 'id' on partitioned models, Auditable = after_update_commit + saved_change (NOT AASM after_all_transitions), the FactoryBot initialize_with reuse for Tree's auto-created wallet/calibration. Routes to the 04_01/04_02/04_03/04_0
Use when working on the SSOT docs (docs/NN_NN_*.md) — editing or creating a canon doc, hunting or fixing SSOT drift, adding a docs linter / CI gate, checking where a fact canonically lives, or publishing canon to the GitHub wiki. Operational playbook for docs:check_refs / docs:toc / tracker:check / wiki:sync; defers the STANDARD itself to 00_02 + 00_06. Examples: "edit 03_05", "is this value consistent across the docs?", "add a drift linter", "publish the docs to the wiki", "where does the Lorenz constant live?"
Use when curating the persistent file-based memory (…/memory/MEMORY.md + per-fact *.md) — structuring/grouping the index, removing cruft or duplication, fixing stale index hooks, trimming a bloated index line, or ensuring open action-items in memory are also tracked in 00_07. The HOW lives in .claude/prompts/memory_housekeeping.md; the memory FORMAT standard lives in the system prompt (don't restate). Iron rule: NO AMNESIA — preserve wins over cleanup. Examples: "почисти память", "поструктуруй memory", "повидаляй дублі в памяті", "memory housekeeping", "чи всі to-do з памяті є в 00_07?"
| name | codex |
| description | Use when working on the Codex Lore Layer of silken_net (app/**/codex/**, codex_* tables) — the gamified read-only narrative layer over telemetry (Realms/Nodes/Citations, Battle Arena Elo, Discovery, Fractions). Routes to the canon docs and the load-bearing ADR invariants. |
Read-only наративний шар над операційною телеметрією (Tree → Cluster → Alert →
Wallet): архетипи (Realms × Nodes), поліморфні Codex::Citation, Battle Arena
(Elo), Discovery, Fractions. Гейміфікація, що ніколи не торкається гарячого
шляху телеметрії дерева.
codex_*SSOT One-Home: цей skill лише маршрутизує; факти живуть у docs/. Не дублюй
сюди значення/сигнатури і не хардкодь file:line — воно дрейфує (стале вже за
комітом). Посилайся на стабільні якорі: канон-§ + імена символів.
| Що треба | Канон-дім |
|---|---|
| Чому так — філософія + 10 ADR (CDX-1…10) | docs/04_05_Codex_Lore_Module.md ← read-first |
| Моделі / таблиці / enum / партиціювання | 04_01 §7b |
| Сервіси / воркери / призначення черг | 04_02 §10b (+ DOC-R.10/DOC-R.11) |
REST /api/v1/codex/* | 04_03 §4 |
| Phlex-компоненти / токени / Turbo-ActionCable | 04_04 §6.4, §8.1 |
| Seed-корпус (4 Realm + Node) | db/seeds/codex/ (realms.yml · discovery_rules.yml · nodes/) |
04_05 §2)Будь-хто, хто чіпає codex_*, МУСИТЬ це знати:
uplink/alerts/critical/downlink/web3_critical; лише default/low. Гейміфікація не голодує телеметрію.Codex::MarkdownRenderer allow-list; сирий HTML ніколи в DOM.citable_type лише через CITABLE_CLASS_MAP — без constantize з params (object-injection guard).codex--reveal, codex--comment); решта — нативний data-turbo-confirm. ⚠️ Broadcast-half живості (attunement-counter · live-comments · citation-pills · discovery-toast) наразі DEAD-on-arrival — шлють сирий ActionCable.server.broadcast без жодного consumer'а (нема @rails/actioncable-pin / app/channels/ / subscriptions.create у репо). Робочий патерн живості = turbo_stream_from + Turbo::StreamsChannel.broadcast_*_to (як telemetry/burn/wallet), НЕ raw broadcast. Wire-vs-descope = відкрите ⚖️ → 00_07 UI.2.Codex::Citation.bulk_for(targets).codex_matches (RANGE/місяць, write-heavy); codex_nodes ~10K → без партицій.codex_uid (ADR-CDX-1): CDX-XXX-#### — людино-читабельний, НЕ PK.*_uk / *_en нативні колонки.on(:success) Batch і мерджиться незалежно від Pro-hardening (04_02 DOC-R.10). Перша фіча, що це зламає — multi-step Battle settlement.| Шар | Шлях |
|---|---|
| Namespace + моделі | app/models/codex.rb · app/models/codex/ (Realm, Node, Citation, Comment, Attunement, Fraction, Match, Discovery, DiscoveryRule) |
| Контролери | app/controllers/api/v1/codex/ (+ admin/) |
| Сервіси | app/services/codex/ (DiscoveryEngine, EloMath, PairSelector, VoteRecorder, FractionChange, PresenceTracker, MarkdownRenderer, NodeImport, DiscoveryRuleImport) |
| Воркери | app/workers/codex/ (AttunementBroadcast, DiscoveryProbe, EloRecompute, FractionAudit) |
| Phlex | app/views/components/codex/ |
| Policies (Pundit) | app/policies/codex/ |
| Blueprints | app/blueprints/codex/ |
| Stimulus | app/javascript/controllers/codex/ (reveal, comment) |
| Seeds / rake | db/seeds/codex/ · lib/tasks/codex.rake |
04_05 (саме чому) перед зміною схеми чи призначення черги — ADR несучі.04_01–04_04), НЕ 04_05. 04_05 тримає лише філософію + ADR; нова несуча зміна → новий ADR-CDX-N там, не прозовий патч у тілі.file:line.04_06 + відповідний 04_0x-дім.ssot-maintenance (гейти docs:check_refs + tracker:check).