vouchington-tooling 0.1.8 → 0.2.0

package/skills/playwright-authoring/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: playwright-authoring
+description: Author reliable Playwright browser tests, fixtures, selectors, and user flows.
+---
+
+# Playwright authoring
+
+Use stable, accessible locators and assert user-observable outcomes. Establish data, authentication,
+and server state through supported fixtures or APIs; do not rely on test ordering or arbitrary waits.
+Keep each scenario independently repeatable, use auto-waiting assertions, and capture diagnostics on
+failure. Prefer browser coverage for real browser interactions rather than duplicating unit tests.
+
+Consumer wrappers own environments, credentials, personas, fixtures, and suite commands.
+
+Read [browser reliability](references/browser-reliability.md) for locator, waiting, state, and network rules.

package/skills/playwright-authoring/references/browser-reliability.md

@@ -0,0 +1,9 @@
+# Browser reliability
+
+Use the browser only for browser-owned behavior. Prefer stable accessibility or test-id locators,
+scope repeated content, and assert visible outcomes. Never use arbitrary sleeps; wait for a precise
+URL, request, response, DOM state, or user-visible completion signal.
+
+Seed deterministic data and establish authentication through supported fixtures. Mock network only
+for third-party behavior, fault injection, streaming, or conditions impossible to seed. Register
+response waits before triggering mutations, and make each scenario independent of prior state.

package/skills/postgres-node-performance-tuning/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: postgres-node-performance-tuning
+description: Diagnose and improve PostgreSQL performance in Node.js applications with large data volumes.
+---
+
+# PostgreSQL and Node.js performance
+
+Measure query plans and workload shape before changing code. Select only required columns, bound
+result sets, paginate or stream large reads, batch writes within explicit transaction limits, and
+keep connection-pool usage bounded. Validate query changes with representative cardinality and
+watch latency, memory, lock time, and connection pressure together.
+
+Consumer wrappers own schema ownership, operational thresholds, pooling configuration, and rollout.
+
+Read [performance patterns](references/performance-patterns.md) before changing high-volume paths.

package/skills/postgres-node-performance-tuning/references/performance-patterns.md

@@ -0,0 +1,14 @@
+# Performance patterns
+
+Use pools and release checked-out clients in `finally`, especially for cursors, streams, and COPY.
+Route ordinary reads to a replica when its lag is acceptable; route read-after-write, locking, and
+transaction-consistent reads to the writer. Do not hold a client across unrelated application work.
+
+For large reads, use keyset pagination, cursors, or streams with cancellation and bounded batches.
+For writes, prefer set-based batches such as UNNEST or COPY when they preserve validation and error
+handling. Measure query plans with representative cardinality before changing an index or query.
+
+Check query predicates, joins, ordering, and selected columns against index shape. Use EXPLAIN
+evidence to confirm planner behavior. Add extended statistics only when observed estimates show a
+correlation problem; verify the statistics are collected and used. Partitioning can reduce scanned
+data, but it does not replace suitable local indexes or predicates that permit pruning.

package/skills/postgres-partitioning-uuid-v7/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: postgres-partitioning-uuid-v7
+description: Design PostgreSQL partitions and indexes that use time-ordered UUIDv7 identifiers efficiently.
+---
+
+# PostgreSQL partitioning with UUIDv7
+
+Partition only after confirming lifecycle, retention, and query predicates benefit from it. Treat a
+UUIDv7 as time ordered but not as a replacement for explicit business timestamps where semantics
+matter. Align partition keys, primary keys, indexes, constraints, and query predicates so partition
+pruning is observable. Plan creation, retention, migration, and verification as one deployable
+lifecycle, including rollback and independent-reader compatibility.
+
+Consumer wrappers own partition intervals, migration tooling, retention policy, and deploy sequencing.
+
+Read [partition lifecycle](references/partition-lifecycle.md) before a schema or retention migration.

package/skills/postgres-partitioning-uuid-v7/references/partition-lifecycle.md

@@ -0,0 +1,14 @@
+# Partition lifecycle
+
+UUIDv7 ordering supports range bounds and index-friendly time windows. Generate bounds from time
+instead of extracting timestamps in predicates; use a generated timestamp only when application
+semantics require one. Partition on the range key that queries and retention actually constrain.
+
+Create future ranges before writes need them and maintain a default partition only with an explicit
+attachment plan. Before attaching a populated range, prove the default partition excludes that range
+or move conflicting rows; otherwise attachment can scan and lock the default partition.
+
+Every primary or unique constraint on a partitioned table must include its partition key. Verify
+pruning with predicates on that key, including joins whose other side needs an equivalent range
+condition. UUIDv7 values are time ordered, not a promise that independently generated identifiers
+have a strict ordering relationship.

