Skip to content

<!-- Authored per the the-loop:writing skill. -->

Testing plan: publish a work item's spec chain as one Claude artifact ​

Derived from requirements.md and design.md. The results are in evidence/verification.md.

Test matrix ​

#TypeApplies?Scope / what it provesWhere it runs
T1Unit (gate render)yesthe outer loop's checklist carries an unticked claude-artifact row and the "claude harness only" note; a contribution's carries neithercli/tests/test_claude_artifact.py
T2Unit (gate resolve)yesticked + default harness claude → claudeArtifact: true; ticked + chosen harness codex → false and the confirmation names codex; ticked + unknown harness → true; unticked → false and "markdown files only"; never a skip, opt-in or refusal; a contribution's reply carrying the row → falsesame
T3Unit (state)yesclaudeArtifact round-trips; absent, "true", 1 read as falsesame
T4Unit (runtime freeze)yesa selection through Runtime records claudeArtifact in state and in the decision recordsame
T5Unit (prompt)yesthe graph block carries the publish line for an outer-loop item with claude_artifact, and not for a PR, contribution, ad-hoc, review item or falsesame
T6Unit (Slack mirror)yesselection_rows puts claude-artifact in others, not phases; the pin test asserts the constants agreecli/tests/test_selection_control.py
T7Regression (full suite + hooks)yesruff, ruff format, pyright, all CLI tests, markdownlintrepository checks
T8Securityyes (review)authorization unchanged, boolean-only read, no gate answer from an artifact, no CLI publicationevidence/security-review.md
T9Integration (Gherkin)n/ano new ingress or seam; the gate's existing Gherkin integration paths are unchanged and run in T7
T10Manual (publish an artifact)n/apublishing is a Claude Code session tool, outside the CLI; the CLI's contract ends at the prompt line (T5)
T11UI / accessibility / snapshot / migration / performancen/ano UI; the state key is additive and absent reads as false, so no migration; one boolean per selection

Requirement trace ​

RequirementTests
R1.1–R1.4T1, T2
R1.5T6
R2.1–R2.5T2
R3.1, R3.2T3, T4
R3.3T7 (archive suite)
R4.1, R4.2T5
R4.3–R4.5review of the skill text (evidence/self-review.md)

Verification environment ​

This checkout, Python via uv, the repository's own make targets. No service, fixture or credential beyond the test doubles the suite already uses.

Not covered by an automated test ​

Whether a Claude Code session publishes a good page from the prompt line. That is the session's behaviour under the skill, judged on the first work item that ticks the box.

Released under the MIT License.