菜单
Use for `/ddalggak` repo workflow subcommands, ULW, and GJC.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | ddalggak |
| description | Use for `/ddalggak` repo workflow subcommands, ULW, and GJC. |
| argument-hint | [subcommand] — no arg = start from GitHub issue |
| user-invocable | true |
딸깍은 GitHub Issue → 계획 → 구현 → 리뷰 → 회고 thin router다. 긴 절차·템플릿은 references/templates/scripts에 둔다.
사이클: prompt → tune → forge → spark → plan → start → ship → review → retro; 나머지는 보조 명령이다.
소스 수정은 아래 표의 ✅ subcommand만 가능하다. ❌는 read-only이며 표의 산출물만 작성한다.
| 서브커맨드 | 소스 코드 수정 | 작성 가능한 산출물 |
|---|---|---|
start | ✅ | worker agents may edit only files named in their brief |
review | ✅ | author agents may apply accepted Critical/High review fixes only |
status | ❌ | response output only |
plan | ❌ | response output only unless the user separately asks to write a plan document |
issue | ❌ | GitHub issues only |
clean | ❌ | local branch and worktree cleanup only after merge verification |
ship | ❌ | commit, push, and draft PR for existing changes only |
retro | ❌ | retrospective notes and memory update request artifacts only |
prompt | ❌ | brief artifacts after explicit confirmation |
tune | ❌ | goal-alignment brief artifacts only |
forge | ❌ | acceptance-criteria artifacts only |
spark | ❌ | runtime-goal sentence artifacts only |
check | ❌ | local review notes only; no repository edits |
getwiki | ❌ | delegate to dedicated /getwiki read-only retrieval |
setwiki | ❌ | delegate to dedicated /setwiki approval-gated write workflow |
ulw-loop | ✅ | scoped edits; no GitHub |
ulw-plan | ❌ | plan output only |
ulw-research | ❌ | research output only |
gjc-plan | ❌ | coordinator evidence |
gjc-execute | ✅ | approved edits; no GitHub |
gjc-team | ✅ | approved team work; no GitHub |
항상 로드되는 본문은 routing, 권한, guardrails, dispatch/reference map, stop/verify만 담고 상세 절차는 references/templates/scripts/eval로 넘긴다.
첫 번째 whitespace-separated word만 라우팅에 사용한다.
start로 route한다.#<번호>, 베어 issue 번호, owner/repo#<번호>)이면 start로 route하고 전체 인자를 issue context로 취급한다. issue 참조는 명령어가 아니라 인자다.doctor, setup 등 bin/ddalggak.js가 처리하는 명령)이면 route하지 않고 "터미널 CLI 명령입니다 — 셸에서 ddalggak <명령>을 실행하세요"로 안내한 뒤 멈춘다.start로 자동 진입하지 않는다(fail-closed). NEEDS_CLARIFICATION으로 아래 생성 테이블의 지원 subcommand 목록을 제시하고 의도를 되묻는다.-> <subcommand> 실행을 출력한다.CI/check, formal review/branch protection, merge blocker, human action을 분리한다.references/agent-runtime-contract.md owns Task Scope Contract, Context Assembly Manifest, Resume Snapshot, Control-flow ownership, tool capability boundary, task scope contract, out-of-scope diff, scope-expansion failure.references/quality-lens-router.md owns Applicable gate families, Skipped gates, Required references, Repo/product conventions, backend-only skip. Domain gate is a lens, not a mandate.react-code-quality-harness와 references/react-code-quality-harness.md; hot path에 gate 복사 금지.references/wiki-context-preflight.md; wiki-derived claim은 source path/evidence gap. references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md: broad qmd://wiki is discovery only; current-answer claims route through Brain P0/P1/domain/SSOT/control docs; raw/imported/hidden/index/log/redirect alias hits are evidence-only unless canonical/distilled.getwiki read-only retrieval, setwiki approval-gated write; references/wiki-bridge.md owns admission/approval boundary.references/evidence-contract.md 기준이며 Blocking evidence gaps가 있으면 PR ready/APPROVE 금지다.references/simplicity-deletability-gate.md 기준이며 small direct change first와 why is this abstraction necessary?를 우선한다.references/core-invariants.md가 Counterargument Pass, scope expansion, privacy, knowledge extraction, rendered evidence, component methodology gate, raw UTF-8 같은 장문 guardrail rationale를 소유한다.| subcommand | mode | show-doc heading | 목적 | side effects | stop condition | 상세 reference rule |
|---|---|---|---|---|---|---|
start | source-edit | Start Workflow | Issue implementation from live issue body/comments; one issue PR by default | Repo source edits in issue scope; start publishes the issue PR via the ship procedure (ship.md); cross-review comments come through the review gate. | Stop on stale base, missing issue body/comments, duplicate PR, or required files outside the issue-owned scope. | refs: references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md, references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/agent-runtime-contract.md, references/core-invariants.md, references/deep-interview-readiness-gate.md, references/start-workflow.md; templates: templates/worker-brief.md, templates/conductor-state.md, templates/lane-state.md, templates/artifact-manifest.md |
review | review-fix | Cross-Review Loop | Independent current-head review and accepted fix loop | Top-level review comment plus inline line-anchored review comments for every triage-passing finding in one COMMENT-event batch; accepted Critical/High fixes may edit source and push to the reviewed PR branch. | Stop before APPROVE if current-head CI is not terminal green/skipped, blockers remain, or wiki/evidence preflight has blocking gaps. | refs: references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md, references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/core-invariants.md, references/regression-library.md, references/cross-review-loop.md, references/human-review-feedback-loop.md, references/ci-failure-triage-loop.md, references/security-posture-gate.md; templates: templates/review-brief.md, templates/fix-brief.md |
status | read-only | Status | Read-only live git/GitHub/session state snapshot | No source, GitHub, or local cleanup mutation; report live git/GitHub/session state only. | Stop after a live state snapshot and next-action recommendation. | refs: references/wiki-context-preflight.md, references/status.md, references/pr-check-evidence-bundle.md; templates: - |
plan | plan-only | Issue-Ready Plan | Issue-ready implementation plan from issue/wiki/code evidence | No source edits; no GitHub writes unless the user separately requests issue creation. | Stop after an issue-ready plan with evidence/unknowns and PR topology. | refs: references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md, references/wiki-bridge.md, references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/core-invariants.md, references/deep-interview-readiness-gate.md, references/ralplan-critic-consensus.md, references/issue-ready-plan.md; templates: - |
issue | github-write | Plan to Issues | Create GitHub issues from an approved plan | Create/edit GitHub issues and comments only; no repository source edits. | Stop after live issue URLs/labels/assignees/body UTF-8 verification or on metadata permission failure. | refs: references/wiki-context-preflight.md, references/plan-to-issues.md; templates: templates/issue-body.md, templates/epic-body.md |
clean | local-destructive | Merge Cleanup | Post-merge local cleanup after live merge evidence | Local branch/worktree cleanup only after live merge evidence; no GitHub mutation. | Stop on dirty, ambiguous, unmerged, or non-ancestor worktrees/branches. | refs: references/wiki-context-preflight.md, references/merge-cleanup.md; templates: - |
ship | github-write | Ship | Commit/push/open draft PR for existing scoped changes | Commit, push, and draft PR for already-existing scoped changes; no new source edits. | Stop after PR creation/current-head publication evidence or on no-diff/scope/validation blocker. | refs: references/wiki-context-preflight.md, references/ship.md; templates: - |
retro | repo-external-write | Retrospective | Extract reusable lessons after merge without transient memory | Repo-external writes only: the retrospective note under ~/workspace/retrospective/ (or the RETRO_DIR override) and memory files or memory-update request artifacts; skill/wiki changes stay proposal-only (wiki via the approval-gated setwiki bridge); no writes to any path inside the repository. | Stop after reusable lessons are separated from transient incident records. | refs: references/wiki-context-preflight.md, references/retrospective.md, references/retrospective-workflow.md, references/wiki-growth-triage.md; templates: - |
prompt | plan-only | Prompt Optimizer | Compile safer prompt briefs without source edits | Brief/review/fix artifacts only after explicit confirmation; no canonical source edits. | Stop with READY_FOR_BRIEF, NEEDS_CLARIFICATION, BLOCKED_UNSAFE, or DISCOVERY_ONLY. | refs: references/wiki-context-preflight.md, references/prompt-optimizer.md, references/prompt-skill-optimization-staging.md; templates: - |
tune | plan-only | Tune Goal Brief | Align rough intent into a source-grounded goal brief before implementation | Brief only; no source, GitHub, or git mutation. | Stop after a scoped brief or explicit blockers. | refs: references/wiki-context-preflight.md, references/tune-goal.md; templates: - |
forge | plan-only | Forge Acceptance Criteria | Convert done conditions into objective acceptance checks | Criteria only; no source, GitHub, or git mutation. | Stop after verifiable criteria or explicit gaps. | refs: references/wiki-context-preflight.md, references/forge-goal.md; templates: - |
spark | plan-only | Spark Runtime Goal | Draft a copyable runtime goal sentence with validation checklist | Goal text only; no source, GitHub, or git mutation. | Stop after goal text and validation checklist. | refs: references/wiki-context-preflight.md, references/spark-goal.md; templates: - |
check | read-only | Local Diff Check | Read-only local diff review | Local diff review notes only; no GitHub comments and no repository edits. | Stop after findings and exact validation gaps are reported. | refs: references/wiki-context-preflight.md, references/local-diff-check.md; templates: - |
getwiki | read-only | GetWiki Bridge | Wiki context retrieval bridge | Delegate to dedicated /getwiki retrieval; no wiki or repo mutation. | Stop after cited wiki sources or retrieval gaps are reported. | refs: references/wiki-context-preflight.md, references/wiki-bridge.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md; templates: - |
setwiki | approval-gated-write | SetWiki Bridge | Wiki write workflow bridge | Delegate to dedicated /setwiki; wiki writes require explicit approval and verification. | Stop at review-only plan unless explicit approval is present; then stop after wiki write verification. | refs: references/wiki-context-preflight.md, references/wiki-bridge.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md, references/wiki-growth-triage.md; templates: - |
ulw-loop | source-edit | ULW Loop | ULW implement | Scoped edits; no GitHub. | Stop after evidence/blockers. | refs: references/wiki-context-preflight.md, references/ulw-loop.md, references/ulw-tier-triage.md; templates: - |
ulw-plan | plan-only | ULW Plan | ULW plan | Plan only; no writes. | Stop after criteria/blockers. | refs: references/wiki-context-preflight.md, references/ulw-plan.md, references/ulw-intent-routing.md; templates: - |
ulw-research | read-only | ULW Research | ULW research | Research only; no writes. | Stop after cited claims/gaps. | refs: references/wiki-context-preflight.md, references/ulw-research.md, references/ulw-epistemic-instrumentation.md; templates: - |
gjc-plan | plan-only | Gajae-Code Delegation | GJC plan | Coordinator only. | Stop after evidence/blocker. | refs: references/wiki-context-preflight.md, references/gajae-code.md; templates: - |
gjc-execute | source-edit | Gajae-Code Delegation | GJC execute | Approved edits; no GitHub. | Stop after evidence/blockers. | refs: references/wiki-context-preflight.md, references/gajae-code.md; templates: - |
gjc-team | source-edit | Gajae-Code Delegation | GJC team | Approved team work; no GitHub. | Stop after team evidence/blockers. | refs: references/wiki-context-preflight.md, references/gajae-code.md; templates: - |
| mode | 정의 |
|---|---|
source-edit | issue scope 안에서만 repo 소스 수정 가능. |
review-fix | 수용된 리뷰 수정만 PR 브랜치에 edit/push 가능. |
plan-only | 계획/브리프만; source/GitHub/git 무변경. |
read-only | 보고만; source/GitHub/git 무변경. |
repo-external-write | repo 무변경; 외부 note/memory artifact만 허용. |
local-destructive | repo/GitHub 무변경; merge-검증 local cleanup만. |
github-write | GitHub artifact와 ship commit/push만; source edit 없음. |
approval-gated-write | 명시 승인 후 외부 wiki write만. |
plan, start, review는 Quality Lens Router Output으로 적용 gate와 skipped gate를 먼저 기록한다. 모든 subcommand는 references/wiki-context-preflight.md를 먼저 읽고 Wiki Context Manifest를 남긴다. Wiki lookup/write admission은 references/wiki-bridge.md를 따른다. Evidence Contract, Simplicity / Deletability Gate, Core Invariants Reference는 readiness, code-shape, scope, privacy, knowledge-growth 판단이 있으면 필수다. Frontend/Vercel/Regression references는 조건부로만 읽고 backend-only skip reason을 남긴다.
| Subcommand | Workflow reference | Gate references | Wiki/meta references | Required templates |
|---|---|---|---|---|
start | references/agent-runtime-contract.md, references/start-workflow.md | references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/core-invariants.md, references/deep-interview-readiness-gate.md | references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md | templates/worker-brief.md, templates/conductor-state.md, templates/lane-state.md, templates/artifact-manifest.md |
review | references/cross-review-loop.md, references/human-review-feedback-loop.md, references/ci-failure-triage-loop.md | references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/core-invariants.md, references/regression-library.md, references/security-posture-gate.md | references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md | templates/review-brief.md, templates/fix-brief.md |
status | references/status.md, references/pr-check-evidence-bundle.md | - | references/wiki-context-preflight.md | - |
plan | references/issue-ready-plan.md | references/quality-lens-router.md, references/evidence-contract.md, references/simplicity-deletability-gate.md, references/core-invariants.md, references/deep-interview-readiness-gate.md, references/ralplan-critic-consensus.md | references/wiki-context-preflight.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md, references/wiki-bridge.md | - |
issue | references/plan-to-issues.md | - | references/wiki-context-preflight.md | templates/issue-body.md, templates/epic-body.md |
clean | references/merge-cleanup.md | - | references/wiki-context-preflight.md | - |
ship | references/ship.md | - | references/wiki-context-preflight.md | - |
retro | references/retrospective.md, references/retrospective-workflow.md, references/wiki-growth-triage.md | - | references/wiki-context-preflight.md | - |
prompt | references/prompt-optimizer.md, references/prompt-skill-optimization-staging.md | - | references/wiki-context-preflight.md | - |
tune | references/tune-goal.md | - | references/wiki-context-preflight.md | - |
forge | references/forge-goal.md | - | references/wiki-context-preflight.md | - |
spark | references/spark-goal.md | - | references/wiki-context-preflight.md | - |
check | references/local-diff-check.md | - | references/wiki-context-preflight.md | - |
getwiki | - | - | references/wiki-context-preflight.md, references/wiki-bridge.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md | - |
setwiki | references/wiki-growth-triage.md | - | references/wiki-context-preflight.md, references/wiki-bridge.md, references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md | - |
ulw-loop | references/ulw-loop.md, references/ulw-tier-triage.md | - | references/wiki-context-preflight.md | - |
ulw-plan | references/ulw-plan.md, references/ulw-intent-routing.md | - | references/wiki-context-preflight.md | - |
ulw-research | references/ulw-research.md, references/ulw-epistemic-instrumentation.md | - | references/wiki-context-preflight.md | - |
gjc-plan | references/gajae-code.md | - | references/wiki-context-preflight.md | - |
gjc-execute | references/gajae-code.md | - | references/wiki-context-preflight.md | - |
gjc-team | references/gajae-code.md | - | references/wiki-context-preflight.md | - |
Command contract: mode source-edit; source edits are limited to live issue-owned scope; start publishes the issue PR via the ship procedure (references/ship.md) and routes cross-review through the review gate; stop on stale base, missing issue body/comments, duplicate PR, or required files outside scope.
Full procedure: references/start-workflow.md; reusable prompt: templates/worker-brief.md.
Execution contract index:
ISSUE_PR_READY or LANE_READY with commit/push/PR/evidence/blocking gaps.Command contract: mode review-fix; source edits are allowed only for accepted Critical/High blockers; top-level review comments are allowed; stop before APPROVE when current-head CI/checks are not terminal, blockers remain, or evidence/wiki preflight has blocking gaps.
Full procedure: references/cross-review-loop.md; wiki authority: references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md; reusable prompt: templates/review-brief.md.
Execution contract index:
references/cross-review-loop.md): only triage-passing findings become inline comments in one COMMENT-event batch with ```suggestion blocks where a fix fits; filtered Low/nit notes collapse into one top-level <details> section; no finding-body duplication in the top-level comment; a zero-finding review with validation evidence is valid.Full procedure: references/status.md.
Read-only snapshot: fetch/prune, status, branch/upstream, worktrees, open PRs, linked issues, checks, blockers, session state, and next action. No source edits.
Full procedure: references/issue-ready-plan.md; wiki preflight: references/wiki-context-preflight.md; wiki bridge: references/wiki-bridge.md; Brain v0 authority: references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md.
Execution contract index:
Full procedure: references/plan-to-issues.md; reusable prompts: templates/issue-body.md, templates/epic-body.md.
Each generated issue body must preserve Owned files, Must not touch, Parallelization note, Commit lane suggestion, Validation/evidence, and Dependencies / blocked by. Use raw UTF-8 GitHub title/body payloads and verify no literal Unicode escapes persisted.
Full procedure: references/merge-cleanup.md.
Verify merge evidence first, then clean only matching branches/worktrees/artifacts. Never delete dirty or ambiguous worktrees. Never merge or enable auto-merge.
Full procedure: references/ship.md.
Validate current changes, preserve What/Why in Korean commit and PR body, open draft PR, and never merge. Use Closes #N only for full completion; otherwise Refs #N.
Full procedure: references/local-diff-check.md.
Read-only local diff review. No GitHub comments and no source edits. Report Critical/High/Medium/Low with concrete suggestions.
Full procedure: references/retrospective.md.
Separate durable reusable knowledge from incident records. Use references/wiki-bridge.md for setwiki admission: default review-only, explicit approval before wiki write. PR numbers, commit SHAs, and single-session completion logs are not durable reusable knowledge unless generalized into harness-engineering/, principles/, frontend/, or llm-wiki/ patterns.
Full procedure: references/prompt-optimizer.md.
Prompt Safety / Brief Compiler compact index: Prompt Audit, prompt grill-me, Unsafe Prompt Gate.
Judgement labels: READY_FOR_BRIEF | NEEDS_CLARIFICATION | BLOCKED_UNSAFE | DISCOVERY_ONLY.
Preserve source_edit_allowed: false; compile brief/review/fix artifacts only, and end with PROMPT_DONE.
Full procedure: references/tune-goal.md; source-grounded goal brief with scope, non-goals, assumptions, open questions, validation surfaces, and no source edits.
Full procedure: references/forge-goal.md; objective command/observation plus expected-result acceptance criteria, with no source edits.
Full procedure: references/spark-goal.md; copyable runtime goal sentence, validation checklist, non-goals, next instruction, and no source edits.
Full procedure: references/ulw-loop.md; source_edit_allowed: true; github_write_allowed: false; ULW_LOOP_DONE.
Full procedure: references/ulw-plan.md; source_edit_allowed: false; ULW_PLAN_DONE.
Full procedure: references/ulw-research.md; source_edit_allowed: false; ULW_RESEARCH_DONE.
Full procedure: references/gajae-code.md; gjc_delegate_plan; gjc_delegate_execute; gjc_delegate_team; allow_mutation: false; explicit user approval; external GJC visible-session helpers; GJC_PLAN_DONE; GJC_EXECUTE_DONE; GJC_TEAM_DONE.
Full procedure: references/wiki-bridge.md; Brain v0 authority: references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md.
Delegate to dedicated /getwiki for read-only retrieval. Preserve source paths or retrieval gaps; do not mutate wiki files.
Full procedure: references/wiki-bridge.md; Brain v0 authority: references/2026-06-04-brain-v0-wiki-authority-in-ddalggak.md.
Delegate to dedicated /setwiki for approval-gated write workflow. Require explicit approval before wiki mutation; do not inline iCloud/QMD mechanics.
Template: templates/conductor-state.md. Store phase, issue/PR/branch/worktree, validation evidence, blocking gaps, waiting-on state, and next gate before idle waits or compact boundaries.
Full procedure: references/context-compact.md. Save state before compact or long waits.
Full procedure: references/wake-resume.md. Resume from state, then re-read live GitHub/local state before acting.
Full procedure: references/common-rules.md. Korean by default, no AI trailer, no secrets, no auto-merge, no unsafe force push, exact validation evidence.
Full procedure: references/failure-prevention.md. Prevent stale repo judgments, external dependency hallucination, ignored/local-only PR inclusion, missing handoff evidence, duplicate PRs, and Markdown surgery regressions.
Full procedure: references/verification-checklist.md. Verify base freshness, issue body+comments, file tracking/local-only status, validation evidence, reviewer isolation, and Markdown fence integrity.
Branches are purpose-centered with no generated date/time suffixes; commit/PR description requirements live in references/ship.md. Completion-signal SSOT: per-subcommand completion signals are listed in the generated table below, sourced from each command's output_contract.completion_signal so the installed skill payload carries them without core/; multi-agent handoff signals LANE_READY, REVIEW_DONE, and FIX_DONE are defined in templates/worker-brief.md, templates/review-brief.md, and templates/fix-brief.md. ddalggak doctor signal-registry flags signals named here without a definition.
| 서브커맨드 | 완료 신호 |
|---|---|
start | ISSUE_PR_READY |
review | REVIEW_DONE |
status | STATUS_DONE |
plan | PLAN_DONE |
issue | ISSUE_DONE |
clean | CLEAN_DONE |
ship | SHIP_DONE |
retro | RETRO_DONE |
prompt | PROMPT_DONE |
tune | TUNE_DONE |
forge | FORGE_DONE |
spark | SPARK_DONE |
check | CHECK_DONE |
getwiki | GETWIKI_DONE |
setwiki | SETWIKI_DONE |
ulw-loop | ULW_LOOP_DONE |
ulw-plan | ULW_PLAN_DONE |
ulw-research | ULW_RESEARCH_DONE |
gjc-plan | GJC_PLAN_DONE |
gjc-execute | GJC_EXECUTE_DONE |
gjc-team | GJC_TEAM_DONE |