project-map

Maps HOT-Step CPP features to route files, services, UI folders, and engine subsystems.

151|22|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/scragnog/HOT-Step-CPP --skill project-map-scragnog
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: project-map
Source: https://github.com/scragnog/HOT-Step-CPP/tree/main/.claude/skills/project-map
Command: npx skills add https://github.com/scragnog/HOT-Step-CPP --skill project-map-scragnog

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve? Navigating a large three-tier codebase (C++/GGML engine, Node/Express server, React UI) is slow and error-prone when you cannot tell which tier owns a feature or bug. This Skill maps every HOT-Step CPP feature to its exact route file, service, UI folder, and engine subsystem, including port topology and the browser-to-engine request path. ## Core Features & Use Cases - Feature-to-file mapping: A route ⇄ service ⇄ UI ⇄ engine table covering generation, stem separation, adapters, mastering, VST chains, and more, with line-number anchors. - Request-path tracing: Documents the full browser β†’ Express β†’ ace-server β†’ audio file flow, including the LM/synth sideband gotcha and job polling model. - Failure triage: A symptom β†’ cause β†’ fix table for crash respawns, silent fork-hook loss after upstream syncs, stalled generations, and build pitfalls. - Use Case: A bug report says solver settings are ignored. The Skill tells you this is the silent pipeline-synth-ops.cpp hook loss after an upstream sync, and to run engine\verify-hooks.ps1. ## Quick Start Ask the AI where a specific HOT-Step feature or bug lives and which tier owns it, for example: where is the code for stem separation and how does a generation request flow from the browser to the engine?

Frequently Asked Questions about project-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which file handles a feature in HOT-Step CPP?β–Ό

Use the feature-to-files map: API mounts are registered in server/src/index.ts:72-95, route files live in server/src/routes/, services in server/src/services/, and UI folders in ui/src/components/. The map links each studio feature to its route, service, UI folder, and engine subsystem.

How do I rebuild the C++ engine after editing engine source files?β–Ό

Run .\dev-rebuild.bat at the repo root, never engine\build.cmd directly. The script POSTs /api/shutdown, waits for the process, then builds, avoiding the respawn and file-lock loop caused by the Node server auto-restarting ace-server.exe.

Why do solver and scheduler settings silently stop working after an upstream sync?β–Ό

An upstream sync can overwrite the hot-step-sampler.h include in engine/src/pipeline-synth-ops.cpp:9, which compiles fine but disables all solver, scheduler, and guidance routing. Run powershell -File engine\verify-hooks.ps1 and restore the include.

Why do adapter or synth parameters disappear after the LM phase?β–Ό

Server-only AceRequest fields (the sideband) do not survive the /lm round trip through the engine. Synth requests must be rebuilt from the original aceReq plus only the LM-generated fields, as done in generate.ts:312-328.

Does the engine health endpoint respond during generation?β–Ό

No, and that is expected. The engine is single-threaded httplib and cannot answer HTTP during DiT/VAE compute, so aceClient uses generous timeouts of 15 s quick, 30 s poll, and 300 s result fetch. A hung health check mid-generation is not a bug.

Which Node.js versions are supported for the HOT-Step server?β–Ό

Node 18 through 22 LTS only. Node 24 and later break dependencies, and the package engines field enforces versions below 24.