By apourmd941
Selran Greenloop — the loop that runs until green. Point it at any codebase and it maps the architecture, reconstructs the spec, audits against ten quality categories, fixes what it finds, and adversarially re-verifies — repeating until nothing is left to fix. Five skills: cartographer, spec-bootstrap, pre-commit-verification, app-audit, audit-fix. Free for personal, non-commercial use.
Greenloop adversarial challenger (app-audit Phase 4.5). Given a single finding and the code it cites — but NOT the reasoning that produced it — tries to REFUTE it. Use to blind-challenge findings before delivery. Read-only.
Greenloop concurrency reviewer (app-audit Category 5: concurrency and race conditions). Use when app-audit dispatches parallel reviewers. Read-only; emits findings.
Greenloop data-integrity reviewer (app-audit Categories 1 & 2: schema integrity + data flow). Use when app-audit dispatches parallel reviewers. Read-only; emits findings.
Greenloop operational-readiness reviewer (app-audit Categories 8 & 10: operational readiness + diagnosability). Use when app-audit dispatches parallel reviewers. Read-only; emits findings.
Greenloop reliability reviewer (app-audit Categories 4 & 6: error handling + resource bounds/performance). Use when app-audit dispatches parallel reviewers. Read-only; emits findings.
Address findings from a completed app-audit run, in safe order, with per-fix verification. Use whenever the user asks to fix the audit findings, address them, work through them, or run audit-fix. Reads AUDIT_LOG.md; uses cartographer's call graph (stage 4) to order fixes by blast radius — pure-local first, large-blast-radius last, critical severity prioritized within each tier. Runs pre-commit-verification after each fix; reverts and stops on failure. Every fix is graded with a 0–1 truth score against an environment threshold (dev 0.90 / PR 0.95 / release 0.99) — below threshold, evidence is strengthened or the fix rolls back. Proof-tests are authored blind (from the finding + spec, never the fix diff). PR-scoped runs isolate fixes in a git worktree and use Conventional Commits. Closes with a tamper-proof clean-room re-run in a fresh worktree. Refreshes cartographer and re-runs app-audit on the full original scope when done.
Build and maintain a persistent codemap (.codemap/*.json — structure, dependencies, functions, warnings) of any codebase. Function-level extraction runs in four stages — tags, spec_refs, qualified names + git blame default-on; call graph opt-in. Use whenever the user asks to build, refresh, or rebuild the codemap; to map the code; to find duplicate, stale, or unused files; to ask "what's impacted if I change X" (forward/backward impact analysis over the call graph, spec sections joined in); or as part of an audit (app-audit Phase 0.5). Incremental refresh after the first full build. Works on any language.
Use this skill whenever the user asks to verify, test, check, validate, or confirm their repo before committing or pushing — including requests like "do a pre commit verification", "run local tests before push", "deep local verification", "fix everything and test it", "make sure this is ready", or "run the full verification pass". Covers stack-aware test discovery, unit/integration/e2e tests, smoke tests, lint checks, type checks, builds, and a runtime smoke/integration harness (binary-launch, migration idempotency, provider mocks, headless webview + browser verification for web UIs, env probe). Supports a tamper-proof clean-room mode (re-run in a fresh worktree of HEAD so uncommitted state can't rig the verdict), an Ed25519-signed witness manifest for tamper-evident green results, and per-check reliability tracking across runs (pass³) that exposes flaky checks instead of retrying them green. Do NOT use for a single narrow test unless explicitly requested.
Reconstruct a design spec (SPEC.md) for a codebase that doesn't have one — derive observed behavior from the code, interview the user to separate intent from accident, and produce a section-numbered, provenance-marked spec that app-audit can generate its checklist from. Use when the user asks to write or create a design spec, document what the app should do, or formalize requirements for an existing app — and automatically when app-audit Phase 1 finds no spec. Every statement is marked [confirmed] / [observed] / [assumed] so audits know how much to trust each claim. Optional formal surface: EARS-form requirements and Gherkin scenarios (which seed the acceptance map), architectural decisions captured as ADRs, and a C4-style context/container diagram generated from cartographer's codemap.
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
The loop that runs until green. By Selran — written and maintained by Aidin Eslampour.
An autonomous, repeatable dev-loop for any codebase. Point it at a repo; it runs cartographer → app-audit → audit-fix in a loop until the oracles are green — no residual errors in the audited categories — then hands back reviewable commits. Born from a simple frustration: AI-assisted builds where "done" was claimed but errors always remained. Greenloop is the methodology that makes "done" checkable.
Free for personal, non-commercial use. No redistribution or commercial use without permission — see LICENSE.
New here? QUICKSTART.md — install to first findings in 60 seconds: say "quick audit" for a zero-setup, minutes-long pass; plain "audit" for the standard loop; "deep audit" for everything.
(The engine's internal name remains devloop — config dir .devloop/, driver
devloop.py, CLI autoloop. Greenloop is the product; devloop is the plumbing.)
.devloop/autoloop.toml.skills/ is now the canonical home for the methodology skills — replacing the old
LocalDrop copies. A tagged DevLoop release pins a known-good combination of all
five, which is what kills the version drift we used to hit.
| Skill | Version | Role |
|---|---|---|
| cartographer | 0.6.0 | Maps the codebase (.codemap/*.json); answers impact-analysis queries ("what's impacted if I change X?") over the call graph with spec sections joined in |
| pre-commit-verification | 0.9.0 | Runs tests, acceptance map + the smoke/integration harness (incl. browser verification for web UIs); tamper-proof clean-room re-runs in a fresh worktree; optional Ed25519-signed witness manifest; per-check reliability (pass³) tracking that exposes flaky checks |
| spec-bootstrap | 0.2.0 | Reconstructs a provenance-marked design spec for apps that never had one; optional EARS requirements + Gherkin scenarios (seeding the acceptance map), ADRs, and a C4-style diagram derived from the codemap |
| app-audit | 0.14.0 | Convergent audit (10 categories) — deterministic detectors → grounded findings with confidence + new/pre-existing provenance → adversarial challenge; whole-codebase or PR/diff-scoped with findings posted as PR comments / issues; read-only-enforced review window; self-learning (chronicle, cleared registry, learned detector rules, opt-in shared brain); resumable rounds, churn×coverage hotspots, TECHNICAL_DEBT.md + status.json + optional HTML dashboard; opt-in cross-provider second opinions (codex/gemini/ollama) with consent gate; claim-level spec-drift detection + per-round traceability matrix; detector-readiness probe + bundled offline SAST ruleset; SARIF / code-scanning export + GitHub/GitLab CI templates with a merge gate; governed suppressions (.greenloopignore + inline, reasons mandatory, expiry-dated, meta-audited); framework depth packs (react/fastapi/axum, recall-gated); live panel via Selran Hub when present |
| audit-fix | 0.14.0 | Fixes findings safely (baseline-aware verify, adversarial re-verification — optionally by a different provider, 0–1 truth-score gate per fix, blind-authored proof-tests, blast-radius + provenance ordering, worktree-isolated PR fixes, Conventional Commits, clean-room close, chronicle fix-lessons, crash-safe resume, live fix progress via Hub) |
The audit dashboard became a findings workbench. Run through
design-director (technical-minimal — one forest-green accent, a five-step
severity ramp, monospace data, system-sans chrome, zero webfonts), it now
carries: search + severity-chip filters, a drill-in drawer (click any
finding for its description, evidence, code snippet, suggested fix, and
suppression reason), and a fifth Suppressed column so accepted findings stay
visible instead of vanishing. The local run UI (ui/devloop_ui.py) was
rethemed to the same system (dropped Inter, added the green identity and a dark
mode). Still one self-contained file — no server, no CDN, no network — and a
pure view of .audit/status.json. Design system: ui/design-system.md.
npx claudepluginhub apourmd941/selran-devloop --plugin greenloopSelran Hub — connect Claude to the local control room for the Selran ecosystem. Query your connected folders, databases, and APIs as MCP data sources, check connection health, and inspect schemas — all against the Hub daemon running privately on 127.0.0.1. Requires the free Selran Hub installed (pipx install git+https://github.com/apourmd941/selran-hub, or the signed macOS app). Local-first: no telemetry, no cloud backend.
context-keeper — cross-session memory for Claude Code. Recall ranked, token-budgeted context from every past session (recall, list_sessions, list_projects MCP tools), with an optional auto-recall hook and a local mind-map UI of your projects, topics, and sessions. Local-first: your transcripts are indexed on your machine by a local embedding model; nothing is uploaded. Requires the free context-keeper daemon (cargo install or repo build).
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
Comprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
v9.44.1 — Patch release for Gemini environment/version detection and qwen auth gating. Run /octo:setup.