---
name: ll-refine-issue
description: Refine issue files with codebase-driven research to fill knowledge gaps needed for implementation
args: "ISSUE_ID [--auto] [--dry-run] [--gap-analysis] [--full-rewrite]"
allowed-tools:
  - Read
  - Glob
  - Edit(.issues/**)
  - Task
  - Bash(git:*, ll-issues:*)
  - Bash(ll-history-context:*)
metadata:
  short-description: Refine issue files with codebase-driven research to fill knowledge gaps needed f
---

# Refine Issue

Bridged from `commands/refine-issue.md` for Codex Skills API discovery.
See the source command file for the full prompt body.

- **Status enum**: `open`, `in_progress`, `blocked`, `deferred`, `done`, `cancelled` — see `.claude/CLAUDE.md` § Issue File Format for full enum and forbidden synonyms.