Skip to content

/neuroflow:experiment

Full experiment preparation — paradigm design, recording setup, and instrument configuration.

/experiment covers everything you need before data collection starts: designing the experiment structure, specifying recording parameters, and configuring hardware integrations.

When to use it

  • You need to design or refine an experimental paradigm
  • You want to generate a PsychoPy script
  • You need to document your recording setup (electrodes, sampling rate, reference)
  • You need to configure LSL streaming, trigger boxes, or multi-device synchronization

Three areas

Claude asks which area you want to work on:

Design the experiment structure and produce a PsychoPy script.

Claude asks: - Paradigm type (oddball, N-back, go/no-go, resting state, custom) - Number of trials / blocks / conditions - Stimuli type (visual, auditory, tactile) - Responses collected - Timing requirements (ISI, SOA, jitter) - Markers needed — which events must be tagged

Output: paradigm-[name].py saved to your paradigm/ folder (or the path detected by /neuroflow), following neuroscience paradigm best practices.

Example: 

You: Oddball paradigm, 80% standard / 20% target tones. 300 trials, 3 blocks.
     ISI 1000ms ± 200ms jitter. Need LSL markers for every stimulus.

Claude: I'll generate a PsychoPy script with:
        - Block structure: 3 × 100 trials
        - Standard tone: 1000 Hz, 50ms, 80 dB
        - Target tone: 1500 Hz, 50ms, 80 dB
        - ISI: uniform jitter 800–1200 ms
        - LSL outlet: sends markers 'S' (standard) and 'T' (target)

        [generates paradigm-oddball.py]

Define recording parameters and produce a setup checklist.

Claude asks: - Modality and hardware (EEG amplifier, eye tracker, etc.) - Number of channels and electrode placement - Sampling rate, reference, and ground - File format and storage location

Output: recording-setup.md saved to .neuroflow/experiment/

Example: 

You: BrainProducts actiCHamp Plus, 64 channels, 10-20 system.
     Sampling: 1000 Hz. Reference: Cz. Ground: AFz. BrainVision format.

Claude: [generates recording-setup.md with full checklist including
         impedance targets, cap placement guide, amplifier settings,
         BrainVision Recorder configuration, and a pre-session checklist]

Configure LSL integration, trigger/marker timing, and hardware connections.

Covers: - LSL outlet/inlet setup - Trigger box wiring and timing verification - Synchronization between multiple streams (EEG + eye tracker, EEG + ECG) - Latency measurement and compensation

Files read and written

Direction Files
Reads .neuroflow/project_config.md, .neuroflow/flow.md, .neuroflow/ideation/flow.md, .neuroflow/experiment/flow.md
Writes .neuroflow/experiment/, .neuroflow/experiment/flow.md, .neuroflow/sessions/YYYY-MM-DD.md, paradigm/ (code output)
  • /ideation — define the research question before designing the paradigm
  • /tool-build — build custom tools or real-time systems for the experiment
  • /tool-validate — validate paradigm timing and marker accuracy before data collection
  • /data — the next step after data collection