Skip to content

feat(skills): give end-to-end tests a home in the workflow#7

Merged
sourcehawk merged 2 commits into
mainfrom
feat/testing-end-to-end-skill
May 29, 2026
Merged

feat(skills): give end-to-end tests a home in the workflow#7
sourcehawk merged 2 commits into
mainfrom
feat/testing-end-to-end-skill

Conversation

@sourcehawk
Copy link
Copy Markdown
Owner

Problem

End-to-end tests had no home in the workflow. testing-a-feature covers the assertion shape for a single surface, but nothing said when a whole-flow test is warranted, what it should assert, or — critically — what it should not. Left unaddressed, agents over-cover: a baseline run asked to scope e2e for a complete feature produced 8 e2e tests, promoting edge cases into the suite on the rationalization "it's only real when the full stack runs."

Change

A standalone testing-end-to-end skill, plus the wiring to invoke it at the right moment.

  • When — only after structural completion (the seam exists; the structure has stopped moving), and only for a new user/consumer-visible flow.
  • What — the golden path of each new flow, the seams unit tests stub out, consumer-visible flow branches (one per branch, not per permutation).
  • What not — edge cases and single-surface contracts stay a level down; mock only what you don't own, or it's a unit test in disguise.

Wired into both structural-completion points (developing-a-feature Step 5, reviewing-feature-progress Step 6), with a boundary pointer from testing-a-feature and rows in the README and project-CLAUDE tables.

Developed with superpowers:writing-skills (RED → GREEN)

  • RED — baseline (no skill): 8 e2e tests, 4 of them promoted edge cases.
  • GREEN — with the skill: 2 e2e tests (golden path + auth deny-branch), edge cases pushed to unit/route level.

🤖 Generated with Claude Code

sourcehawk and others added 2 commits May 29, 2026 22:50
End-to-end tests had no home in the workflow. This adds a standalone
skill that decides when a whole-flow test is warranted and what it
asserts, distinct from testing-a-feature's per-surface assertion shape.

Core principle: an end-to-end test asserts that a whole flow keeps the
promise the user or consumer was made, exercising the real seams unit
tests stub out. That fixes both timing (write only after structural
completion, when the seam exists) and selection (one test per promised
journey; edge cases stay at the unit level).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Route the choreography to the new skill at the points where the
structure has settled enough for a whole-flow test to be safe: the
single-PR checkpoint (developing-a-feature Step 5) and the multi-PR
integration checkpoint (reviewing-feature-progress Step 6). Add a
boundary pointer in testing-a-feature so edge cases stay at the unit
level, and list the skill in the README and project-CLAUDE tables.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 29, 2026 20:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a dedicated testing-end-to-end skill to the feature-dev-workflow plugin and wires it into the workflow at the “structurally complete” checkpoints, clarifying when end-to-end coverage is warranted and what it should (and should not) assert.

Changes:

  • Added a new testing-end-to-end skill defining selection/timing principles for system-level tests (golden paths and consumer-visible branches, not edge cases).
  • Wired testing-end-to-end into the two structural-completion checkpoints (developing-a-feature Step 5 and reviewing-feature-progress Step 6) and added a pointer from testing-a-feature.
  • Documented the new skill in the README and the project CLAUDE template tables.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
templates/project-CLAUDE.md Adds the new skill to the workflow “which skill owns which part” table.
skills/testing-end-to-end/SKILL.md Introduces the new end-to-end testing guidance skill.
skills/testing-a-feature/SKILL.md Adds a boundary pointer to the new end-to-end skill for whole-flow coverage.
skills/reviewing-feature-progress/SKILL.md Invokes testing-end-to-end at the integrated-branch verification checkpoint.
skills/developing-a-feature/SKILL.md Invokes testing-end-to-end at the single-PR structural completion checkpoint.
README.md Adds testing-end-to-end to the top-level skills list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@sourcehawk sourcehawk merged commit f9fa216 into main May 29, 2026
1 check passed
@sourcehawk sourcehawk deleted the feat/testing-end-to-end-skill branch May 29, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants