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.yamlcontaining:- concept clusters
- support statistics
- abstract thesis
- invalidation signals
- export readiness flag
Workflow
- Collect ticket YAML files from auto-detection output.
- Optionally provide
hints.yamlfor 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.pyreferences/concept_schema.md