This repository stores customer development research in a consistent, reviewable format.
Use this repo for two things:
- Submit a research issue when a problem, opportunity, or hypothesis needs investigation.
- Record the results of interviews, experiments, and conclusions in markdown so the work is easy to find later.
- docs/research-workflow.md: End-to-end process for opening, running, and closing research work.
- docs/submitting-research-issues.md: How to open a research issue using the existing GitHub issue template.
- docs/submitting-research-results.md: How to write up results and where to store them.
- research-results/README.md: Folder conventions for published research results.
- Open a GitHub issue using the Customer Development Template.
- Use the issue to scope the problem, explore options, and capture links to supporting material.
- Run interviews, experiments, or design validation.
- Publish the outcome as a markdown file in
research-results/. - Link the results file back to the issue and close the issue when the work is complete.
- One issue per research question or problem area.
- One results file per completed study, experiment, or decision point.
- Prefer concise writing, concrete evidence, and direct links to source material.
- Keep sensitive customer data out of the repository.