Run any Skill in Manus with one click

nucleo-anima-debug

Stars39

Forks2

UpdatedJune 28, 2026 at 21:49

Debug and develop NucleoOS firmware/ANIMA logic on the PC without flashing — the host harness compiles the real C and runs it locally. Use when working on ANIMA (the offline NL assistant), retrieval cascade, NLU, knowledge graph, or any firmware logic, and when deciding how to verify a change. Lists the gate suites to run before claiming a fix.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

indecenti

indecenti/NucleoOs

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	nucleo-anima-debug
description	Debug and develop NucleoOS firmware/ANIMA logic on the PC without flashing — the host harness compiles the real C and runs it locally. Use when working on ANIMA (the offline NL assistant), retrieval cascade, NLU, knowledge graph, or any firmware logic, and when deciding how to verify a change. Lists the gate suites to run before claiming a fix.

Host-first debugging for NucleoOS / ANIMA

Default: do NOT iterate by flashing. The host harness compiles the real ANIMA firmware C (MinGW gcc) and runs it on the PC — no device, no WiFi, no cable. Flash only to confirm. Don't jump to flash→WiFi for logic work; that's the slow path and a user pref.

npm run anima -- "che cos'è nucleoos"   # one-shot query against the real cascade
npm run anima                            # interactive REPL
npm run anima:build                      # force rebuild the host exe
npm run anima:sweep                      # batch over tools/anima-host/queries.txt

Gate suites (run the relevant ones before claiming a fix)

npm run anima:gate — the 12-gate regression suite (0-hallucination, skill-routing, …). This is the pre-flight; it must be green before any flash.
npm run anima:route — dispatch/routing snapshot (catches cascade-order regressions).
npm run anima:reason — math/reasoning layer.
npm run anima:halluc / anima:meta / anima:boundary / anima:realistic — anti-hallucination stress (485-phrase suite + metamorphic harness).
npm run anima:typed / anima:typednl — typed knowledge graph.
npm run anima:local — the browser WASM cascade (policy + contract + capability + parity).
Per-subsystem (non-ANIMA): npm run <ir|link|mesh|eth|hw|skill|radio|logviewer>:test, npm run validate (registry/manifests), npm run i18n:gate.

Live device debug (when host isn't enough)

HTTP debug without flashing: /api/logs (no auth), /api/diag (consolidated). Pair with the 6-digit PIN shown on screen → session cookie → /api/fs. The IP/PIN drift per environment — read them fresh; don't hardcode. delete is NOT recursive. See docs/debugging.md.

Pitfalls

Host dim is 256, device dim is 192 — vector dims differ between host and device.
Don't rebuild the L1 index casually: k-means isn't reproducible and the reshuffle breaks gates (see memory anima-l1-index-rebuild / anima-index-provenance-guard).
L1 query stack: httpd task needs ≥24 KB or it panics.
Online tier is LLM-only by design (cloud Grok/Claude → browser WebLLM, never the offline cascade); the "Grok" teacher is actually configured as Groq (Llama) by default.

More from this repository

same repository

nucleo-release-dual

indecenti/NucleoOs

Build and ship NucleoOS to BOTH Cardputer units — the original and the ADV — in one pass. Use when the user wants to release/build/OTA/flash for both boards, the ADV and non-ADV Cardputers, or two devices at once. Encodes the key fact that it's ONE universal binary (runtime board auto-detect), so you build once and fan out the shipping to each unit, then verify per board.

2026-07-0939

nucleo-release

indecenti/NucleoOs

Build, gate, and ship NucleoOS to the Cardputer — firmware via OTA and the web/SD payload via the device file API. Use when the user asks to release, deploy, flash, OTA, sync the SD, or push a web app to the device. Covers the one-command release, firmware-only and SD-only paths, and the gotchas (PIN, .gz shadowing, never /MIR).

2026-07-0939

nucleo-native-app

indecenti/NucleoOs

Scaffold and implement a NucleoOS native firmware app (C++) correctly — anti-flicker, poll handler, RAM discipline, input routing, registration. Use when creating or fixing a native app in firmware/components/nucleo_app/.

2026-06-2839

nucleo-new-app

indecenti/NucleoOs

Scaffold a new NucleoOS web app correctly — manifest, www assets, registry entry, ANIMA launch aliases, i18n, icon — so it shows up, launches by name, and passes validation. Use when adding a new app to the OS, creating an app folder, or wiring an existing app folder into the registry.

2026-06-2839

nucleo-verify

indecenti/NucleoOs

How to verify a NucleoOS change actually works before claiming done or releasing — the full preflight matrix (registry/manifest validation, i18n, gzip parity, API spec drift, ANIMA gate, app tests) plus running the device simulator for web changes. Use when finishing a change, before a release, or when asked to verify/test that something works.

2026-06-2839

name	nucleo-anima-debug
description	Debug and develop NucleoOS firmware/ANIMA logic on the PC without flashing — the host harness compiles the real C and runs it locally. Use when working on ANIMA (the offline NL assistant), retrieval cascade, NLU, knowledge graph, or any firmware logic, and when deciding how to verify a change. Lists the gate suites to run before claiming a fix.

Host-first debugging for NucleoOS / ANIMA

npm run anima -- "che cos'è nucleoos"   # one-shot query against the real cascade
npm run anima                            # interactive REPL
npm run anima:build                      # force rebuild the host exe
npm run anima:sweep                      # batch over tools/anima-host/queries.txt

Gate suites (run the relevant ones before claiming a fix)

npm run anima:gate — the 12-gate regression suite (0-hallucination, skill-routing, …). This is the pre-flight; it must be green before any flash.
npm run anima:route — dispatch/routing snapshot (catches cascade-order regressions).
npm run anima:reason — math/reasoning layer.
npm run anima:halluc / anima:meta / anima:boundary / anima:realistic — anti-hallucination stress (485-phrase suite + metamorphic harness).
npm run anima:typed / anima:typednl — typed knowledge graph.
npm run anima:local — the browser WASM cascade (policy + contract + capability + parity).
Per-subsystem (non-ANIMA): npm run <ir|link|mesh|eth|hw|skill|radio|logviewer>:test, npm run validate (registry/manifests), npm run i18n:gate.

Live device debug (when host isn't enough)

Pitfalls

Host dim is 256, device dim is 192 — vector dims differ between host and device.
Don't rebuild the L1 index casually: k-means isn't reproducible and the reshuffle breaks gates (see memory anima-l1-index-rebuild / anima-index-provenance-guard).
L1 query stack: httpd task needs ≥24 KB or it panics.
Online tier is LLM-only by design (cloud Grok/Claude → browser WebLLM, never the offline cascade); the "Grok" teacher is actually configured as Groq (Llama) by default.