hidden-contract-investigator

What problem does it solve?

This Skill prevents costly integration failures by uncovering the implicit behavioral contracts hidden in legacy code, so you can reuse existing functions or modules with clear, evidence-based guardrails.

Core Features & Use Cases

• Name vs. behavior contract extraction: Identify what the code actually returns, mutates, throws, and assumes, rather than trusting identifiers, comments, or type annotations.
• Mismatch classification for reuse risk: Systematically compare stated vs. observed contracts and categorize discrepancies (naming, types, state, environment dependency, hidden side effects).
• Reuse decision support: Produce a reuse feasibility verdict (A–E) and generate wrapper/adapter recommendations plus prerequisites and safety constraints.
• Verification planning with contract tests: Design minimal contract test ideas that lock down return/side-effect/exception/environment boundaries to stop contract drift.

Quick Start

Use the hidden-contract-investigator skill to analyze a specific legacy function or module for hidden return types, side effects, preconditions, exception behavior, and environment-sensitive differences before you reuse it in a new feature.