edge-concept-synthesizer

1# Edge Concept Synthesizer
2 
3## Overview
4 
5Create an abstraction layer between detection and strategy implementation.
6This skill clusters ticket evidence, summarizes recurring conditions, and outputs `edge_concepts.yaml` with explicit thesis and invalidation logic.
7 
8## When to Use
9 
10- You have many raw tickets and need mechanism-level structure.
11- You want to avoid direct ticket-to-strategy overfitting.
12- You need concept-level review before strategy drafting.
13 
14## Prerequisites
15 
16- Python 3.9+
17- `PyYAML`
18- Ticket YAML directory from detector output (`tickets/exportable`, `tickets/research_only`)
19- Optional `hints.yaml`
20 
21## Output
22 
23- `edge_concepts.yaml` containing:
24  - concept clusters
25  - support statistics
26  - abstract thesis
27  - invalidation signals
28  - export readiness flag
29 
30## Workflow
31 
321. Collect ticket YAML files from auto-detection output.
332. Optionally provide `hints.yaml` for context matching.
343. Run `scripts/synthesize_edge_concepts.py`.
354. Deduplicate concepts: merge same-hypothesis concepts with overlapping conditions (containment > threshold).
365. Review concepts and promote only high-support concepts into strategy drafting.
37 
38## Quick Commands
39 
40```bash
41python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
42  --tickets-dir /tmp/edge-auto/tickets \
43  --hints /tmp/edge-hints/hints.yaml \
44  --output /tmp/edge-concepts/edge_concepts.yaml \
45  --min-ticket-support 2
46 
47# With hint promotion and synthetic cap
48…