What problem does it solve? Working on the silken_net STM32 firmware involves non-obvious traps — AES key-load ordering, RTC backup register budgets, STOP2-frozen ticks, gated CCM code paths — that silently break crypto, timing, or the wire format. This Skill routes you to the canonical docs and a curated gotcha list before you touch a peripheral init, the RTC map, the crypto path, or the wire format. ## Core Features & Use Cases - SSOT Navigation: Points to the exact canon documents (03_01–03_06, CLAUDE.md §5) and source files (soldier/main.c, queen/main.c, firmware/common headers) that own each fact, so summaries never drift from code. - Gotcha Index: Fourteen numbered, hard-won gotchas (ECB-restore after CBC, Load_AES_Key before MX_CRYP_Init, HAL_GetTick frozen in STOP2, vcap = VDDA not EDLC, post-FW.29 StatusByte layout) with full mechanism details in gotchas.md. - Task Recipes: Step-by-step flows for adding a sensor field, changing Lorenz parameters, modifying AES/CRYP init, and touching RTC-persisted state, including host-test parity discipline (make -C firmware/test). - Use Case: Before editing the seed/cold-start crypto, open the skill to learn that lorenz_seed.h is the single shared home and that the seed_derivation host test re-proves parity against OpenSSL. ## Quick Start Ask the assistant to use the firmware skill before modifying AES initialization in the Soldier or Queen main.c files.
