Skip to content

feat: add unit relationship explanation examples - #347

Open
666haiwen wants to merge 1 commit into
developfrom
codex/creative-unit-explanation-segments
Open

666haiwen wants to merge 1 commit into
developfrom
codex/creative-unit-explanation-segments

Conversation

@666haiwen

Copy link
Copy Markdown
Contributor

Changes

Add four self-contained visual explanation examples so the Skill can illustrate unit relationships beyond grouping and weighting:

  • categorical-change: follow matched respondents across two classifications while preserving identity and independent attribute colors.
  • distribution-and-exception: place an individual record back into independent batches, compare mean and median evidence, then continuously focus on the tail. Repeated values remain separated and comparison readings update with adapted data.
  • shared-members: identify and gather known joint participants while retaining their origins; finish by comparing signup size with joint participation.
  • overlap-bound: explain the minimum possible intersection from a common population and marginal counts, clearly distinguishing a bound from the actual intersection.

Connect the examples to the catalog and design guide, with concise data conditions, tradeoffs and adaptation notes. The examples use the existing shared reading and animation runtime; the overall Skill workflow is unchanged.

Verification

  • node --test tests/creative_data_storytelling/unit_relation_segments.test.mjs tests/creative_data_storytelling/example_catalog.test.mjs — 33 passed.
  • Relevant module syntax checks, preview resource audit, staged whitespace check and repository commit hooks passed.
  • Browser review covered key states at 1440×900 and 1280×720, including continuous transitions, interrupted reversal, mean/median references, final text and layout.
  • An adapted distribution with unequal sample sizes, decreasing mean and median, and repeated tail values was checked in the browser. Regression coverage also includes stable identities, source ties and overlap bounds.
  • Fresh Agent-generated stories using these examples have not been evaluated yet; these checks establish example behavior and readability, not downstream creative quality.
  • Merge compatibility with the current develop was checked without conflicts.

Release plan

  • Publish a Skills release: N/A
  • Planned version: N/A
  • Release highlights and migration notes: N/A; additive examples, no migration required.
  • Reviewed release notes file: N/A
  • Committed plan: .github/release-plan.json unchanged
  • Automatic PR preview: N/A

Add four adaptable explanations for paired category changes, distributions
and exceptions, known shared members, and overlap bounds. Link them from the
design guide and example catalog so agents can select them by data relation.

Keep stable identities, shared scales and the existing reading runtime.
Bind mean and median evidence to the data, preserve repeated-value spacing,
and compare signup size with joint participation in the shared-members ending.

Validation: 33 behavior and catalog checks passed, plus desktop browser
review of key states, reverse transitions and adapted distribution data.

Codex-Model: gpt-6-astra
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant