devseunggwan/praxis
Workflow rules from CLAUDE.md turned into hooks and skills that actually fire
Hand off an existing independent issue that surfaced mid-task to its own Claude Code session in a new cmux workspace, with auto-collected context; that session runs issue→worktree→PR alone. Not for splitting the current task.
Bulk recover Claude Code sessions after a crash, power loss, OOM kill, or reboot by scanning the .jsonl files Claude Code persists automatically. Interactive interview chooses recovery scope and layout. Use this when sessions died and you need them back. The .jsonl scan reflects each session's real final state, so no snapshot taken before the crash is needed.
Worktree-aware wrapper for /codex:review. Forces explicit worktree selection when several worktrees are active, preventing silent cwd mismatch, then gates every returned finding: premise verification before fact-modifying edits, flip detection halting A→B→A oscillation, sibling cross-checks for a port or parallel hotfix, a diminishing-returns advisory (PRAXIS_DIMINISHING_RETURNS_N), and a per-finding approval ask. It also reaps leaked openai-codex brokers (PRAXIS_CODEX_REAP=1).
On-demand home for the pre-merge approval procedure — the three-surface pre-ask probe, grading every open finding by its blocking decoration, carrying the anchor's Unverified gaps into a follow-up, the six-part briefing, and the AskUserQuestion approve-ask that ends it.
Point at performance-defect and memory-leak candidates in a diff — a read-only LLM reviewer reads the change plus the repository around it and reports candidates in a closed list of five classes. Report-only: nothing is executed, nothing is written, no finding is a proven defect.
Reset the current session's strike counter to 0 and clear the recorded violation list. Required after a 3rd strike block before Claude can respond again.
Session retrospect — analyze the current Claude Code session against the rules it ran under (project and global CLAUDE.md), identify friction patterns and root causes, propose context-appropriate improvement actions, then execute after user approval.
Bring an open, stalled pull request back to a mergeable state without rewriting its history — read every review surface, merge the base in, integrate what landed meanwhile, prove the core change red/green, and update the PR's own body and comments. Covers bot version-bump PRs and base retargeting; the merge itself stays behind the merge briefing.
Declare a rule violation in the current Claude Code session. Escalates — strike 1 warning, strike 2 forced review, strike 3 response block.
Show the current session's strike count (0-3) and the list of recorded violation reasons.
Pre-implementation input-surface enumeration — before writing a parser/validator/sanitizer/classifier, enumerate every input variant so each becomes a required test case.
Clean up a test suite without changing what it proves — move fixtures and helpers that were copied across test files into shared locations behind a copy guard, or audit for unnecessary tests (orphans, phrase-pins, duplicate coverage) and delete only the scope the user approves. Every change is checked against a collected-test-ID diff.
Make a slow test suite or CI test job faster and prove it — rank where the time goes on CI across many runs, prefer structural fixes (shared setup, parallel files, matrix legs) over per-file rewrites, probe parallel safety, and accept the change only on a measured CI before/after comparison.
Score the options at a decision fork on four cost axes — reversibility, blast radius, cost-if-wrong, process cost — with a provenance grade on every cell so a guess never reads as a measurement. Report-only: no totals, no ranking arithmetic, no external-surface writes.
Take a defect in an installed third-party plugin, server, or library from local diagnosis to an issue on its public repository — prove the fix in a fresh process, reproduce on pristine upstream, dedup, match the repo's conventions, and post only after approval. Also vets a contributor's fix PR against the original reproduction.
On-demand home for the pre-merge worktree precondition and the unified post-merge cleanup sequence — how to run gh pr merge --squash --delete-branch from the base-branch worktree, the submodule --force caveat, the squash-ancestry stale-HEAD guard, and the no-&&-chain rule.