القائمة
Use for ddalggak workflow subcommands, ULW, and GJC.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ddalggak |
| description | Use for ddalggak workflow subcommands, ULW, and GJC. |
Ddalggak is a thin router. Keep procedure in references/ and wording in templates/.
Supported subcommands are declared in the generated table below.
Cycle: prompt -> tune -> forge -> spark -> plan -> start -> ship -> review -> retro; other commands support.
Hot path: routing, permissions, guardrails, contracts, references, stop conditions, and verification.
Parse only the first whitespace-separated word from the invocation arguments.
start.#<number>, a bare issue number, or owner/repo#<number>), route to start and treat the full argument string as issue context. An issue reference is an argument, not a command word.doctor, setup, or any command handled by bin/ddalggak.js), do not route; reply that it is a terminal CLI command to run as ddalggak <command> in the shell, and stop.start (fail-closed). Return NEEDS_CLARIFICATION with the supported subcommand list from the generated table below and ask for intent.-> <subcommand> 실행.메타 요청 감지 - 이 작업은 ddalggak 서브커맨드 범위 밖입니다. /ddalggak 외부 일반 메시지로 다시 요청해 주세요.Source edits are allowed only where the generated table says yes; no commands are source-read-only and may produce only listed artifacts.
| Subcommand | May modify source files | Allowed artifacts |
|---|---|---|
start | yes | worker agents may edit only files named in their brief |
review | yes | author agents may apply accepted Critical/High review fixes only |
status | no | response output only |
plan | no | response output only unless the user separately asks to write a plan document |
issue | no | GitHub issues only |
clean | no | local branch and worktree cleanup only after merge verification |
ship | no | commit, push, and draft PR for existing changes only |
retro | no | retrospective notes and memory update request artifacts only |
prompt | no | brief artifacts after explicit confirmation |
tune | no | goal-alignment brief artifacts only |
forge | no | acceptance-criteria artifacts only |
spark | no | runtime-goal sentence artifacts only |
check | no | local review notes only; no repository edits |
getwiki | no | delegate to dedicated /getwiki read-only retrieval |
setwiki | no | delegate to dedicated /setwiki approval-gated write workflow |
ulw-loop | yes | scoped edits; no GitHub |
ulw-plan | no | plan output only |
ulw-research | no | research output only |
gjc-plan | no | coordinator evidence |
gjc-execute | yes | approved edits; no GitHub |
gjc-team | yes | approved team work; no GitHub |
If a non-writing subcommand would need a source edit to continue, report the need and stop.
| Subcommand | Mode | Show-doc heading | Purpose | Side effects | Stop condition | Required assets |
|---|---|---|---|---|---|---|
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 | Definition |
|---|---|
source-edit | Edit repo source only inside issue-owned scope. |
review-fix | Edit/push only accepted review fixes on the reviewed PR branch. |
plan-only | Plan/brief artifacts only; no source, GitHub, or git mutation. |
read-only | Report only; no source, GitHub, or git mutation. |
repo-external-write | Repo unchanged; repo-external notes/memory artifacts allowed. |
local-destructive | Repo/GitHub unchanged; merge-verified local cleanup only. |
github-write | GitHub artifacts plus ship commit/push only; no source edits. |
approval-gated-write | External wiki write only after explicit approval. |
Use Codex App orchestration names in briefs/state: spawn_agent, send_input, wait_agent, .ddalggak/session-state.json, and request_user_input when available. The state file owns lane IDs, worktrees, branches, issue/PR evidence, validation, review verdicts, and blockers.
git fetch --prune; know branch and ahead/behind state before validation, review, ship, or cleanup.CI/check, reviewDecision, mergeStateStatus, branch protection, and human action separately.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, and scope-expansion failure.references/quality-lens-router.md owns Applicable gate families, Skipped gates, Required references, lightweight/limited gates, backend-only skip, and Repo/product conventions. Domain gate is a lens, not a mandate.react-code-quality-harness and read references/react-code-quality-harness.md; do not copy gate conditions into the hot path.references/wiki-context-preflight.md; cite wiki paths for wiki-derived claims or record retrieval gaps.getwiki is read-only retrieval; setwiki is approval-gated write. ddalggak owns only the admission/approval boundary in references/wiki-bridge.md and delegates iCloud/QMD/wiki mechanics to the canonical wiki workflow.references/evidence-contract.md is mandatory before completion, readiness, approval, deploy, performance, UI, security, data, or API claims. Blocking evidence gaps block No evidence, no readiness or approval.references/simplicity-deletability-gate.md is mandatory for code-shape decisions. Start with small direct change first and ask why any proposed abstraction is necessary.references/core-invariants.md owns long-form guardrail rationale for Counterargument Pass, privacy, knowledge extraction, rendered evidence, component methodology gate, raw UTF-8, Self-created complexity is a defect, and no silent fallback.| 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 | - |
start - Issue-Based ImplementationCommand 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: target repo/base freshness, issue body+comments, Quality Lens Router Output, React Code Quality Harness when applicable, Evidence Contract, Simplicity / Deletability Gate, allowed/forbidden/inspect-only/Must not touch, one issue PR by default, hard-conflict fallback only with reason, validation/PR evidence, and blocking gaps.
review - Cross-Review LoopCommand 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: live PR/diff/files/checks/issue/head SHA, Wiki Context Preflight, Quality Lens Router Output, React Code Quality Harness when applicable, Evidence Contract, Simplicity / Deletability Gate, conditional frontend/Vercel/regression gates, React code quality gates when applicable, blocker triage, finding signal gate (triage-passing findings only; filtered notes in one collapsed details section; zero-finding reviews valid), inline line-anchored finding comments in one COMMENT-event batch (suggestion blocks when a concrete fix fits, no finding-body duplication in the top-level comment), and top-level conclusion comment when formal approval is inappropriate.
status - Current State SnapshotRead .ddalggak/session-state.json if present, then inspect live git/GitHub state. Report phase, lane states, branches, PRs, blockers, base freshness, and next action. Do not edit files.
plan - Issue-Ready PlanFull 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: source of truth, non-goals, context anchors, assumptions/unknowns, work inventory, ownership, forbidden/inspect-only files, Quality Lens Router Output, React Code Quality Harness when applicable, Evidence Contract, Counterargument Pass, Simplicity / Deletability Gate, one issue PR by default, conflict fallback only with proof, Parallelization Decision, Must not touch, evidence/validation, and commit message.
issue - Plan To GitHub IssuesConvert a plan into GitHub issues without editing repository files. Preserve Owned files, Must not touch, Parallelization note, Commit lane suggestion, Validation/evidence, and Dependencies / blocked by.
Issue titles and bodies must be submitted as raw UTF-8, not JSON-escaped text. Before any gh issue create or gh issue edit, reject or decode titles/bodies containing literal Unicode escapes such as \\uD558 / \\ud558; do not persist those escape sequences to GitHub. Prefer --body-file for Markdown bodies, and for non-ASCII titles prefer a UTF-8 REST payload written with json.dumps(..., ensure_ascii=False) via gh api --input. After creation, re-read gh issue view --json title,body,url and verify the live title contains Korean characters, not literal \\uXXXX sequences.
ship - Publish Current LaneShip only existing changes. Confirm scope, re-read issue context, fetch, validate, locally review where feasible, stage intended files, commit with What and Why, push, open a draft PR, verify PR existence, and keep it draft until current-head checks and review evidence support ready for manual merge.
clean - Post-Merge CleanupVerify live PR merge evidence first, fetch, inspect dirty state, then clean only safe local branches/worktrees/state artifacts. Stop on uncommitted work or contradictory live state.
retro - RetrospectiveAfter merge, summarize the cycle and extract reusable lessons without storing transient PR numbers or commit SHAs as memory. Use references/wiki-bridge.md for setwiki admission: default review-only, explicit approval before wiki write. Use references/retrospective-workflow.md for low-frequency details.
prompt - Prompt OptimizerPrompt 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.
tune - Tune Goal BriefFull procedure: references/tune-goal.md; source-grounded goal brief with scope, non-goals, assumptions, open questions, validation surfaces, and no source edits.
forge - Forge Acceptance CriteriaFull procedure: references/forge-goal.md; objective command/observation plus expected-result acceptance criteria, with no source edits.
spark - Spark Runtime GoalFull procedure: references/spark-goal.md; copyable runtime goal sentence, validation checklist, non-goals, next instruction, and no source edits.
ulw-loop - ULW LoopFull procedure: references/ulw-loop.md; source_edit_allowed: true; github_write_allowed: false; ULW_LOOP_DONE.
ulw-plan - ULW PlanFull procedure: references/ulw-plan.md; source_edit_allowed: false; ULW_PLAN_DONE.
ulw-research - ULW ResearchFull procedure: references/ulw-research.md; source_edit_allowed: false; ULW_RESEARCH_DONE.
gjc-plan / gjc-execute / gjc-team - Gajae-Code DelegationFull 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.
check - Local Diff CheckRun a read-only local diff review. Capture base freshness, status, diff stat, ignored/local-only/generated paths, and findings. Use references/local-diff-check.md for details.
Full procedure: references/wiki-bridge.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. Delegate to dedicated /setwiki for approval-gated write workflow. Require explicit approval before wiki mutation; do not inline iCloud/QMD mechanics.
Normal finish pipeline: local validation, publish evidence when requested, fresh adversarial review, triage, accepted Critical/High fixes, revalidation, and top-level review comment when formal approval is inappropriate. Return gate_result, blocking_summary, next_action, and lane_completion_state.
Pitfalls: stale repo, missing comments, hallucinated deps, force-push loops, test-pass completion, review in implementation worktree, local-only staging, over-fixing Medium findings, Markdown routing/fence loss, unrendered frontend approval, analytics without privacy lists.
Per-subcommand completion signals come from each command contract's output_contract.completion_signal and are listed below 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.
| Subcommand | Completion signal |
|---|---|
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 |
Stop when source edits fall outside the routed subcommand, a lane needs files outside its allowed list, a hard blocker would force an unauthorized topology, validation mutates unexpectedly, release/publish automation lacks explicit confirmation, state contradicts live git/GitHub, base freshness cannot be established, the issue is fundamentally thin, or the target is ignored/local-only/repo-external and cannot be represented safely in PR workflow.
The following compact contract keeps hot-path guardrails operational while detailed procedure moves to references/templates/scripts. Each item is a required review or routing concept, not a standalone checklist to satisfy mechanically: