check-config-mappings

name	check-config-mappings
description	Creates and verifies source contracts for configuration defaults and constructor wiring. Use when checking zero-value defaults, config field assignments, timeout/retry settings, environment option mapping, or production constructor fields.

Check Config Mappings

Outcome

Verify that stable configuration fields are defaulted and wired through the intended source boundaries, with each captured value grounded in a bounded assignment or range line.

Existing Contract Fast Path

When the user supplies an existing contract, do not begin with broad repository search.

The commands below are authoritative. Do not search for the skill, checker, or source before running the preflight.

1. Run shepherd check "$REPO" --contract "$CONTRACT" --json.
2. If the installed bin is unavailable in this checkout, run node src/shepherd-cli.ts check "$REPO" --contract "$CONTRACT" --json from the repository root.
3. Do not invent flags such as --context.
4. On PASS, use returned grounded facts and inspect only source paths needed for the requested risk review.
5. On FAIL, inspect only failed facts and their bounded source paths before changing the contract.
6. Treat check-source-contract as the deterministic authority. If the user also requests an answer, hand the passing contract to query-large-source; do not reconstruct the answer in this skill.

Use When

• Config/default logic is explicit in source.
• A production constructor wires named fields or lists.
• Timeout, retry, idempotency, or endpoint settings must remain aligned.
• Multiple files contribute to one configuration contract.

Do not use this skill to prove runtime precedence, environment parsing, or behavioral timeout semantics. Keep those in unit/integration tests.

Workflow