By lewibs
Reusable skills and agents for feature work, debugging, PR management, documentation, and fix flows.
Open a new gnome-terminal window running claude /remote-control
Watch CI checks on a PR until completion or failure. Spawn fix handlers for failures, retry up to maxIterations. Return pass/fail status.
Watch for and resolve review comments on a PR. Handle each unresolved thread, re-run CI after resolving, retry up to maxIterations. Return resolved/failed status.
Debug a non-obvious bug. Creates a worktree, runs debugger-agent, and opens a PR with the fix.
Terminates all other running Claude / dark-factory terminal sessions and spawns one fresh factory terminal, leaving the user with exactly one active terminal.
Orchestrates automated code review by spawning high-level and low-level reviewers in parallel, then running the resolver in a loop until all issues are resolved.
Reviews code against a plan file for structural and architectural conformance. Appends high-level IssueItems to tmp/issues.md.
Reviews code at the function level for bugs, untested paths, inter-agent conflicts, and refactor opportunities. Appends low-level IssueItems to tmp/issues.md.
Reads tmp/issues.md, applies fixes for each unchecked item, checks them off, and returns whether any items remain unresolved.
Orchestrator for the investigation command. Invokes investigation-agent, then loops calling claim-validator-agent until all claims verified. Commits verified doc via SubagentStop hook.
When writing hooks or other structured data into .claude/settings.json, always read the existing file, merge new entries, and deduplicate — never overwrite the whole file.
Use this skill when building a post-manufacture auditor that scans agent execution logs and transcripts for pipeline instruction violations expressed in the agents' own words or tool call patterns.
Use this skill when writing an agent that must retry a blocking external check (CI, polling, review threads) in a loop — structure the loop with a named max-iteration guard, a BREAK-after-first-fix pattern, and re-entrance of upstream checks after downstream fixes.
How to have an agent run a helper Python script, capture its stdout URL or value, and send a PushNotification only when the script succeeds — skipping silently on failure.
When a Claude Code PreToolUse hook intercepts an Agent tool call, the prompt and subagent_type live under .tool_input, not at the top level of the hook stdin JSON.
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.
██████╗ █████╗ ██████╗ ██╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔╝
██║ ██║███████║██████╔╝█████╔╝
██║ ██║██╔══██║██╔══██╗██╔═██╗
██████╔╝██║ ██║██║ ██║██║ ██╗
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝
███████╗ █████╗ ██████╗████████╗ ██████╗ ██████╗ ██╗ ██╗
██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗╚██╗ ██╔╝
█████╗ ███████║██║ ██║ ██║ ██║██████╔╝ ╚████╔╝
██╔══╝ ██╔══██║██║ ██║ ██║ ██║██╔══██╗ ╚██╔╝
██║ ██║ ██║╚██████╗ ██║ ╚██████╔╝██║ ██║ ██║
╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝
Dark Factory is a fully autonomous coding plugin for Claude Code. Focused commands. No hand-holding. Done.
| Build features | Plans, implements, reviews, and ships new functionality end-to-end |
| Fix bugs | Diagnoses failures, applies fixes, and verifies — without you touching the code |
| Repair broken flows | Applies targeted changes, loops through test failures, and restores green CI |
| Investigate systems | Documents any system from source, validates every claim against the code |
For a deeper look at how it works, see the system documentation.
claude plugin marketplace add https://github.com/lewibs/dark-factory
claude plugin install dark-factory
claude plugin marketplace update dark-factory
claude plugin uninstall dark-factory
claude plugin install dark-factory
claude plugin list
Each command is a focused orchestrator that delegates to a single dedicated worker agent. You describe the task; the agent handles planning, implementation, code review, PR, and cleanup.
Feature work uses a structured plan template before a single line of code is written:
| Command | Input | Description |
|---|---|---|
| /dark-factory:plan | Task description | Plans a feature end-to-end — walks through system intent, architecture diagram, and per-flow approval gates, then saves the approved plan |
| /dark-factory:execute | Path to an approved plan file | Implements an approved plan — runs the full execution pipeline, code review, and opens a PR |
| /dark-factory:debug | Bug description | Diagnoses and fixes a non-obvious bug — fills out a bug audit log, applies the fix, runs code review, and opens a PR |
| /dark-factory:repair | Change description | Applies a small targeted change — no plan required, runs tests in a loop until green, opens a PR |
| /dark-factory:investigation | System name or topic | Investigates a system and writes authoritative documentation to docs/docs/ |
| /dark-factory:save | Optional task description | Commits current changes and opens or updates a PR — lightweight shortcut that skips code review and docs pipeline |
| /dark-factory:goto | PR number, task name, or description | Finds or creates the matching git worktree and pulls main/master — use this before running any other command |
| /dark-factory:build-factory | Optional terminal name | Opens a new gnome-terminal running claude /remote-control for parallel factory sessions |
| /dark-factory:destroy-factory | Optional terminal name | Terminates all other running Claude/dark-factory terminal sessions and spawns one fresh factory terminal |
| /dark-factory:gen-hooks | None | Scans YAML frontmatter of skill/agent/command files for hook declarations and writes them to .claude/settings.json |
| /dark-factory:install | None | Install or reinstall the plugin (run from repo root after git pull) |
npx claudepluginhub lewibs/dark-factory --plugin dark-factoryClaude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault (Karpathy's LLM Wiki pattern). v1.7 "Compound Vault" + v1.8 methodology modes close 5 of 5 priority gaps from the May 2026 compass artifact. Ships: substrate alignment with kepano/obsidian-skills, default Obsidian CLI transport, hybrid retrieval (contextual prefix + BM25 + cosine rerank per Anthropic's Sept 2024 research), per-file advisory locking for multi-writer safety, pre-commit verifier agent, AND methodology modes (LYT / PARA / Zettelkasten / Generic) for first-class organizational support no other Claude+Obsidian competitor offers. v1.7.x audit closure: every BLOCKER + HIGH + MEDIUM + LOW finding from the v1.7.0 audit is CLOSED or DEFERRED-with-rationale. Optional DragonScale Memory extension (log folds, deterministic addresses, semantic tiling lint, boundary-first autoresearch).
Complete AI coding workflow system. Self-correcting memory + persistent FTS5-indexed research wikis + auto-research loop + multi-LLM council on a single SQLite store. 33 skills, 8 agents, 22 commands, 37 hook scripts across 24 events. Cross-agent via SkillKit.
Make your AI agent code with your project's architecture, rules, and decisions.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
AI-powered wiki generator for code repositories. Generates comprehensive, Mermaid-rich documentation with dark-mode VitePress sites, onboarding guides, deep research, and source citations. Inspired by OpenDeepWiki and deepwiki-open.
Comprehensive C4 architecture documentation workflow with bottom-up code analysis, component synthesis, container mapping, and context diagram generation