AI-Augmented Development

AI와 함께
설계하고
구축합니다

단순히 코드를 생성하는 것을 넘어,
멀티 에이전트 오케스트레이션과 PDCA 워크플로우로
엔지니어링 전 과정을 AI와 함께 운영합니다.

0
Agents
0
Skills
0
Hooks
0
Categories
PDCA cycle PLAN DO CHECK ACT
// orchestration

멀티 에이전트 오케스트레이션

작업 규모에 따라 에이전트 팀 구성이 자동 결정됩니다.

User 👤 cto-lead 🧠 opus-4-6 security-architect opus · 보안 설계 gap-detector opus · 갭 검증 code-analyzer sonnet · 코드 분석 code-reviewer 🔍 교차 검증 Approved ✅ Match Rate ≥ 90% opus (판단) sonnet (실행)
// ouroboros

워크플로우 업그레이드

오픈소스 Ouroboros Agent OS에서 채택한 7개 패턴. 외부 CLI 없이 CLAUDE.md만으로 통합됩니다.

01 Ambiguity Score

코딩 전 모호성 수치화 게이트. Ambiguity ≤ 0.2 달성해야만 plan 진행.

02 Locked Seed

PDCA Plan 승인 후 핵심 결정을 LOCKED 마커로 고정. 변경 시 사용자 확인 필수.

03 Contrarian Check

QA 단계에서 구현의 핵심 가정을 역으로 검증. "반대가 맞다면?" 관점 강제 적용.

04 Stagnation Detection

iterate 간 출력 비교. 변화 없으면 retry 차감 없이 Unstuck으로 바로 이동.

05 Unstuck 5-Step

retry 3회 소진 후 Socratic·Contrarian·Simplifier·Researcher·Architect 5 Mind로 회복 시도.

06 Wonder / Reflect

/pdca iterate 구조화. Wonder(가설 발산) → Reflect(최적 가설 수렴) 순서 강제.

07 PAL Router

태스크 복잡도 기반 3-tier 모델 선택. Haiku(단순)·Sonnet(구현)·Opus(판단) 자동 배정.

// unstuck loop flow
retry 1 → retry 2 → retry 3 → stagnation? → [unstuck 5] → new dir? → user
// agents

에이전트 구성 38

카드를 클릭하면 에이전트 상세 정보를 확인할 수 있습니다.

// claude.md

AI 행동 규칙 설정

프로젝트별 CLAUDE.md로 AI의 동작 방식을 정밀하게 제어합니다.

CLAUDE.md
# SideProject — AI 운영 규칙
 
orchestrator:
  specialist_2_or_less: cto-lead
  specialist_3_plus: team-pool
 
model_assignment:
  cto_lead: "opus-4-6"
  security_architect: "opus-4-6"
  gap_detector: "opus-4-6"
  default: "sonnet-4-6"
 
quality_gate:
  match_rate_threshold: 90
  max_retry_loops: 3
 
hooks:
  - validate-commit
  - no-localstorage
  - task-qa-gate
01
오케스트레이터 자동 선택 specialist 2개 이하는 cto-lead 단독, 3개 이상은 팀 에이전트 풀 전체 활성화.
02
에이전트 모델 계층 고정 판단이 필요한 오케스트레이터만 opus, 실행 에이전트는 sonnet. 비용 최적화와 품질 균형.
03
PDCA 단계 게이트 강제 Phase 2.5 QA 시나리오 없이 구현 시작 금지. Plan 문서 없이 Design 진입 차단.
04
교차 검증 필수 구현한 에이전트가 자기 코드를 최종 승인하는 것 금지. 반드시 1차(code-reviewer) → 2차(cto-lead) 통과.
05
루프 차단 수정-재검증 최대 3회 초과 시 자동으로 사람에게 판단 요청. 무한 루프 방지.
06
코드 탐색 토큰 절약 Read/Grep 전에 qmd 인덱스(171개 파일) 우선 검색. 불필요한 컨텍스트 전송 차단.
// skills & hooks

설치된 스킬 & 훅 151+

카테고리 탭으로 필터링하세요. 훅은 Claude Code 이벤트 4종을 모두 커버합니다.

