Skip to content

oliver-kriska/claude-elixir-phoenix / lab/autoresearch

lab:autoresearch

Verified

Self-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.

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 |
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall