Skip to content

Update AGENTS.md to match current codebase#379

Open
rymalia wants to merge 1 commit into
soniqo:mainfrom
rymalia:docs/agents-md-refresh
Open

Update AGENTS.md to match current codebase#379
rymalia wants to merge 1 commit into
soniqo:mainfrom
rymalia:docs/agents-md-refresh

Conversation

@rymalia

@rymalia rymalia commented Jul 5, 2026

Copy link
Copy Markdown

What changed

AGENTS.md had drifted well behind the codebase — it documented ~14 modules
while the package now has 38 source targets. This brings it fully up to date:

  • Project Structure: reorganized the flat module list into capability
    groups (ASR, TTS, Speech-to-Speech & Translation, Audio Processing, Music
    Generation, Avatar, On-Device LLM, Infrastructure) and documented every
    Sources/ target, including the recent WhisperASR, Fish Audio S2 Pro,
    Indic-Mio, Audio2Face-3D, and benchmark additions
  • README translations: corrected the count from 10 to 13 (added
    README_th.md, README_tr.md, README_vi.md) in both places it appears
  • Testing: fixed the copy-paste bug where both the "safe" and "full"
    suites showed make testmake test is unit-only (what CI runs), the
    full E2E suite is swift test --disable-sandbox; added the single-test
    invocation
  • Binaries: documented speech-server (Hummingbird HTTP + WebSocket),
    asr-bench, vad-bench, and diarization-bench
  • Key Conventions: noted that CSpeechCore is a pre-built XCFramework
    from soniqo/speech-core and cannot be modified in this repo

CLAUDE.md and CODEX.md pick up all changes via symlink.

Regression risk

None at runtime — documentation only, single file. The recently merged
AGENTS.md additions (Communication Style, docs-scoping rule, skills symlink
note, /review-pr entry) are all preserved.

Tests

Not applicable (docs-only change). Verified every directory under Sources/
now appears in the Project Structure list, and cross-checked binary names
against Package.swift.

- Correct README translation count from 10 to 13 (add th, tr, vi)
- Reorganize Project Structure into capability groups and document
  all previously missing modules, including WhisperASR, Fish Audio
  S2 Pro, Indic-Mio, Audio2Face-3D, and the benchmark targets
- Fix Testing section: make test is unit-only; full E2E suite is
  swift test --disable-sandbox; add single-test invocation
- Document the speech-server, asr-bench, vad-bench, and
  diarization-bench binaries
- Note CSpeechCore is a pre-built XCFramework from soniqo/speech-core

CLAUDE.md and CODEX.md pick up the changes via symlink.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant