plurigrid/asi / ies/music-topos/.codex/skills/safe-rewriting-advisor
safe-rewriting-advisor
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.4 KB |
| safe_rewriting.jl | other | 7.7 KB |
SKILL.md
View on GitHub# Safe Rewriting Advisor
**Category**: Graph Optimization + Remediation
**Type**: Strategic Edge Removal Analysis
**Language**: Julia
**Status**: Production Ready
**Version**: 1.0.0
**Date**: December 22, 2025
## Overview
Strategic selective edge removal maintaining spectral gap ≥ 0.25. Analyzes edge criticality via betweenness centrality to identify which proof dependencies can be safely removed without breaking system connectivity (Ramanujan property).
## Key Data Structures
```julia
struct EdgeImportance
edge_id::Tuple{Int, Int}
betweenness_centrality::Float64
gap_sensitivity::Float64
redundancy_score::Float64
recommendation::String
end
struct RewritePlan
edges_to_remove::Vector{Tuple{Int, Int}}
edges_to_split::Vector{Tuple{Int, Int}}
cycle_breakers::Vector{String}
expected_gap_before::Float64
expected_gap_after::Float64
safe::Bool
complexity::String
end
```
## Key Functions
- **`compute_edge_importance(adjacency)`**: Betweenness centrality analysis
- **`identify_redundant_edges(edges)`**: Find safe-to-remove edges
- **`generate_rewrite_plan(adjacency, gap)`**: Strategic remediation
- **`generate_rewrite_report(adjacency, gap)`**: Human-readable analysis
## Mathematical Foundation
**Edge Criticality Classification**
```
gap_sensitivity > 80% : CRITICAL - essential for connectivity
40-80% : IMPORTANT - remove only if necessary
< 40% : REDUNDANT - safe to remove
```
Uses betweenness centrality to measure how many paths depend on each edge. Recommends cycle-breaking via intermediate theorems for low-gap systems.
## Usage
```julia
using SafeRewriting
# Analyze current system
plan = generate_rewrite_plan(adjacency, current_gap)
# Check if transformation is safe
if plan.safe && plan.expected_gap_after >= 0.25
println("✓ Safe to apply $(length(plan.edges_to_remove)) edge removals")
println(" Gap projection: $(plan.expected_gap_before) → $(plan.expected_gap_after)")
end
# Get recommendations
report = generate_rewrite_report(adjacency, current_gap)
```
## Integration Points
- Week 4 remediation planning phase
- Automated maintenance pipeline for continuous-inverter
- Gap recovery strategy after tangled dependencies identified
## Performance
- Edge analysis: < 2 seconds
- Plan generation: < 1 second
- Scales to 100,000+ edges
## References
- Betweenness centrality: Freeman (1977)
- Graph remediation strategies for network optimization
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |