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.