constraint-driven autonomous iteration loop
Executes a repeating cycle of code modification → git commit → mechanical verification → decision logic → result logging that continues until user interruption or iteration limit. The system uses a constraint triangle (scope glob patterns, single mechanical metric, shell verify command) to enable autonomous operation without subjective judgment. Git serves as both memory and causality tracker, with automatic rollback on verification failure.
Unique: Uses constraint triangle (scope + metric + verify) to enable fully autonomous operation without human-in-the-loop judgment; implements 8-phase iteration protocol with explicit decision logic (Keep/Discard/Crash) and git-based causality tracking, enabling bold exploration with automatic rollback. This differs from typical agentic loops that require frequent human validation or rely on heuristic stopping criteria.
vs alternatives: Enables 50+ autonomous iterations with full audit trail and automatic rollback, whereas most LLM agents require human validation between steps or lack deterministic failure recovery.
interactive goal-to-configuration wizard
Converts plain-language goals into structured autoresearch configurations via a 7-phase guided workflow. The wizard validates scope constraints, suggests mechanical metrics from a database of domain-specific examples, and generates shell verify commands. Each phase includes validation gates that ensure the configuration is executable before iteration begins.
Unique: Implements a 7-phase wizard with validation gates that test metric extraction and scope coverage before iteration begins, preventing misconfigured loops. The metric suggestion database is domain-aware, offering ranked suggestions (e.g., test coverage for TypeScript projects, latency for Python services) rather than generic options.
vs alternatives: Reduces configuration errors and iteration waste by validating the setup before autonomous iteration starts, whereas manual configuration often requires trial-and-error debugging.
scope constraint enforcement with glob patterns
Restricts code modifications to files matching user-defined glob patterns (e.g., src/**/*.ts, test/**/*.test.ts). The system validates scope during setup, ensures Claude only modifies in-scope files, and logs scope violations as errors. Scope constraints enable the agent to load full context into memory without overwhelming token limits and prevent unintended modifications to configuration, documentation, or other sensitive files.
Unique: Enforces scope constraints via glob patterns, enabling the agent to load full context of in-scope files into memory without overwhelming token limits. Scope validation at setup prevents misconfigured iterations, and scope constraints are transparent (users see exactly which files can be modified).
vs alternatives: Provides explicit scope constraints via glob patterns, enabling safe autonomous modification of large codebases, whereas most agentic systems either modify all files or require manual file selection.
crash recovery and error resilience
Implements strategies for recovering from iteration failures (e.g., verify command timeout, git rollback failure, metric extraction error). The system logs errors with full context (iteration number, command output, stack trace), automatically rolls back failed iterations, and continues to the next iteration. For unrecoverable errors (e.g., git corruption), the system halts and logs detailed diagnostics to enable manual recovery.
Unique: Implements automatic rollback on failure with detailed error logging, enabling long-running iteration loops to recover from transient failures without halting. Error logs include full context (iteration number, command output, stack trace), enabling users to debug failures and adjust verification commands.
vs alternatives: Provides automatic crash recovery with detailed diagnostics, whereas most agentic systems halt on failure or require manual intervention to recover.
adversarial security audit loop
Executes autonomous security testing via an adversarial iteration loop that applies STRIDE threat modeling and OWASP vulnerability patterns. Each iteration generates adversarial test cases, runs them against the codebase, and logs security findings. The loop uses a threat model as the constraint and vulnerability count as the mechanical metric, enabling autonomous security hardening.
Unique: Applies constraint-driven iteration to security hardening by using threat models as scope constraints and vulnerability count as the mechanical metric. The adversarial loop systematically explores STRIDE/OWASP categories rather than relying on passive scanning, enabling autonomous discovery of vulnerabilities that match the threat model.
vs alternatives: Enables continuous autonomous security hardening with full iteration history, whereas traditional SAST/DAST tools are point-in-time and require manual remediation workflows.
git-based iteration memory and causality tracking
Uses Git commits as the primary memory mechanism, storing one commit per iteration with Claude's modification summary in the commit message. Each commit is tagged with iteration metadata (metric value, timestamp, decision status). On verification failure, the system automatically reverts to the previous commit, preserving causality and enabling crash recovery. The git log serves as a queryable audit trail of all attempted improvements.
Unique: Treats Git commits as first-class memory, with each iteration creating an immutable record that includes metric value, decision logic, and modification summary. Automatic rollback on failure preserves causality without requiring external state stores, and the git log becomes a queryable archive of the entire optimization trajectory.
vs alternatives: Provides built-in crash recovery and audit trail without external databases, whereas most agentic systems require separate logging infrastructure and manual rollback on failure.
mechanical metric extraction and validation
Executes a user-provided shell command to extract a single numeric metric from test output, build logs, or custom scripts. The metric is parsed deterministically (e.g., grep for percentage, regex for latency value) and compared against the previous iteration to decide Keep/Discard. The system validates metric extraction during setup and caches baseline measurements to enable fast iteration-to-iteration comparisons.
Unique: Enforces mechanical (deterministic, numeric) metrics as the sole decision criterion, eliminating subjective judgment from the autonomous loop. Metric extraction is validated during setup and cached to enable fast comparisons, and the system explicitly rejects non-deterministic or multi-objective metrics that would require heuristic decision-making.
vs alternatives: Enables fully autonomous decision-making without human judgment by requiring mechanical metrics, whereas most agentic systems rely on heuristic scoring or human feedback.
bounded and unbounded iteration modes
Supports two iteration strategies: bounded mode (run exactly N iterations, then stop) and unbounded mode (run until user interruption). Bounded mode is useful for exploration with a fixed budget; unbounded mode enables continuous improvement until diminishing returns. The system tracks iteration count, elapsed time, and metric trajectory to inform stopping decisions.
Unique: Provides explicit bounded and unbounded modes rather than heuristic stopping criteria, giving users control over iteration budget. Bounded mode enables reproducible experiments with fixed iteration counts; unbounded mode enables continuous improvement without predetermined limits.
vs alternatives: Offers explicit control over iteration budget, whereas most agentic systems use heuristic stopping criteria (e.g., no improvement for N steps) that are difficult to tune and reproduce.
+4 more capabilities