Project Skill

This repository is for building a speech emotion recognition system from the local AudioWAV/ dataset.

Required First Step For Any Future Agent

• Read context.md before making plans, writing code, or changing files.
• Treat context.md as the current project handoff document.

Working Rules

• Keep the raw dataset in AudioWAV/ untouched.
• Use manifest-driven workflows instead of moving audio files into new folders.
• Preserve speaker-disjoint train/validation/test splits.
• Use the six V1 emotion labels only: angry, disgust, fear, happy, neutral, sad.
• Treat filename intensity as metadata, not as the V1 prediction target, unless the user explicitly changes that decision.
• Prefer reproducible scripts and versioned artifacts over manual steps.

Current Repo Conventions

• Dataset manifests live in manifests/.
• Utility scripts live in scripts/.
• The current manifest generator is scripts/create_audio_manifest.py.

Update Contract

• Any time code, data-processing logic, file structure, training setup, model behavior, or project decisions change, update context.md in the same work session.
• Update skill.md too if the workflow rules, repo conventions, or standing instructions change.
• When updating context.md, refresh:
  • current status
  • key decisions
  • important files
  • recent changes
  • next recommended step

Preferred Agent Behavior

• Before changing anything, inspect the current manifests, scripts, and context.md.
• After changing anything, leave the repo in a state where another agent can continue without re-discovering the project.
• Be explicit about assumptions when the user has not decided something yet.