oliver-kriska/claude-elixir-phoenix / lab/autoresearch
lab:autoresearch
VerifiedSelf-improving loop for plugin skills. Reads program.md, proposes one mutation per iteration, evaluates against deterministic scorer, keeps improvements via git, reverts failures. Targets weakest skill+dimension. Use with /loop for overnight runs.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 130 B |
| SKILL.md | skill md | 4.6 KB |
| program.md | markdown | 3.9 KB |
| references/mutation-strategies.md | markdown | 2.4 KB |
| references/state-management.md | markdown | 1.1 KB |
| retention.py | script | 5.7 KB |
| scripts/checks.shexecutable | script | 3.2 KB |
| scripts/protected_sections.py | script | 3.4 KB |
| scripts/run-iteration.py | script | 25.0 KB |
| scripts/score-skill.py | script | 1.2 KB |
| tests/__init__.py | script | 0 B |
| tests/test_deviation_dispatch.py | script | 3.1 KB |
| tests/test_protected_sections.py | script | 3.3 KB |
references/mutation-strategies.md
View on GitHub# Mutation Strategies
## Mutation Types
### compress_section
Remove verbosity while preserving meaning. Target sections exceeding 40 lines.
**When**: conciseness dimension fails on `max_section_lines`
### add_iron_law
Add a missing Iron Law from patterns observed in other skills.
**When**: safety or completeness fails on `has_iron_laws` with low count
### rewrite_description
Improve frontmatter description for better auto-triggering.
**When**: triggering fails on `description_keywords` or `description_length`
**Keywords**: elixir, phoenix, liveview, ecto, oban, genserver, test, deploy, security, etc.
### move_to_references
Extract detailed content from SKILL.md to references/*.md.
**When**: conciseness fails on `line_count`
**Rule**: Iron Laws MUST stay in SKILL.md (agents may not read references/)
### fix_stale_reference
Update a cross-reference that points to a renamed, moved, or removed file/skill/agent.
**When**: accuracy fails on `valid_skill_refs`, `valid_agent_refs`, or `valid_file_refs`
### add_missing_section
Add a required section that doesn't exist.
**When**: completeness fails on `section_exists`
### add_table
Convert prose to a decision table for quick scanning.
**When**: conciseness or completeness — section is verbose but information-dense
### add_prohibition
Add explicit NEVER/MUST NOT/DO NOT rules.
**When**: safety fails on content_present for prohibition patterns
### add_description_structure
Add "Use when..." component to description.
**When**: specificity fails on `description_structure`
### add_examples
Add code blocks with concrete patterns.
**When**: specificity fails on `has_examples`
### increase_action_density
Convert theory/context into imperative instructions.
**When**: clarity fails on `action_density`
## ReflexiCoder Pattern (Post-Discard Analysis)
After a discard, BEFORE proposing the next mutation on the same skill:
1. Read the discarded mutation from results.tsv
2. Re-run the scorer to see exactly which checks got WORSE
3. Understand the causal chain: what did the mutation break?
4. Propose a mutation that achieves the same goal without the regression
## Strategy Selection
| Strategy | Best For | Convergence |
|----------|----------|-------------|
| `targeted` | Known weak spots, early optimization | Fast on low-hanging fruit |
| `sweep` | Broad improvement, initial pass | Steady, predictable |
| `random` | Escaping local optima, exploration | Slow but diverse |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |