{"id":51609173,"url":"https://github.com/idean3885/claude-ops-agent","last_synced_at":"2026-07-12T05:02:00.947Z","repository":{"id":337656110,"uuid":"1154572720","full_name":"idean3885/claude-ops-agent","owner":"idean3885","description":"이슈·멀티레포 플로우, 콘텐츠 작성·검증, 규칙 자동 적용을 묶은 개인용 Claude Code 플러그인","archived":false,"fork":false,"pushed_at":"2026-07-08T08:29:08.000Z","size":418,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-08T10:11:28.069Z","etag":null,"topics":["ai-workflow","claude-code","claude-code-plugin","developer-experience"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/idean3885.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-10T14:42:27.000Z","updated_at":"2026-07-08T08:29:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/idean3885/claude-ops-agent","commit_stats":null,"previous_names":["dykim-base-project/claude-devex","idean3885/claude-devex","idean3885/claude-ops-agent"],"tags_count":77,"template":true,"template_full_name":null,"purl":"pkg:github/idean3885/claude-ops-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idean3885%2Fclaude-ops-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idean3885%2Fclaude-ops-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idean3885%2Fclaude-ops-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idean3885%2Fclaude-ops-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/idean3885","download_url":"https://codeload.github.com/idean3885/claude-ops-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idean3885%2Fclaude-ops-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35382323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-12T02:00:06.386Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-workflow","claude-code","claude-code-plugin","developer-experience"],"created_at":"2026-07-12T05:02:00.121Z","updated_at":"2026-07-12T05:02:00.927Z","avatar_url":"https://github.com/idean3885.png","language":"Shell","funding_links":[],"categories":["Source Catalog"],"sub_categories":[],"readme":"# claude-ops-agent\n\n혼자 하는 개발과 글쓰기를 제 원칙대로 처리하는 개인 AI 작업 비서입니다. Claude Code 플러그인으로 구현했습니다.\n\nAI 에게 코드·문서를 맡기면 편하지만, 같은 요청에도 매번 다르게 답하고 어제 합의한 규칙을 오늘 잊습니다. 매번 사람이 교정하면 그 교정이 일이 됩니다. 그래서 일회성 프롬프트로 쓰는 대신, 제 판단과 규칙을 하네스에 심어 AI 가 매 세션 같은 원칙 위에서 시작하게 만들었습니다. 개발 워크플로우·글쓰기·검증을 이 비서에게 맡깁니다.\n\n## 왜 믿고 맡기나\n\n비서에게 일을 맡기려면 매번 같은 품질이 나와야 합니다. 그래서 네 가지를 넣었습니다.\n\n- **출력 가드레일**: AI 특유의 표현·과장·번역투를 규칙으로 잡아내고 문서 편집마다 자가 점검을 겁니다.\n- **세션 간 일관성**: 규칙을 세션 시작에 자동으로 걸어 매번 같은 상태에서 작업을 시작합니다.\n- **사람 승인 게이트**: 플랜·커밋·머지를 사람이 확인한 뒤 진행합니다. 자동화하되 판단은 사람이 쥡니다.\n- **쌓이는 규칙**: 작성 규칙·AI 티 분류·의사결정 기록이 자산으로 남아 비서가 제 방식으로 수렴합니다.\n\n구현은 Claude Code 의 hook·스킬·SSOT 미러링으로 했고 왜 이렇게 만들었는지는 [docs/design-philosophy.md](docs/design-philosophy.md) 에 적었습니다. 쌓인 규칙·지식을 재사용 자산으로 관리하는 PARA 구조는 다음 방향으로 준비 중입니다.\n\n- [AI에게 코드를 맡기고 나서 달라진 일하는 방식](https://idean3885.github.io/posts/ai-changed-my-workflow/): 이슈 플로우의 배경\n- [코드에서 사고로](https://idean3885.github.io/posts/from-coding-to-thinking/): 검증·사고 도구의 배경\n\n## 빠른 시작\n\n```bash\nclaude plugins marketplace add claude-ops-agent --source git --url https://github.com/idean3885/claude-ops-agent.git\nclaude plugins add ops-agent@claude-ops-agent --marketplace claude-ops-agent\n```\n\n스킬을 직접 호출하지 않아도 됩니다. 자연어로 요청하면 트리거 키워드로 자동 라우팅됩니다.\n\n## 1. 이슈·멀티레포 플로우\n\n```mermaid\ngraph LR\n    A[\"/issue\"] --\u003e B[\"/spec\"]\n    B --\u003e C[\"구현\"]\n    C --\u003e D[\"/commit\"]\n    D --\u003e E{추가 구현?}\n    E --\u003e|Yes| C\n    E --\u003e|No| F[\"/pr\"]\n```\n\n`flow` 하나가 git 상태를 감지해 현재 단계를 실행하고, 3개 게이트(플랜·커밋·머지)에서 사용자 승인을 받은 뒤 진행합니다.\n\n| 스킬 | 역할 | 트리거 |\n|------|------|--------|\n| `/flow` | 이슈 플로우 단일 진입점 (위 도식) | \"flow\", \"플로우\", 자연어 수정 요청 |\n| `/org-flow` | 멀티레포 오케스트레이션 + 사내/퍼블릭 provider 분기 | \"org-flow\", \"멀티레포\" |\n| `/setup` | provider 등록, 상태 확인, overlay 설정 | \"setup\", \"설정\" |\n\n- **org-flow**: 여러 레포에 걸친 변경에서 통일 브랜치명·레포별 provider·Git Identity·워크트리를 한 흐름으로 맞춥니다.\n- **provider 시스템**: 이슈 트래커별 동작을 추상화하고 SessionStart 훅이 git remote host 로 자동 감지합니다. provider별 Git Identity 를 커밋 전 자동 검증·수정해, 글로벌 git config 에 의존한 계정 오류를 막습니다.\n\n예를 들어 인증서 자동 갱신 기능은 서로 다른 두 도메인 서비스에 걸칩니다.\n\n```\nacme/                        # org = 현재 디렉토리\n├── cert-service/            # 인증서 발급·갱신 도메인\n└── notification-service/    # 갱신 결과 알림 도메인\n```\n\n이슈 #42 \"만료 임박 인증서 자동 갱신\"에서 cert-service 는 갱신 스케줄러와 발급 로직을, notification-service 는 갱신 완료·실패 알림을 맡습니다. `/org-flow \"#42 인증서 자동 갱신\"` 한 번이면 두 레포에 통일 브랜치(`feature/42`)로 워크트리를 격리 생성하고 레포별 provider·Git Identity 를 자동 분기한 뒤, 각 레포에서 `flow` 를 병렬로 진행합니다.\n\n## 2. 콘텐츠 작성·검증\n\n블로그·위키·이슈·PoC 등 한국어 문서를 작성하고 검증하는 흐름입니다.\n\n| 스킬 | 역할 | 트리거 |\n|------|------|--------|\n| `/content-write` | 범용 작성 엔진 (성격 파악·시리즈 구조·인라인 검증) | \"콘텐츠 작성\", \"글 작성\" |\n| `/content-verify` | 검증 (사실·구조·독립가치 + 가독성·톤·구두점·AI 티) | \"검증\", \"가독성 검사\" |\n| `/content-publish` | 발행 (수집 → 비평가 검토 → Jekyll 변환 → 커밋) | \"블로그 발행\", \"publish\" |\n| `/cross-verify` | 교차 검증 (의사결정·설계·문서·구현 4축) | \"교차 검증\" |\n| `/advisor` | 방향성 검토·조언 (소비 프로젝트 방향 프로파일 + PARA 골격) | \"어드바이저\", \"방향 검토\" |\n\n- **cross-verify**: 자동화가 아니라 개발자가 의도적으로 멈추고 확인하는 행위를 구조화한 것입니다. 도구가 측정 못 하는 의미적 판단에 집중합니다.\n- **advisor**: 엔진은 방향 렌즈와 방법론 골격(PARA)만 담고, 실제 방향·데이터는 소비 프로젝트가 자기 스코프에 채웁니다. 산출물을 선언된 방향·렌즈로 비판(review)하거나 성장 방향 대비 다음 액션을 조언(advise)합니다.\n- **스타일 룰(SSOT)**: 모든 한국어 문서에 적용되는 작성 단일 출처입니다. base(공통) + extensions(유형별) 구조로, SessionStart hook 이 `~/.claude/ops-agent/style-rules/` 로 미러링해 외부 소비자가 참조합니다.\n\n```\nconfig/style-rules/\n├── base/         # ai-tells · readability · tone · punctuation\n└── extensions/   # blog · wiki · poc · issue · dailylog · peer-review · work-review …\n```\n\n## 3. 규칙 자동 적용\n\n작성 원칙과 워크플로우 규칙을 세 시점에 겁니다. 시점마다 막는 실수가 다릅니다.\n\n| hook | 시점 | 동작 |\n|------|------|------|\n| `forbidden-words-prompt.sh` | UserPromptSubmit | 금지 표현 룰을 사전 주입 |\n| `forbidden-words-stop.sh` | Stop | 직전 응답 위반을 다음 턴에 통지 |\n| `content-verify-posttool.sh` | PostToolUse(Edit/Write) | 문서 편집 후 자가 점검 유도 (opt-in) |\n| `pre-tool-use.mjs` | PreToolUse | 퍼블릭 표면으로 가는 대외비 키워드 하드 차단 |\n\n표현 가드는 응답을 막거나 자동으로 고쳐 쓰지 않고, 사전 주입 + 사후 통지로 동작합니다. 출력 직전 자가 대조는 어시스턴트의 몫입니다. 룰 포맷·마커 스키마 등 설정 상세는 [docs/hooks-config.md](docs/hooks-config.md).\n\n## Usage Tracking\n\nticket 단위로 토큰·비용을 추적합니다. worktree-per-task 환경에서 정확히 분리됩니다. `/usage-start · checkpoint · snap · complete · report` 5종을 제공하며, 집계 원리는 [docs/usage-cwd-aggregation.md](docs/usage-cwd-aggregation.md) 를 참조하세요.\n\n## 로컬 개발\n\n변경은 워크트리에서 작업하고 PR 로 머지합니다. main 직접 push 는 하지 않습니다.\n\n```bash\ngit worktree add ../claude-ops-agent-{타입}-{번호} -b {타입}/{번호} origin/main\n./scripts/bump-version.sh \u003cversion\u003e \"\u003c변경 설명\u003e\"   # VERSION·CHANGELOG·plugin.json·marketplace.json 동시 갱신\n# 커밋 → 브랜치 push → PR → 웹 머지\n./scripts/post-merge-sync.sh                        # 머지 후 로컬 캐시 동기\n```\n\n## 요구사항\n\n- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)\n- [GitHub CLI](https://cli.github.com/) (`gh`)\n\n## 라이선스\n\nMIT. AI 티 분류는 [`epoko77-ai/im-not-ai`](https://github.com/epoko77-ai/im-not-ai)(MIT) 의 10대 분류 골격(A~J)·심각도(S1/S2/S3) 체계를 차용했고, 처방·예시·hook 매핑은 한국어 기술 문서 맥락으로 자체 작성했습니다.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidean3885%2Fclaude-ops-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fidean3885%2Fclaude-ops-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidean3885%2Fclaude-ops-agent/lists"}