pdca pdca-batch plan-plus writing-plans executing-plans brainstorming ship-learn-next session-handoff commit-work finishing-a-development-branch verification-before-completion lesson-learned development-pipeline parallel-agents dispatching-parallel-agents subagent-driven-development agent-md-refactor claude-automation-recommender claude-code-learning codex codex-cli-runtime codex-result-handling gemini gpt-5-4-prompting prompt-engineering ai-visibility frontend-design frontend-slides frontend-query-mutation react-dev react-useeffect design-system-starter mui phase-3-mockup phase-5-design-system phase-6-ui-integration excalidraw draw-io mermaid-diagrams marp-slide code-review requesting-code-review receiving-code-review reducing-entropy systematic-debugging vulnerability-scanner security-guidance test-driven-development qa-scenario-gen qa-test-planner zero-script-qa btw broken-links deployment-patterns deployment-pipeline-design phase-4-api phase-7-seo-security phase-8-review phase-9-deployment rollback deploy using-git-worktrees diffs gitlab-ci-patterns bkit-rules bkit-templates control skill-create skill-creator skill-development skill-judge skill-status hook-development plugin-forge command-creator command-development changelog-gen crafting-effective-readmes content-creator content-strategy content-translation write-api-reference c4-architecture writing-clearly-and-concisely writing-rules writing-skills humanizer on-page-seo technical-seo seo-audit schema-markup internal-linking keyword-clustering content-brief domain-name-brainstormer meme-factory data-analyst vector-index-tuning postgres-patterns database-schema-designer phase-1-schema phase-2-convention openapi-to-typescript backend-to-frontend-handoff-docs frontend-to-backend-requirements bkend-auth bkend-data bkend-storage bkend-quickstart cloudflare 1password blucli jira datadog-cli mintlify perplexity things-mac feishu-perm sessions react-vendoring mcp-integration build-mcp-server build-mcp-app
Hooks (7) — 4 Event Types Covered
PreToolUse · Bash
validate-commit
git commit 시 Conventional Commits 형식 강제
PreToolUse · Bash
pre-push-qa
git push 전 테스트 통과 강제
PreToolUse · Write/Edit
no-localstorage
민감 데이터 localStorage 저장 차단
PreToolUse · Agent
subagent-verify
미등록 에이전트 실행 경고
PostToolUse · Agent
usage-tracker
opus/sonnet 사용량 자동 기록
Stop
task-qa-gate
QA 미검증 완료 선언 경고
UserPromptSubmit
auto-skill-trigger
사용자 메시지 분석 후 관련 스킬 자동 감지
// cost strategy

AI 비용 절감 전략

토큰 효율화와 모델 계층화로 비용 없이 품질을 유지합니다.

171
qmd 코드 인덱싱
171개 파일을 벡터 인덱스화. Read/Grep 대신 qmd 검색으로 컨텍스트 전송량 절감.
3:1
모델 계층 분리
판단 에이전트(opus) vs 실행 에이전트(sonnet) 분리. 오케스트레이터 3개만 opus 사용.
2
CLAUDE.md 계층화
SideProject 공통 규칙 + 프로젝트별 규칙 분리. 중복 컨텍스트 제거로 토큰 절약.
↓
.claudeignore 설정
node_modules, dist, .git 등 불필요 파일 컨텍스트 차단. 초기 로딩 토큰 최소화.
0
불필요 MCP 비활성화
Mintlify 등 미사용 MCP 서버 비활성화. 세션 시작 컨텍스트 크기 감소.
BG
Fire-and-Forget 패턴
비동기 작업은 응답 대기 없이 백그라운드 처리. 블로킹 없는 병렬 실행 구조.
// open source

Claude Agent Playbook

github.com / hwchany0ung
claude-agent-playbook
Claude Code 기반 멀티 에이전트 운영 노하우를 정리한 오픈소스 레포지토리.
CLAUDE.md 설계, 에이전트 구성, 훅 시스템, 비용 절감 전략을 공개합니다.
GitHub 바로가기
// stack

사용 AI 도구

⚡ Claude Code CLI 🔧 bkit v2.0.8 🔌 Claude API 🧠 claude-opus-4-6 ⚡ claude-sonnet-4-6