Project Skill

# 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.