Dev10x-Claude

View and customize playbooks (step-by-step procedures) for any orchestration skill. List playbook-powered skills, inspect plays, edit steps through a guided flow, or reset to defaults. TRIGGER when: user wants to view, edit, or customize playbook workflows for skills. DO NOT TRIGGER when: executing a playbook-powered skill (handled automatically by Dev10x:work-on or other orchestrators).

Post-upgrade cleanup entry point — delegates to `Dev10x:plugin-maintenance` in `full` mode. Updates plugin version paths, ensures base permissions, migrates config files (including global playbook overrides from ~/.claude/memory/Dev10x/playbooks/ to ~/.config/Dev10x/playbooks/, and databases.yaml from legacy/backup skill directories to ~/.config/Dev10x/databases.yaml), generalizes session-specific args, enumerates MCP tool globs, refreshes script coverage, merges worktree rules, audits for friction-causing patterns, and cleans redundant rules from project settings files. TRIGGER when: plugin version changes, permission prompts keep appearing, config files are at old locations, or user asks to fix permission friction. DO NOT TRIGGER when: permissions are working correctly, or you only need a fast bootstrap subset (use `Dev10x:plugin-maintenance bootstrap` instead).

Validate all pre-merge conditions and execute PR merge. Checks unresolved threads, CI status, draft state, mergeability, working copy, fixup commits, Fixes-linked scope delivery, and review approval before merging. TRIGGER when: PR is ready to merge and needs pre-merge validation. DO NOT TRIGGER when: PR is still draft, CI is failing, or review comments are unaddressed.

Restructure, polish, and clean up git commit history in the current branch before merging. Creates atomic, well-organized commits that tell a clear story. TRIGGER when: branch is ready for merge and commit history needs cleanup (squash fixups, reorder, reword). DO NOT TRIGGER when: branch has clean history already, or splitting individual commits (use Dev10x:git-commit-split).

Start work on any input — ticket URL, PR link, Slack thread, Sentry issue, or free text. Classifies inputs, gathers context in parallel, builds a supervisor-approved task list, and executes adaptively with pause/resume support. TRIGGER when: user provides ticket URLs, PR links, Slack threads, Sentry issues, or free text to start structured work. DO NOT TRIGGER when: simple one-off tasks that don't need structured planning, or parallel fanout of independent items (use Dev10x:fanout).

Validate and respond to PR review comments. Handles single comment (with follow-up offer) or batch mode for all unaddressed comments on a PR/review. Orchestrates Dev10x:gh-pr-triage and Dev10x:gh-pr-fixup. TRIGGER when: PR has review comments that need responses or fixes. DO NOT TRIGGER when: no review comments exist, or user wants to create a new PR (use Dev10x:gh-pr-create).

Verify that definition-of-done / acceptance criteria are met before closing a task list. Loads executable checks from plugin defaults, applies project overrides (add/remove/replace), runs each check automatically, and prompts the user only for manual items. TRIGGER when: task list is complete and work needs shippability verification before handover. DO NOT TRIGGER when: mid-implementation, or task list has incomplete items.

Walk-away mode — compose the walk-away gate policy so long-running sessions do not stall on re-strategy or confirmation gates. Writes gate_preset: adaptive and gate_overlays: [afk] to .claude/Dev10x/config.yaml (durable prefs, GH-774); the resolve_gate resolver reads those keys and auto-advances the pipeline while routing deferred decisions to the PR description. TRIGGER when: starting a long-running unattended session (e.g., bundle work, fanout swarm, overnight implementation), or user says "walk away" / "afk" / "headless" / "no more questions". DO NOT TRIGGER when: actively pair-programming, scoping a new ticket (use Dev10x:ticket-scope), or session is already complete.

File skill-audit findings as a GitHub issue at the Dev10x plugin repo. Invoked by skill-audit Phase 7 when the user opts in. TRIGGER when: skill-audit Phase 7 completes and user opts to file upstream. DO NOT TRIGGER when: no audit findings exist, or user wants to review findings before filing.

