Polymath Zero

Docs · Getting started

Create a case

A case is a structured problem record. Create one when you have a bug, regression, or investigation — with or without a GitHub issue.

Steps

  1. Click New case. Top-right of the case list.
  2. Name the case. Use a short, specific name. Examples: auth timeout on /api/login, schema drift error lacks field detail. Avoid vague names like fix bug.
  3. Describe the problem. What you observed, what you expected, any reproduction steps. Zero writes this to problem-definition.md.
  4. Set the initial state. New cases open in OPEN. Move to INVESTIGATING to begin your first session.
  5. Attach code context (optional). Link a repository path or paste a file reference. Written to code-context.md.

Naming guidance

Good case names include the component, the symptom, and (optionally) the reproduction path. A case named auth timeout on /api/login is immediately searchable six weeks later.