oprogramadorreal/optimus-claude

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Runs a structured design conversation — clarifies intent, proposes 2-3 approaches with trade-offs, iterates the design — and writes a user-approved engineering spec to docs/specs/ that /optimus:tdd auto-detects. No implementation happens until the spec is approved. With the scaffold argument, creates docs/product/…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Reviews local changes, an open PR/MR, or a branch diff against the project's own coding guidelines, running parallel agents that each cover a different lens — bugs, security, guidelines, architecture, simplification, plus test coverage and API contracts when relevant. Excludes style and linter-catchable issues.…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Stages, commits, and optionally pushes local changes with a Conventional Commits message — always previews and confirms first, and offers a feature branch on protected branches. Modes: "suggest" proposes a message without committing (read-only); "branch [description]" creates and switches to a conventionally named…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Runs an iterative auto-fix loop on a chosen target — review, refactor, or coverage — dispatching the base skill into fresh subagent contexts per iteration, applying fixes automatically without per-change approval, running tests with bisection on failure, and checkpoint-committing until convergence or the cap. Requires…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Prunes and consolidates the project's auto-memory to keep it minimal — deletes stale, wrong, or redundant memories, merges overlapping ones into existing files, and trims the index. Strong bias against growth: never creates new memory files and never stores new facts. Verifies staleness against the current codebase…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Runs a Gauntlet Loop: turns an ambitious goal and optional quality references into a minimal builder/critic prompt judged against a concrete comparison bar, confirms with the user, then executes it as the lead agent until the output beats the bar or the user stops the run — or emits it as a paste-ready /goal prompt…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Compacts the current conversation into one self-contained, tool-agnostic handoff document at docs/handoffs/ .md so any fresh agent or teammate can resume the work from that file alone. References pushed artifacts by path or URL, inlines anything not on the remote, and redacts secrets and PII. Re-running on an existing…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Generates or updates a project's HOW-TO-RUN.md — one verified document teaching a new developer to set up their environment and run the project locally. Detects toolchain, source dependencies, external services, and env config via read-only agents; audits an existing file against actual project state and offers a…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Bootstraps a project for Claude Code — generates CLAUDE.md and scoped docs from detected structure (single project, monorepo, or multi-repo workspace), installs auto-format hooks and test infrastructure, and reconciles existing docs against the source. Writes under .claude/ and subproject docs/. Replaces /init; safe…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Fetches a JIRA issue via a configured MCP server and distills it into a structured task file at docs/jira/ .md that downstream skills auto-detect. Analyzes the codebase to surface missing criteria, scope, and risks; optionally writes an analysis comment or implementation tickets back to JIRA after explicit…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Builds a self-contained paper-context bundle for implementing a research paper — sources, transcription, figures, references (blocking citations fetched), an implementation spec with the reported results, open questions, dataset provenance — under paper/, with datasets in a gitignored data/. Warns when reproduction…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Configures Claude Code permissions for safe agent autonomy. Creates settings.json with allow/deny rules and a hook enforcing path restrictions, git branch protection (commit/push blocked on master/main), and precious-file safeguards. Use after /optimus:init to enable autonomous agent workflows, or standalone to lock…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Creates or updates a pull request (GitHub) or merge request (GitLab) for the current branch in the Conventional PR format — intent, summary, changes, rationale, and test plan. Pushes the branch if needed (asks before any force-push) and captures the implementation conversation's intent into the PR description. Use…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Crafts optimized, copy-ready prompts for any AI tool — LLMs, coding agents, image generators, workflow tools. Extracts intent, selects the right template, runs a diagnostic scan, and delivers a token-efficient prompt. Accepts input in any language; English output by default. Use when writing, fixing, improving, or…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Refactors code toward project-guideline compliance and testability (so /optimus:unit-test can safely increase coverage) across four analysis lenses, fanned out to parallel agents when the scope warrants it. Supports "testability" or "guidelines" focus plus flexible scoping. Read-only until the user approves the plan…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Removes files installed by /optimus:init and /optimus:permissions from the project. Compares each file against plugin templates and classifies as unmodified, likely generated, or user-modified. Always asks before deleting. Git-tracked files are noted as recoverable. Tests are never touched. Monorepo and multi-repo…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Guides test-driven development — decomposes a feature or bug fix into testable behaviors, then runs Red-Green-Refactor cycles with a failing test before every implementation. Auto-detects specs from docs/specs/ or docs/jira/, creates a feature branch (optional worktree), commits per cycle, and pushes. Recommends…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Improves unit test coverage on demand — discovers testing gaps via a reconnaissance agent and writes new tests that follow project conventions. Requires /optimus:init to have set up test infrastructure. Conservative — only adds new tests, never modifies existing test logic or source code; untestable code is flagged…

oprogramadorreal/optimus-claude

Skill Claude CodeCodex

Part of optimus-claude

Creates a git worktree for isolated parallel development — new branch in a separate directory with project setup and test baseline. Enables multiple Claude Code sessions on different tasks simultaneously. Multi-repo aware. Use when you need to work on something else without disturbing current work.