claude

project-init

v2.20.3 | 프로젝트 초기화 및 하네스 관리 플러그인. /project-init — docs/ 구조·제약 SSOT .claude/constraints.yaml(기계용 설정을 사용자 docs/ 와 분리, 구세대 docs/ 경로 폴백)·CLAUDE.md(한국어 응답 기본·compact 언어앵커)·에이전트(frontend/backend/deeplearning/llm-agent/infra/verifier — LLM 호출·eval 트랙 분리)·plan-gate 자동 세팅(명시 /approve-plan 승인, 승인 직후 TodoWrite 진행 추적 시딩(표시 전용 — gate 전이 무권한), 평문 토큰 정확일치 오발 방지, CLI 실패 안내 가시화(additionalContext 승격), todo.md TOCTOU 기준점 추적편집마다 재캡처(승인 오탐 제거·관측 밖 생성/변조만 탐지), advisory 무권한, 자가전이 ask 승격, 작은 미승인 편집 자동 롤오버·green-bash 검증명령만 수렴·큰편집(50줄/3파일) advisory, 하드 차단은 thrash 5회만), 위험명령·비밀읽기 가드(rm 접두래퍼·exfil·glob 우회 차단, 실사용 오탐 제거), 같은 경로 타 세션 활동 감지 환기(concurrent-session-check — 트랜스크립트 활동+프로세스 생존 2단 판정, 병렬 편집이면 worktree 권고, worktree 작업 위치 앵커 compact 재주입), 워크트리 병렬 세션 상태 분리(루트 해석 단일화 — 훅·CLI·update_docs 가 같은 작업 트리를 봄, thrash 연좌 차단 제거(target 파일 기준 판정), verifier 판정 보존·교차 집계 증거 기반 원본 fallback·중첩 managed 프로젝트 gate 는 세션 루트로 라우팅(split-brain 오스탬프 차단)), workspace-guard(워크스페이스 밖 파괴 명령 — 상위·형제 디렉토리 rm/mv/find -delete/truncate — 사용자 확인 ask 승격, 변수 타겟 fail-closed, 시스템 임시 트리 예외), verifier 실행 grounding 강제(전 항목 static ✅ → ❌ 강등), 데이터 변환 무결성(입력·변환 형상 불변량 — 타입 추론 왜곡·행 손실/폭증·조인 cardinality 실측, verifier 데이터 도메인 정적 통과 금지·code-style 라이브러리 무관 원칙), 실패 루프 가드(PostToolUseFailure 멀티스키마)·layer-2 스코프 스윕 실패이벤트 배선, 슬래시 명령 fallback(scope/subplan/status), 자동승인 신호 프로젝트 스코프+TTL, 멀티서비스 docker-compose 골격, 호스트 오염 방지·런타임 환경 호환 preflight. /harness-update — 하네스 최신화(placeholder 재주입 금지·중단 자가복구). /harness-uninstall — 문서 보존 하네스 제거. /plan-gate-help — plan-gate 상황별 커맨드 안내(조회 시 로드). /monitor [시간] — 학습·배치 작업 자동 간격 모니터링.

0 on GitHubby HunminKimv2.20.3updated 3 months agodevelopment
/

Plugin project-init from marketplace hunminkim in HunminKim/claude. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (5)

  • harness-uninstall

    project-init 이 설치한 하네스(훅·에이전트·plan-gate 런타임·git hooks)를 프로젝트에서 제거한다. CLAUDE.md·docs 등 문서는 유지한다. "/harness-uninstall", "하네스 제거", "하네스 언인스톨", "훅 다 지워줘", "plan-gate 완전히 제거" 등의 요청에 이 스킬을 사용한다.

  • harness-update

    기존 project-init 하네스를 최신 버전으로 업데이트한다. 에이전트·훅·워크플로우 규칙을 갱신하면서 사용자 데이터(CLAUDE.md, lessons.md, docs/)는 보존한다. "/harness-update", "하네스 업데이트", "에이전트 업데이트", "훅 최신화", "verifier 업데이트", "하네스 최신 버전으로" 등의 요청에 이 스킬을 사용한다.

  • monitor

    학습·배치 작업 진행 상황을 자동 계산된 간격으로 표 형식 보고. "/monitor 2h", "/monitor 30m training", "모니터링 시작 2시간", "학습 모니터링 10h" 등으로 호출. 총 소요 시간을 받아 체크 간격을 자동 계산 (total/10, 하한 1분·상한 60분). 프리셋은 .claude/monitor_presets.yaml로 관리.

  • plan-gate-help

    plan-gate 상황별로 어떤 슬래시 커맨드를 써야 하는지 안내한다. verifier ✅/❌ 후 처리, plan-gate 차단·thrash 차단 시 대응, 계획 승인 흐름, 공식 Plan Mode 연동, 스코프 강제(shadow/enforce/off), 켜기/끄기, 전체 커맨드 요약표를 담는다. "plan-gate 커맨드 뭐 써?", "verifier ❌면 뭐 해야 해", "게이트 차단됐는데", "스코프 강제 어떻게", "approve/done/retry/skip/rollback 언제 쓰나", "커맨드 요약" 등 plan-gate

  • project-init

    프로젝트 초기화 스킬 — 새 프로젝트를 시작할 때 docs/ 폴더 구조 생성, CLAUDE.md 작성, 개발 원칙 세팅을 한 번에 처리한다. "/project-init", "프로젝트 초기화", "프로젝트 시작", "init project", "프로젝트 세팅해줘", "개발 환경 초기화", "프로젝트 구조 잡아줘" 등의 요청에 반드시 이 스킬을 사용한다. 단순한 파일 생성 요청이더라도 프로젝트 시작 맥락이라면 이 스킬을 사용한다.