Run or continue a DDD Event Storming workshop to explore, model, and stress-test domain architecture. TRIGGER when: user mentions DDD, domain modeling, event storming, bounded contexts, domain events, aggregates, "workshop", "domain session", "stress test the architecture", "apply archetype", "scope the domain", or asks domain exploration questions like "add tax support" or "what breaks if we add goods pricing". Always use before ticket-scope when the feature area is new or crosses bounded context boundaries. DO NOT TRIGGER when: implementing code within a well-understood domain, or scoping a ticket in a known bounded context (use Dev10x:ticket-scope).

Process multiple independent work items as a worktree-isolated swarm — each item runs the full Dev10x:work-on lifecycle inside its own background Agent with isolation="worktree". Honors dependencies, minimizes conflicts, auto-advances by default. TRIGGER when: 2+ independent work items need parallel processing (PRs, issues, tickets). DO NOT TRIGGER when: single task or sequential dependency chain (use Dev10x:work-on); already running as a swarm child (see recursive-fanout guard).

Request review on a GitHub PR from teams or users. TRIGGER when: PR is ready for review and needs reviewer assignment. DO NOT TRIGGER when: PR is still draft or WIP, or review was already requested.

Review a GitHub pull request and post findings with inline comments. Fetches PR diff, reads changed files, checks for interface impact, applies project review guidelines, and posts a review to GitHub. Supports Draft (PENDING) and submitted review modes via Step 8a gate. Supports courtesy-fixup disposition: mechanical, unambiguous findings may be pushed as fixup! commits with reviewer consent (Step 5b/6b). TRIGGER when: reviewing an external PR and posting review comments. DO NOT TRIGGER when: reviewing own branch changes before PR creation (use Dev10x:review), or PR does not exist yet.

Guided, discovery-driven setup of Claude code-review GitHub Actions on any repo. Detects the stack, lets you pick independently-skippable review modules (code review, PR hygiene, ADR distillation, lessons-learned, second-opinion), surfaces pros/cons for each strategy decision, then scaffolds generalized workflows + reviewer specs with zero project-identifying strings copied from any source project. TRIGGER when: standing up Claude code review on a repo that has none, or adding/regenerating review automation on an existing repo. DO NOT TRIGGER when: running an existing review (use Dev10x:gh-pr-review or Dev10x:review), or monitoring a PR (use Dev10x:gh-pr-monitor).

Create a properly formatted git commit following project conventions (gitmoji, ticket reference, 72 char limit). Extracts ticket ID from branch name, prompts for description and solution points, stages changes, and creates the commit. TRIGGER when: creating a git commit with proper formatting. DO NOT TRIGGER when: amending commits, creating fixup! commits (use Dev10x:git-fixup), or splitting commits (use Dev10x:git-commit-split).

Create a fixup! commit for a PR review comment or standalone improvement. Enforces one fixup per comment thread when linked to a review. TRIGGER when: creating a fixup! commit for a review finding or standalone improvement. DO NOT TRIGGER when: creating a regular commit (use Dev10x:git-commit), or implementing PR fixes with push and reply (use Dev10x:gh-pr-fixup).

Use before running git push or git rebase — so force-pushes to protected branches are blocked and non-interactive rebases run unattended without manual editor approval prompts. TRIGGER when: running git push or git rebase operations. DO NOT TRIGGER when: other git operations (commit, status, log, diff) that don't need push/rebase safety.

Schedule a Slack reminder — so deferred items appear when you are clearing messages, not buried in a file you might not open. TRIGGER when: deferring work that should resurface via Slack notification later. DO NOT TRIGGER when: deferring to code or project storage (use Dev10x:park-todo), or routing to the best destination automatically (use Dev10x:park).

