investigation

Create a dated folder under scratch/ with format {YYYY-MM-DD}-{descriptive-name}. Add a README documenting task context, background, and progress, then include scripts and testing data to run experiments. This scaffold supports design decisions, performance assessment, or MVP validation with organized results and actionable findings.

Include background notes explaining the investigation's context, a task list with specific checks to run, results summary capturing outcomes, and actionable findings that inform subsequent decisions. For multi-step investigations, add separate markdown files for intermediate results and sub-experiment notes.

Yes. The investigation scaffold supports MVP validation, performance evaluation, and prototype ideation. It produces a workspace with supporting scripts and testing data, letting you run empirical checks and document insights to validate assumptions before full implementation.

Structure each experiment step as a separate markdown note file within your dated investigation folder. Document intermediate results and findings in each note, then synthesize conclusions in the main README to track progress across the full investigation.

Use {YYYY-MM-DD}-{descriptive-name} as your folder name under scratch/. This date-prefixed, descriptive naming keeps investigations chronologically sortable and quickly identifiable by purpose, supporting efficient workspace navigation.

Use this scaffold when you need empirical data to inform decisions, evaluate performance, or prototype ideas before committing to implementation. It structures research and experimentation work, reducing uncertainty through documentation and systematic testing.