edge-concept-synthesizer

SKILL.md

Edge Concept Synthesizer

Overview

Create an abstraction layer between detection and strategy implementation.
This skill clusters ticket evidence, summarizes recurring conditions, and outputs edge_concepts.yaml with explicit thesis and invalidation logic.

When to Use

You have many raw tickets and need mechanism-level structure.

You want to avoid direct ticket-to-strategy overfitting.

You need concept-level review before strategy drafting.

Prerequisites

Python 3.9+

PyYAML

Ticket YAML directory from detector output (tickets/exportable, tickets/research_only)

Optional hints.yaml

Output

edge_concepts.yaml containing:

concept clusters

support statistics

abstract thesis

invalidation signals

export readiness flag

Workflow

Collect ticket YAML files from auto-detection output.

Optionally provide hints.yaml for context matching.

Run scripts/synthesize_edge_concepts.py.

Deduplicate concepts: merge same-hypothesis concepts with overlapping conditions (containment > threshold).

Review concepts and promote only high-support concepts into strategy drafting.

Quick Commands

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --min-ticket-support 2

# With hint promotion and synthetic cap
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --promote-hints \
  --max-synthetic-ratio 1.5

# With custom dedup threshold (or disable dedup)
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --overlap-threshold 0.6

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --no-dedup

Resources

skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py

references/concept_schema.md