assignment-matrix-test

Validate Linejam assignment matrices for derangement constraints across rounds.

2|Updated Nov 19, 2025
One-click install
npx skills add https://github.com/misty-step/linejam --skill assignment-matrix-test
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: assignment-matrix-test
Source: https://github.com/misty-step/linejam/tree/main/.agents/skills/assignment-matrix-test
Command: npx skills add https://github.com/misty-step/linejam --skill assignment-matrix-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates the Linejam assignment matrix to enforce the derangement constraint across rounds.

Core Features & Use Cases

  • Deterministic property testing across seeds to catch matrix regressions.
  • Invariant coverage: 9 rounds, 9×N shape, row-wise permutation, and per-round derangement.
  • Integration guidance: ties to Convex matrix logic and tests at tests/convex/assignmentMatrix.property.test.ts.

Quick Start

Run the property test to validate derangement across all supported N values.

Frequently Asked Questions about assignment-matrix-test

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I property-test an assignment matrix for derangement constraints?▼

Property-test an assignment matrix for derangement constraints by running deterministic seeded tests that verify every row is a permutation and consecutive rounds never assign the same user to the same item. This Skill validates a 9-round, 9×N matrix across N values from 2 to 8.

What invariants should an assignment matrix enforce across multiple rounds?▼

An assignment matrix should enforce four invariants: exactly 9 rounds, a 9×N shape, row-wise permutation of user IDs, and per-round derangement to prevent consecutive duplicate assignments. Complete column coverage is also verified.

How do I validate derangement in a Convex assignment matrix?▼

Validate derangement in a Convex assignment matrix by integrating tests at tests/convex/assignmentMatrix.property.test.ts and using the generateAssignmentMatrix function from convex/lib/assignmentMatrix.ts to check permutation and derangement constraints.

Does this property test cover all matrix sizes for the 9-round assignment?▼

Yes, the property test covers all supported matrix sizes for the 9-round assignment by iterating N values from 2 through 8, ensuring the 9×N matrix maintains derangement and row-wise permutation invariants across every configuration.

Why does my assignment matrix test fail on consecutive rounds?▼

An assignment matrix test fails on consecutive rounds when the derangement constraint is violated, meaning the same user is assigned to the same poem in back-to-back rounds. Use deterministic seeded property testing to isolate the failing seed and catch the regression.

Can I use deterministic seeded testing to catch assignment matrix regressions?▼

Yes, you can use deterministic seeded testing to catch assignment matrix regressions by running property tests across fixed seeds, which reliably reproduce failures in the derangement or permutation invariants of the 9×N matrix.