icassp2027-experiment/docs/README.md

# Documentation index

Documents are grouped by authority rather than by date. “Planned” never means
implemented or validated.

## Active paper definition

| Document | Role |
|---|---|
| [progressive_feature_fusion_route_2026-09-02.md](progressive_feature_fusion_route_2026-09-02.md) | Gated route from pooled local evidence to Frame-set Attention, temporal person memory and Thinker adapters |
| [`omni_speaker_floor_experiment_plan_2026-08-30.md`](omni_speaker_floor_experiment_plan_2026-08-30.md) | Current hypotheses, experiment gates, main table and stopping rules |
| [`multiparty_egocentric_floor_gap_audit_2026-08-30.md`](multiparty_egocentric_floor_gap_audit_2026-08-30.md) | Novelty boundary, closest work and restricted claims |

These documents supersede earlier documents when discussing the paper's main
question. They do not supersede verified implementation details in code and
tests.

## Current implementation runbooks

| Document | Use when |
|---|---|
| [`local_feature_baseline.md`](local_feature_baseline.md) | Extracting/validating EasyCom pooled local Qwen visual and audio sidecars |
| [`easycom_encoder_only.md`](easycom_encoder_only.md) | Comparing EasyCom Qwen encoder-only A/V/AV representations |
| [`ego4d_encoder_only.md`](ego4d_encoder_only.md) | Preparing and running the Ego4D encoder-only comparison |
| [`ego4d_local_baselines.md`](ego4d_local_baselines.md) | Previewing Ego4D boxes, extracting local features and running 8-GPU jobs |
| [`easycom_track_gru_residual.md`](easycom_track_gru_residual.md) | Matched pooled-to-track GRU experiment, causal identity contract and L20 commands |
| [`easycom_oracle_information.md`](easycom_oracle_information.md) | Causal oracle per-person speaking-history upper bound and Session-12 screening commands |

## Design history and implementation options

| Document | Status |
|---|---|
| [`speaker_aware_thinker_plan_2026-08-28.md`](speaker_aware_thinker_plan_2026-08-28.md) | Historical design exploration; useful implementation detail, not current priority order |
| [`trainable_speaker_fusion_survey_2026-08-28.md`](trainable_speaker_fusion_survey_2026-08-28.md) | Detailed person-branch/adapter survey feeding the current plan |

## Where new material belongs

- Current research decisions: a dated file in `docs/`, then link it from this
  index and `PROJECT_CONTEXT.md`.
- Dataset or command runbook: `docs/<dataset>_<task>.md`.
- Measured experiment: `results/<dataset>_<question>_<date>/` with its own
  README and machine-readable summary.
- Paper summary: `literature_notes/NN_short_name.md` and update its index.
- Generated audit report: `reports/`; do not present it as a hand-written
  source of truth.