메뉴
Unified garbage collection for QE: archive completed tasks, sweep stale .qe artifacts, and analyze code garbage such as doc-code drift, rule violations, and dead code.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when collecting verified project-local coding guidance into .claude/skills based on the project tech stack, with TTL and user-edit protection.
Shows QE Framework usage overview. With no arg, prints the full catalog. With a skill name arg (e.g., /Qhelp Qcommit), reads that skill's SKILL.md and summarizes it in the user's language. Also supports find/search skills mode via reference/find-skills.md.
QE framework (Query Executor) initial setup. Creates the QE state directory, client-specific instruction/config artifacts, and .gitignore entries in a new project, then auto-analyzes the project. Use when the user wants to initialize a project or set up the framework.
Diagnoses and repairs QE installation health across qe-framework, MCP client config, and the project .qe directory. Use for 'doctor', 'check QE health', dependency verification, corrupted .qe state, or repair guidance. Distinct from Qupdate, which updates installed assets.
Use when executing a TASK_REQUEST/VERIFY_CHECKLIST or when already-changed code needs the test-review-fix quality loop. With no flag it auto-selects sequential or parallel-wave execution; `-verify` runs verification. Use Qautoresearch for iterative code-optimization loops and Qscenario-test for scenario/E2E.
Use when a plan or task needs spec documents: TASK_REQUEST and VERIFY_CHECKLIST. Use Qplan for roadmap/phases; use Qexecute after the spec exists.
| name | Qgc |
| description | Unified garbage collection for QE: archive completed tasks, sweep stale .qe artifacts, and analyze code garbage such as doc-code drift, rule violations, and dead code. |
Unified entry point for QE cleanup workflows.
Use:
Qgc <archive|sweep|analyze> [args]
Qgc analyze is the existing code garbage-collection behavior. Qgc archive
and Qgc sweep preserve the original Qarchive and Qsweep behavior through
reference files while those original skills continue to exist.
| Subcommand | Scope | Details |
|---|---|---|
| `Qgc archive [--major | --minor | --patch]` |
Qgc sweep [--apply] | Clean stale or completed .qe/ artifacts using status/date signals. Preserves Earchive-executor task archive contract and sweep analyzer/executor invocation details. | reference/sweep.md |
| `Qgc analyze [drift | lint | dead |
If the user runs Qgc with no subcommand, default to analyze for backward
compatibility.
| Command | Scope |
|---|---|
/Qgc or /Qgc analyze | Full scan (all 3 categories + skill catalog budget) |
/Qgc analyze drift | Doc-Code Drift only |
/Qgc analyze lint | Rule Violations only |
/Qgc analyze dead | Dead Code only |
/Qgc analyze budget | Skill Catalog Token Budget only |
/Qgc analyze fix | Auto-fix all fixable issues from last report |
Run gc-analyzer from hooks/scripts/lib/gc-analyzer.mjs:
skills/*/SKILL.md files and estimate total tokens using chars/4 heuristic. Reports top N skills by size and catalog total. All token estimates are labeled "자체 산정 추정치(chars/4)". Note: Korean-body skills may be ~2x undercounted due to CJK character width.Generate .qe/gc/GC_REPORT.md with findings:
# GC Report — {date}
## Summary
| Category | Found | Auto-fixable | Needs Manual |
|----------|-------|-------------|-------------|
| Doc-Code Drift | N | M | K |
| Rule Violations | N | M | K |
| Dead Code | N | 0 | K |
## Details
### Doc-Code Drift
- [severity] description
### Rule Violations
- [severity] file:line — rule — description
### Dead Code
- [severity] file — reason — last modified
Log execution to .qe/gc/gc-history.jsonl:
{"date":"2026-04-05","mode":"full","found":12,"fixed":5,"manual":7,"duration":3200}
AskUserQuestion before applying fixes: "Found N auto-fixable issues. Apply fixes?"Display GC results to user:
GC Complete: {date}
Scanned: {N} files
Found: {M} issues (drift: X, violations: Y, dead: Z)
Auto-fixed: {K}
Manual tasks: {L} (see .qe/gc/GC_REPORT.md)
session-start hook checks .qe/gc/gc-history.jsonl:
Qgc archive must delegate actual archive operations to Earchive-executor;
see reference/archive.md.Qgc sweep must preserve the Earchive-executor task archive contract and
the hooks/scripts/lib/sweep-analyzer.mjs invocation details; see
reference/sweep.md.Earchive-executor.md, sweep-analyzer.mjs, or
gc-analyzer.mjs for this entry-point merge.