Maintain Dev10x plugin configuration — ensure base permissions, migrate config files, generalize session-specific allow rules, enumerate MCP tool globs, refresh script coverage, merge worktree permissions, audit permissions for friction, and clean redundant rules from project settings. Two modes: `bootstrap` (fast subset for first-time setup) and `full` (complete cleanup, default). TRIGGER when: bootstrapping a new install, after `claude plugin update`, when permission prompts appear unexpectedly, or when `Dev10x:onboarding` / `Dev10x:upgrade-cleanup` orchestrates maintenance. DO NOT TRIGGER when: permissions are already working and no upgrade or bootstrap is in progress.

Comprehensive project-level architecture audit. Catalogs design patterns from multiple sources, stress-tests domain models, maps JTBD from PR history against test coverage, and produces a prioritized improvement backlog. TRIGGER when: user requests architecture audit, project health check, pattern catalog mapping, or comprehensive quality review. DO NOT TRIGGER when: reviewing a single branch (use Dev10x:review), scoping a single ticket (use Dev10x:ticket-scope), or running a DDD workshop (use Dev10x:ddd).

Guide UV installation and migrate Python scripts from legacy shebangs to UV inline metadata (PEP 723). TRIGGER when: migrating scripts to uv, setting up uv for the first time, or converting shebangs to PEP 723 format. DO NOT TRIGGER when: uv is already configured, or user is writing standard Python packages (not standalone scripts).

Consume structured findings from Dev10x:review and create one standalone fixup! commit per finding via Dev10x:git-fixup. TRIGGER when: Dev10x:review has produced a findings JSON file that needs fixup commits. DO NOT TRIGGER when: no findings file exists, or addressing PR review comments from external reviewers (use Dev10x:gh-pr-fixup).

Review your own branch changes before creating a PR. Reviews diff against base branch, runs automated checks, and produces structured findings with severity, file, line, and suggested fix. Works in attended (pick findings) or unattended (auto-advance to fixer) mode. TRIGGER when: reviewing own branch changes before PR creation, or self-reviewing code quality. DO NOT TRIGGER when: reviewing an external PR (use Dev10x:gh-pr-review), or no changes exist on the branch.

Audit a session's skill usage, compliance, and extract lessons learned. Default (lightweight): analyzes visible context inline and presents a disposition gate — no separate terminal needed for most audits. Forensic (--full or escalation): dispatches parallel subagents for deep transcript analysis — run from a separate terminal. TRIGGER when: session is complete and user wants usage review, or a skill didn't behave as expected. DO NOT TRIGGER when: mid-session during active work, or user is asking about a specific skill's documentation.

Use when merged PRs may have unresolved review threads accumulating as silent tech debt — so unaddressed feedback gets surfaced, grouped by theme, and tracked as issues. TRIGGER when: reviewing merged PRs for accumulated tech debt, or post-merge as part of maintenance workflow DO NOT TRIGGER when: reviewing active draft PRs, or as part of automated PR review (not designed for real-time feedback)

Create git worktrees for clean workspace isolation. Offers two modes: native EnterWorktree (switches CWD in current session) or external worktree (IDE-isolated, requires restarting claude in new dir). TRIGGER when: starting feature work needing isolation, or executing implementation plans with independent tasks. DO NOT TRIGGER when: work can be done on the current branch without isolation, or user explicitly wants to stay in the current worktree.

Launch a background agent to monitor PR CI checks and review comments, automatically address issues with fixup commits, and notify team when ready. Use after creating a PR to automate the entire review cycle. TRIGGER when: PR has been created and needs CI/review monitoring. DO NOT TRIGGER when: PR does not exist yet (use Dev10x:gh-pr-create first), or user wants to manually handle review comments.

Guided discovery of Dev10x capabilities for new users. Interactive tour through skill families, git setup, PR pipeline, session management, and customization — adapted to experience level. TRIGGER when: user is new to Dev10x, asks what it can do, or wants a walkthrough of available capabilities. DO NOT TRIGGER when: user already knows what skill to use, or is asking about a specific feature (use that skill directly).

