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.