write-tests

name	write-tests
description	Create or update focused unit, integration, or SAM sandbox e2e tests for implemented stories.
triggers	["write tests","e2e","SAM sandbox"]

Write Tests

Use this skill when a story or final feature branch needs test coverage.

Test Planning

Read:

• merged story docs,
• acceptance criteria,
• traceability,
• current diff,
• existing test conventions.

Choose the smallest test layer that proves the behavior:

• unit tests for pure resolver or validation logic,
• integration tests for persistence, API, or cross-module behavior,
• SAM sandbox e2e tests for user-visible or deployment behavior.

SAM Sandbox E2E

For final PR e2e work:

1. Identify affected user flows.
2. Reuse existing SAM sandbox harnesses.
3. Add tests that fail on the old behavior and pass on the feature branch.
4. Capture command output and artifacts.
5. Keep test data tenant-safe and deterministic.

Rules

• Do not add broad, slow e2e tests when a focused lower-level test proves the behavior.
• Do not weaken existing tests to pass.
• Do not snapshot unstable values unless normalized.
• Document any test gap that needs human acceptance.

Output

Return:

• tests added or changed,
• commands run,
• evidence path or log excerpt,
• remaining coverage gaps.