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

bash

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