Gather deferred items across all sources — so nothing is missed when starting a session or picking up where you left off. TRIGGER when: starting a session, picking up prior work, or checking for deferred items. DO NOT TRIGGER when: mid-session active work with no need to check deferred items.

Capture and route unfinished work at session end — so nothing is lost when the session closes. TRIGGER when: session ending, user says "wrap up" / "pause" / "done for today", or too many open loops pile up. DO NOT TRIGGER when: mid-session active work with manageable task list, or starting new work (use Dev10x:work-on).

Pure JTBD story drafting skill. Gathers context from issue tracker tickets, parent tickets, and PR diffs to craft a situation-driven Job Story with explicit actor and beneficiary. Returns the draft string with no side effects. TRIGGER when: drafting a JTBD Job Story for a ticket, PR, or release. DO NOT TRIGGER when: Job Story already exists on the target, or writing commit messages (use Dev10x:git-commit).

Seed a default .claude/Dev10x/session.yaml when it is missing, so work-on / verify-acc-dod have a session config to read. Idempotent — an existing file is preserved. TRIGGER when: a skill (e.g. work-on Phase 0) finds session.yaml absent and needs a default before reading friction_level / active_modes. DO NOT TRIGGER when: session.yaml already exists (the seed is a no-op), or you need to CHANGE an existing config (edit it directly — this skill never overwrites).

Use when querying, linking, or fetching JIRA issues — so credentials, hook-safe curl patterns, and hierarchy gotchas are always at hand

Create an issue tracker ticket (GitHub issue, Linear, or JIRA) with proper formatting, description structure, and labels. Accepts title, description content, and optional labels. Automatically formats the description with Root Cause, Solution, and Files Changed sections. Returns the created ticket ID. TRIGGER when: a new ticket needs to be created for tracking work. DO NOT TRIGGER when: ticket already exists (use Dev10x:ticket-scope to enrich it), or user wants to update an existing ticket.

Validate a PR review comment against the codebase. If invalid, reply with evidence. Never auto-resolves threads — resolution requires explicit user confirmation. Returns a verdict (VALID, YAGNI, INVALID, QUESTION, OUT_OF_SCOPE) so the caller knows whether to fix, remove out-of-scope code, reply, or defer. TRIGGER when: PR review comment needs validation before implementing fix. DO NOT TRIGGER when: comment is clearly valid and needs immediate fix (use Dev10x:gh-pr-fixup directly).

Track in-session work items — so open loops are visible and triageable before session end without losing track of parallel work. TRIGGER when: managing in-session task tracking, viewing open loops, or adding work items mid-session. DO NOT TRIGGER when: starting structured work from inputs (use Dev10x:work-on), or wrapping up a session (use Dev10x:session-wrap-up).

Create a properly named git branch for a ticket following project conventions (username/TICKET-ID/[worktree/]short-slug). Ensures latest develop is pulled before creating the branch. Automatically detects worktrees and includes worktree name in branch. TRIGGER when: starting work on a ticket and need a feature branch. DO NOT TRIGGER when: branch already exists for this ticket, or creating a worktree (use Dev10x:git-worktree which creates branches internally).

Set up git aliases that reduce permission friction by wrapping $(git merge-base ...) subshells into stable command prefixes. TRIGGER when: SessionStart reports missing aliases, or user hits permission friction from subshell-based git commands. DO NOT TRIGGER when: aliases already configured (check git config).

Safe read-only psql wrapper for Claude Code. Provides db.sh with SQL validation hook so database queries are safe and auditable. Configure databases in databases.yaml with env var or keyring backends. TRIGGER when: executing SQL against configured databases. DO NOT TRIGGER when: planning queries (use Dev10x:db), or working with non-database tasks.

Detect PR context (number, repo, URL, branch) from a URL, PR number, or current branch — so skills like Dev10x:gh-pr-monitor always get the correct target PR even in multi-worktree setups. TRIGGER when: resolving PR context from URL, number, or branch for downstream skills. DO NOT TRIGGER when: PR context is already known and passed explicitly.