Memory 019e7f24

Memory ID (Session ID): 019e7f24-014d-7000-bd20-3b7dc2de1389
Last Updated: 2026-05-31 21:02:27

Fact Summary

Workspace Structure at /home/dev

  • Multi-project workspace, NOT a single repo. Contains: AudioFlux, GOMA/GIMA, Langflow, MixBox, GroqGradio, OpenAI Chat Lab, and others.
  • Key subdirectories include /home/dev/audio/AudioFlux/, /home/dev/packages/ (MixBox packages), /home/dev/docs/.
  • An existing AGENTS.md existed but was MixBox-only — user explicitly complained about this narrow focus.

MixBox Details (subset of workspace)

  • Python 3.11+ monorepo managed via uv workspace (astral-uv).
  • 5 sibling packages under packages/: audio-core, dj-engine (MixBox), analyzer (hitscan), video-gen (hitvid), emotion (valaro).
  • Linter/formatter: Ruff (100-char line limit). Testing: Pytest.
  • audio-core is shared foundation; dj-engine is primary orchestrator.

Port Allocations

Critical Lesson

  • When user says ‘generate AGENTS.md’ for /home/dev, they mean the ENTIRE workspace, not just one sub-project. Must scan ALL top-level directories and projects, not just the most prominent one (MixBox).
  • Launch parallel explore agents covering different areas: core src across ALL projects, tests, configs/build files, scripts/docs.

Generated Artifacts

  • /home/dev/docs/WORKSPACE_CHEAT_SHEET.md — 147-line quick-start reference with port map, absolute path map, command central, dev conventions, testing & telemetry.
  • AGENTS.md needs to be regenerated to cover full workspace scope.

Reference Session