package/skills/storybook-authoring/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: storybook-authoring
+description: Add maintainable Storybook stories and browser-mode component coverage.
+---
+
+# Storybook authoring
+
+Create stories that show meaningful supported states with realistic args and fixtures. Keep story
+data local and deterministic, expose important visual or interaction variants, and add browser-mode
+coverage where it catches behavior unavailable to unit tests. Do not use stories as a substitute for
+end-to-end setup or production data handling.
+
+Consumer wrappers own Storybook configuration, exclusions, visual baselines, and commands.
+
+Read [component coverage](references/component-coverage.md) for direct stories and browser isolation.

package/skills/storybook-authoring/references/component-coverage.md

@@ -0,0 +1,9 @@
+# Component coverage
+
+Keep a direct story for each supported reusable component state. When a component needs server-only
+modules, request context, or browser-hostile imports, isolate the presentational surface or alias the
+boundary to a deterministic fixture. Test interactive story behavior in browser mode when it owns
+the component contract.
+
+Allow story discovery to follow the consumer's module graph and glob configuration. Do not hand
+maintain duplicate registration lists or make module-top-level browser assumptions.

package/skills/swift-test-authoring/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: swift-test-authoring
+description: Add Swift and SwiftUI tests with deterministic state, networking, and view inspection.
+---
+
+# Swift test authoring
+
+Test public behavior with deterministic inputs and injected dependencies. For SwiftUI, inspect or
+interact through the project's supported test approach; for networking, use a protocol-level test
+double and keep request/response synchronization explicit. Avoid sleeps and global state, and keep
+fixtures small enough to make failures readable.
+
+Consumer wrappers own test targets, coverage thresholds, view-inspection libraries, and fixture APIs.
+
+Read [network test doubles](references/network-test-doubles.md) for cancellation and shared-state safety.

package/skills/swift-test-authoring/references/network-test-doubles.md

@@ -0,0 +1,9 @@
+# Network test doubles
+
+Delayed URLProtocol callbacks must honor `stopLoading()`: guard delivery with synchronized stopped
+state so cancellation cannot call a released client. Keep shared response and captured-request state
+private behind one synchronization boundary, reset related fields atomically, and expose coherent
+snapshots for assertions.
+
+Avoid sleeping to coordinate tests. Inject scheduling or await explicit completion so networking,
+view state, and cancellation remain deterministic under parallel execution.

package/skills/test-authoring/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: test-authoring
+description: Write focused, maintainable tests and test fixtures for application or library behavior.
+---
+
+# Test authoring
+
+Use the repository's test conventions and runner skill. Test observable behavior, boundary failures,
+and regressions rather than implementation details. Build fixtures through public constructors or
+documented helpers; keep data minimal, explicit, and representative. Add a focused failing test
+before a behavior change when practical, then run the narrowest relevant test and required checks.
+
+Do not invent project test commands, coverage targets, mock libraries, or integration environments.
+A consumer wrapper owns those choices.
+
+Read [core practice](references/core-practice.md) for the shared boundary, completion, and evidence
+rules before choosing a runner-specific approach.

package/skills/test-authoring/references/core-practice.md

@@ -0,0 +1,10 @@
+# Core test practice
+
+Choose the lowest realistic boundary that can observe the contract. Mock external systems and
+uncontrolled infrastructure; exercise internal module composition where practical. Test behavior,
+failure paths, authorization, and security-relevant validation rather than private calls.
+
+Start with a failing test when the behavior is testable. Finish only when the production path, its
+public contract, documentation, and generated artifacts move together. Do not leave placeholders or
+test-only production branches. For every acceptance criterion, retain evidence from a focused test,
+review, or explicitly justified manual check.

package/skills/vitest-test-authoring/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: vitest-test-authoring
+description: Apply Vitest-specific patterns when adding or changing Vitest tests, mocks, or fixtures.
+---
+
+# Vitest test authoring
+
+Apply [test-authoring](../test-authoring/SKILL.md) first. Keep tests isolated with Vitest lifecycle
+hooks, restore spies and globals after each test, and prefer deterministic async assertions over
+timing waits. Mock external boundaries rather than modules under test, and use typed factories when
+the project supplies them. Run the selected file or project before broader validation.
+
+Consumer wrappers own project selection, mock boundaries, fixture names, and coverage policy.
+
+Read [mock boundaries](references/mock-boundaries.md) when adding module mocks or changing exports.

package/skills/vitest-test-authoring/references/mock-boundaries.md

@@ -0,0 +1,9 @@
+# Mock boundaries
+
+Mock providers, transports, clocks, and environment boundaries rather than application modules.
+When a module mock is necessary, preserve its runtime export shape, type the factory against the
+real module, and spread actual exports unless omission is intentional. Update static factories when
+the mocked module gains an export.
+
+Prefer spies or dependency injection for a narrow seam. Restore mocks, environment, and globals
+after each test so a test cannot alter another test's module graph or process state.