Slash commands (18)

  • /project-init:approve-plan

    tasks/todo.md 계획을 승인하고 plan-gate를 연다 (gate → approved).

  • /project-init:approve

    /approve-plan 의 짧은 별칭. tasks/todo.md 계획을 승인하고 plan-gate를 연다.

  • /project-init:done

    작업을 완료로 마감한다. 체크포인트를 정리하고 gate를 종료한다.

  • /project-init:keep

    /skip 의 별칭. verifier ❌ 후 현재 변경을 보존하며 gate를 마감한다.

  • /project-init:plan-gate-no-git

    plan-gate 체크포인트를 git(프라이빗 ref 스냅샷) 대신 cp 파일 스냅샷으로 전환한다. .claude/plan_gate_no_git 파일을 생성한다.

  • /project-init:plan-gate-off

    plan-gate를 비활성화한다. .claude/plan_gate_enabled 파일을 삭제한다.

  • /project-init:plan-gate-on

    plan-gate를 활성화한다. .claude/plan_gate_enabled 파일을 생성한다.

  • /project-init:plan-gate-scope-enforce

    plan-gate 스코프 강제를 enforce 로 켠다. 스코프 밖 Edit 은 거부되고, Bash 가 만든 스코프 밖 변경은 체크포인트로 롤백된다. .claude/plan_gate_scope 파일에 enforce 를 기록한다.

  • /project-init:plan-gate-scope-off

    plan-gate 스코프 강제를 완전히 끈다(환기조차 없음). 매니페스트는 기록만 하고 스코프 위반을 차단·롤백·환기하지 않는다. .claude/plan_gate_scope 파일에 'off' 를 기록한다(기본값은 shadow 이므로 명시 off).

  • /project-init:plan-gate-scope-shadow

    plan-gate 스코프 강제를 shadow 로 켠다. 스코프 위반을 감지·기록만 하고 차단·롤백은 하지 않는다(롤아웃 관찰용). .claude/plan_gate_scope 파일에 shadow 를 기록한다.

  • /project-init:plan-gate-use-git

    plan-gate 체크포인트를 git(프라이빗 ref 스냅샷) 백엔드로 되돌린다. .claude/plan_gate_no_git 파일을 삭제한다.

  • /project-init:replan

    계획을 재작성한다. 편집 카운터를 리셋하고 체크포인트는 유지한다.

  • /project-init:retry

    verifier ❌ 후 같은 체크포인트에서 재구현을 시작한다 (approved 복귀).

  • /project-init:rollback

    체크포인트 스냅샷에서 되돌린다 (존재 파일 복구·신규 파일 삭제, 실패 시 git reflog 안내).

  • /project-init:skip-verify

    verifier 판정 전, 검증 없이 gate를 마감한다 (⏭️ 기록. 판정 후엔 사용 불가).

  • /project-init:skip

    verifier ❌ 후 현재 변경을 보존하며 gate를 마감한다 (/keep 동일).

  • /project-init:status

    현재 plan-gate 상태를 조회한다. gate id, state, edit 횟수, 체크포인트 정보를 출력한다.

  • /project-init:subplan

    승인된 plan-gate 스코프에 파일 패턴을 audit 남기며 추가한다(확장 escape-hatch). enforce 중 예상 밖 인접 파일을 전면 /replan 없이 진행해야 할 때 Claude/사용자가 호출한다. do-not-touch 는 확장으로도 허용되지 않는다.

Hooks (22)

  • PreToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/dangerous_bash_check.py

  • PreToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/dependency_lock_check.py

  • PreToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/secret_read_guard.py

  • PreToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate.py

  • PreToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/delegation_prompt_check.py

  • PostToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/update_docs.py

  • PostToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_summary_request.py

  • PostToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/detect_failure_loop.py

  • PostToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate_bash.py

  • PostToolUse

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/verifier_remind.py

  • PostToolUseFailure

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/detect_failure_loop.py

  • PostToolUseFailure

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate_bash.py

  • UserPromptSubmit

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/detect_bug_report.py

  • UserPromptSubmit

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/detect_user_correction.py

  • UserPromptSubmit

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_approval.py

  • UserPromptSubmit

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/detect_task_boundary.py

  • UserPromptSubmit

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/delegation_due_diligence.py

  • SessionEnd

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate_gc.py

  • SessionStart

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate_session_start.py

  • SessionStart

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/concurrent_session_check.py

  • Stop

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/plan_gate_stop_alert.py

  • PermissionRequest

    python3 ${CLAUDE_PLUGIN_ROOT}/hooks/project_init_permission.py

View source on GitHub

More from HunminKim/claude

All 3 plugins →

v1.2.0 | 사용자 prompt 원문 전체(자동 마스킹 후) + 도구 호출 통계를 동의한 프로젝트에서만 jsonl로 누적(멀티세션 격리·병렬 락·flush dead-letter). /project-init 통합 동의, /del_prompt_log 로 로그 이동·동의 재확인.

1 skill · 1 command · hooks

0

v1.0.2 | 개발 중간에 에이전트 제어 인프라(훅, verifier, 문서 자동화) 상태를 독립 서브에이전트가 진단하고, 문제 발견 시 upstream 수정 레포트를 생성하는 하네스 점검 스킬

1 skill

0

Similar plugins

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

Build powerful, stateful CLI interfaces for any GUI application using the cli-anything harness methodology.

5 commands

HKUDS/CLI-Anything 58,665

Automates browser interactions for web testing, form filling, screenshots, and data extraction

12 skills

vercel-labs/agent-browser 50,373

Use Alibaba Open Code Review from local Codex.

2 skills

alibaba/open-code-review 50,068

slidev

claude

Claude Code skill for creating and presenting Slidev slidedecks

1 skill

slidevjs/slidev 49,452

Maintain project-init?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins3 plugins