scope-feature-tests

Plans risk-ordered test scopes for Insight features grounded in code and data flow.

10|9|Updated May 22, 2026
One-click install
npx skills add https://github.com/constructorfabric/insight --skill scope-feature-tests-constructorfabric
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scope-feature-tests
Source: https://github.com/constructorfabric/insight/tree/main/.claude/skills/scope-feature-tests
Command: npx skills add https://github.com/constructorfabric/insight --skill scope-feature-tests-constructorfabric

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding what to test for a new feature is high-leverage but error-prone: requirements-only passes miss implementation risks, and case-level lists bury the coverage shape. This Skill turns a feature into a code-grounded test scope with risk-ordered test groups, target suites, scope boundaries, and an acceptance gate. ## Core Features & Use Cases - Code-grounded scoping: Inspects the implementation, Bronze-to-Gold data flow, consumer contracts, and existing tests to expose gaps, risks, and spec disagreements before writing any test plan. - Shape-aware strategy: Adapts the gate to the feature type — differential parity for ports and consolidations, security fail-closed matrices for platform replacements, reusable per-wave gates for rolling migrations, and correctness ordering for new capabilities. - Lean actionable output: Produces a compact, risk-ordered plan (roughly six bullets) with suite assignments, an out-of-scope boundary, and an acceptance gate, ready to file as a linked GitHub test subtask. - Use Case: Given a GitHub issue for a metrics consolidation feature, the Skill reads the branch code, discovers the new counters must reproduce retired sibling keys, and files a scope whose headline gate is a differential with a sum-equals-parts invariant. ## Quick Start Ask the assistant to scope the tests for Insight issue #1538 using the scope-feature-tests skill and draft the resulting test subtask for review.

Frequently Asked Questions about scope-feature-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan test coverage for a new feature?▼

Start from the agreed requirements, then ground them in the real implementation and data flow to find risks and gaps. Group coverage into a handful of risk-ordered test groups with target suites, draw an explicit out-of-scope boundary, and finish with an acceptance gate.

How to test a code port or migration between implementations?▼

Use a differential gate: run the same seeded data through old and new implementations and compare outputs row by row. Tag each expectation as exact, known-diff with direction, or merge, since a blanket zero-diff gate fails intended changes.

Does this Skill write individual test cases?▼

No, it deliberately stops at the test-group level. Individual cases come later via the quality-vector-tests skill, which turns the scope into tracked scenarios in an issue or FEATURE artifact.

Can it scope tests when the feature code is not merged yet?▼

Yes, it locates in-progress work via gh pr list and git branch searches, then reads the branch directly or through a worktree. A branch's DESIGN doc is often the richest source of the test surface.

What happens when code and requirements disagree?▼

The mismatch is reported before expectations change. A must-verify check is added using the agreed behavior, the defect is flagged to the author, and undefined behavior becomes a recorded specification question rather than letting the implementation be its own oracle.