Analysis Artifacts

When to Use

• When asked to do a "deep dive" or "analysis" on a question with a non-obvious answer
• When the analysis requires exploratory querying in BigQuery
• When the output should be reproducible and shareable (not just a one-off answer)

Workflow

1. Scaffold the analysis directory

At the start of every analysis:

• Create a new directory in the analyses folder, named according to the existing pattern there
• Create subdirectories: /assets/queries and /assets/visualizations
• Create a README.md at the root of the new directory — this is the main readable document for the analysis

2. Plan the analysis