review-llm-artifacts
LLM Artifacts Review
Detect common artifacts left behind by LLM coding agents: over-abstraction, dead code, DRY violations in tests, verbose comments, and defensive overkill.
Hard gates (sequence)
Advance only when each pass condition is objectively true (prevents “review complete” without artifacts):
| Gate | Pass condition |
|---|---|
| G1 — Scope | File list is non-empty or you exit with exactly the Step 1 message; scope is set to all or changed. |
| G2 — Four categories | Tests, dead code, abstraction, and style are each reviewed (four Task runs when Step 3 applies, or four sequential passes covering the same categories). Stop if any category did not complete; do not write JSON or a summary that implies a full pass. |
| G3 — JSON before summary | .beagle/llm-artifacts-review.json exists and is valid JSON before Step 6 markdown. |
| G4 — Integrity | Step 7 checks pass before treating the run as complete. |
Arguments
Parse $ARGUMENTS for flags and optional path:
More from existential-birds/beagle
langgraph-code-review
Reviews LangGraph code for bugs, anti-patterns, and improvements. Use when reviewing code that uses StateGraph, nodes, edges, checkpointing, or other LangGraph features. Catches common mistakes in state management, graph structure, and async patterns.
826react-flow
React Flow (@xyflow/react) for workflow visualization with custom nodes and edges. Use when building graph visualizations, creating custom workflow nodes, implementing edge labels, or controlling viewport. Triggers on ReactFlow, @xyflow/react, Handle, NodeProps, EdgeProps, useReactFlow, fitView.
772tailwind-v4
Tailwind CSS v4 with CSS-first configuration and design tokens. Use when setting up Tailwind v4, defining theme variables, using OKLCH colors, or configuring dark mode. Triggers on @theme, @tailwindcss/vite, oklch, CSS variables, --color-, tailwind v4.
595react-flow-advanced
Advanced React Flow patterns for complex use cases. Use when implementing sub-flows, custom connection lines, programmatic layouts, drag-and-drop, undo/redo, or complex state synchronization.
427python-code-review
Reviews Python code for type safety, async patterns, error handling, and common mistakes. Use when reviewing .py files, checking type hints, async/await usage, or exception handling.
426docling
Docling document parser for PDF, DOCX, PPTX, HTML, images, and 15+ formats. Use when parsing documents, extracting text, converting to Markdown/HTML/JSON, chunking for RAG pipelines, or batch processing files. Triggers on DocumentConverter, convert, convert_all, export_to_markdown, HierarchicalChunker, HybridChunker, ConversionResult.
378