# Hypothesis Evolve Coherence

> Generate exactly one child hypothesis that improves logical coherence, causal consistency, and assumption hygiene.

- Skill: `panjose/hypothesis-evolve-coherence` (Agent Skill)
- Install (CLI): `npx skillmds@latest add panjose/hypothesis-evolve-coherence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/panjose/hypothesis-evolve-coherence/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: panjose (https://skillmd.com/u/panjose)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/panjose/hypothesis-evolve-coherence

---


# hypothesis-evolve-coherence

Goal:

- Generate exactly one child hypothesis that improves logical coherence, causal consistency, and assumption hygiene.

Inputs:

- `research_plan/RESEARCH_PLAN.json`
- selected parent `hypotheses/<id>/HYPOTHESIS.json` artifacts
- parent review artifacts
- active `state/STRATEGY_PLAN.json`

Outputs:

- `hypotheses/<id>/HYPOTHESIS.json`
- `hypotheses/<id>/HYPOTHESIS.md`
- `hypotheses/<id>/ORIGIN.json`

Context Loading:

- Open `skills/shared-references/schema-index.md`.
- Read `packages/agent_contracts/hypothesis.py` and confirm the exact `HypothesisContract` shape before writing `hypotheses/<id>/HYPOTHESIS.json`.
- Read `research_plan/RESEARCH_PLAN.json`.
- Read `state/STRATEGY_PLAN.json`.
- Read each selected parent hypothesis and its review bundle.
- Confirm that the round selected `coherence_evolution`.

Execution Prompt Contract:

- System Intent:
  - You are repairing contradictions, invalid assumptions, and causal gaps in the parent hypothesis.
- Required Reasoning Focus:
  - Remove internal contradictions first.
  - Tighten the causal chain so each step is explicit and testable.
  - Preserve novelty while reducing logical fragility.
- Do Not Do:
  - Do not add unrelated speculative branches.
  - Do not emit multiple candidate repairs.
- Quality Floor:
  - The child must directly address at least one specific weakness from the parent review bundle.
  - `origin.content.statement` must name concrete materials, catalysts, reaction conditions, mechanistic variables, or experimental targets from the parent and research goal.
  - `origin.content.mechanism` must explain a causal chain; do not write only generic phrases such as `improved mechanism`, `targeted improvement`, or `review-identified weaknesses`.
  - `origin.content.experimental_design` must include 3-6 numbered steps with measurable readouts, controls, or decision thresholds.
  - Do not use generic refinement placeholder steps such as `Apply targeted improvement`, `Characterize with standard techniques`, `Benchmark against parent`, or `Validate improvement quantitatively`.
  - If the research plan, parent hypothesis, or parent review bundle is missing, stop and report the missing artifact instead of guessing.
- Output Shape:
  - Emit the canonical `HypothesisContract`.
  - `origin.strategy`: `coherence_evolution`
  - Populate the full nested content block, including non-empty `summary` and `category`.

Execution Steps:

1. Open `skills/shared-references/schema-index.md`, then read `packages/agent_contracts/hypothesis.py` before writing `hypotheses/<id>/HYPOTHESIS.json`.
2. Identify the coherence failures in the parent set.
3. Produce exactly one corrected child hypothesis.
4. Persist canonical `HYPOTHESIS.json`, `HYPOTHESIS.md`, and `ORIGIN.json`.
5. Validate the emitted hypothesis artifact.

Completion Rule:

- This skill is complete only when one logically improved child hypothesis has been written in canonical form.