agent-hive 0.1.0

package/dist/github/issues.js

@@ -0,0 +1,115 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { GithubError } from '../core/errors.js';
+const execFileAsync = promisify(execFile);
+const IssueLabel = {
+    Backlog: 'backlog',
+    InProgress: 'in-progress',
+    Blocked: 'blocked',
+};
+export { IssueLabel };
+async function gh(config, args) {
+    const { stdout } = await execFileAsync('gh', args, {
+        cwd: config.targetRepo,
+        env: { ...process.env },
+    });
+    return stdout.trim();
+}
+async function findCreatedIssue(config, title) {
+    const listOutput = await gh(config, [
+        'issue',
+        'list',
+        '--repo',
+        config.github.repo,
+        '--search',
+        title,
+        '--json',
+        'number,title,state,labels,url',
+        '--limit',
+        '1',
+    ]);
+    const issues = JSON.parse(listOutput);
+    const issue = issues[0];
+    if (!issue) {
+        throw new GithubError(`Failed to find created issue: ${title}`);
+    }
+    return {
+        number: issue.number,
+        title: issue.title,
+        state: issue.state,
+        labels: issue.labels.map((l) => l.name),
+        url: issue.url,
+    };
+}
+export async function getIssue(config, issueRef) {
+    const output = await gh(config, [
+        'issue',
+        'view',
+        issueRef,
+        '--repo',
+        config.github.repo,
+        '--json',
+        'number,title,state,labels,url,body',
+    ]);
+    const data = JSON.parse(output);
+    return {
+        number: data.number,
+        title: data.title,
+        state: data.state,
+        labels: data.labels.map((l) => l.name),
+        url: data.url,
+        body: data.body,
+    };
+}
+export async function createIssue(config, options) {
+    const args = [
+        'issue',
+        'create',
+        '--repo',
+        config.github.repo,
+        '--title',
+        options.title,
+        '--body',
+        options.body,
+    ];
+    if (options.labels?.length) {
+        args.push('--label', options.labels.join(','));
+    }
+    await gh(config, args);
+    return findCreatedIssue(config, options.title);
+}
+export async function updateLabel(config, issueNumber, label) {
+    const labelsToRemove = Object.values(IssueLabel).filter((l) => l !== label);
+    for (const removeLabel of labelsToRemove) {
+        await gh(config, [
+            'issue',
+            'edit',
+            String(issueNumber),
+            '--repo',
+            config.github.repo,
+            '--remove-label',
+            removeLabel,
+        ]).catch(() => { });
+    }
+    await gh(config, [
+        'issue',
+        'edit',
+        String(issueNumber),
+        '--repo',
+        config.github.repo,
+        '--add-label',
+        label,
+    ]);
+}
+export async function closeIssue(config, issueNumber) {
+    await gh(config, [
+        'issue',
+        'close',
+        String(issueNumber),
+        '--repo',
+        config.github.repo,
+        '--reason',
+        'completed',
+    ]);
+}
+//# sourceMappingURL=issues.js.map

package/dist/github/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/github/issues.ts"],"names":[],"mappings":"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"}

package/dist/github/pr.d.ts

@@ -0,0 +1,24 @@
+import type { ColonyConfig } from '../config.js';
+export interface PrInfo {
+    number: number;
+    title: string;
+    state: 'open' | 'merged' | 'closed';
+    branch: string;
+    url: string;
+}
+export interface PrComment {
+    id: number;
+    body: string;
+    author: string;
+    createdAt: string;
+}
+export declare function createPr(config: ColonyConfig, options: {
+    title: string;
+    body: string;
+    base?: string;
+    head: string;
+}): Promise<PrInfo>;
+export declare function getPrStatus(config: ColonyConfig, prNumber: number): Promise<PrInfo>;
+export declare function addPrComment(config: ColonyConfig, prNumber: number, body: string): Promise<void>;
+export declare function getPrComments(config: ColonyConfig, prNumber: number): Promise<PrComment[]>;
+//# sourceMappingURL=pr.d.ts.map

package/dist/github/pr.js

@@ -0,0 +1,92 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+async function gh(config, args) {
+    const { stdout } = await execFileAsync('gh', args, {
+        cwd: config.targetRepo,
+        env: { ...process.env },
+    });
+    return stdout.trim();
+}
+function buildCreatePrArgs(repo, baseBranch, options) {
+    return [
+        'pr',
+        'create',
+        '--repo',
+        repo,
+        '--title',
+        options.title,
+        '--body',
+        options.body,
+        '--head',
+        options.head,
+        '--base',
+        options.base ?? baseBranch,
+        '--json',
+        'number,title,state,headRefName,url',
+    ];
+}
+export async function createPr(config, options) {
+    const args = buildCreatePrArgs(config.github.repo, config.github.baseBranch, options);
+    const output = await gh(config, args);
+    const data = JSON.parse(output);
+    return {
+        number: data.number,
+        title: data.title,
+        state: data.state,
+        branch: data.headRefName,
+        url: data.url,
+    };
+}
+export async function getPrStatus(config, prNumber) {
+    const output = await gh(config, [
+        'pr',
+        'view',
+        String(prNumber),
+        '--repo',
+        config.github.repo,
+        '--json',
+        'number,title,state,headRefName,url',
+    ]);
+    const data = JSON.parse(output);
+    return {
+        number: data.number,
+        title: data.title,
+        state: data.state,
+        branch: data.headRefName,
+        url: data.url,
+    };
+}
+export async function addPrComment(config, prNumber, body) {
+    await gh(config, [
+        'pr',
+        'comment',
+        String(prNumber),
+        '--repo',
+        config.github.repo,
+        '--body',
+        body,
+    ]);
+}
+export async function getPrComments(config, prNumber) {
+    const output = await gh(config, [
+        'api',
+        `repos/${config.github.repo}/issues/${prNumber}/comments`,
+        '--jq',
+        '.[].id, .[].body, .[].user.login, .[].created_at',
+    ]);
+    if (!output)
+        return [];
+    const rawOutput = await gh(config, [
+        'api',
+        `repos/${config.github.repo}/issues/${prNumber}/comments`,
+    ]);
+    const data = JSON.parse(rawOutput);
+    return data.map((c) => ({
+        id: c.id,
+        body: c.body,
+        author: c.user.login,
+        createdAt: c.created_at,
+    }));
+}
+//# sourceMappingURL=pr.js.map

package/dist/github/pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../../src/github/pr.ts"],"names":[],"mappings":"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"}

package/dist/obsidian/session-log.d.ts

@@ -0,0 +1,14 @@
+import type { ColonyConfig } from '../config.js';
+export interface SessionLogOptions {
+    role: 'worker' | 'reviewer';
+    branch: string;
+    issueNumber?: number;
+    prNumber?: number;
+}
+export declare function createLog(config: ColonyConfig, options: SessionLogOptions): Promise<string>;
+export declare function append(logPath: string, content: string): Promise<void>;
+export declare function appendDecision(logPath: string, decision: string): Promise<void>;
+export declare function appendSotCandidate(logPath: string, content: string): Promise<void>;
+export declare function appendBlocker(logPath: string, reason: string, issueNumber: number): Promise<void>;
+export declare function closeSummary(logPath: string, summary: string): Promise<void>;
+//# sourceMappingURL=session-log.d.ts.map

package/dist/obsidian/session-log.js

@@ -0,0 +1,62 @@
+import { mkdir, appendFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { ObsidianError } from '../core/errors.js';
+function formatDate(date) {
+    return date.toISOString().slice(0, 10);
+}
+function buildLogPath(config, options) {
+    const sanitizedBranch = options.branch.replace(/\//g, '-');
+    return path.join(config.obsidian.vaultPath, 'sessions', `${options.role}-${sanitizedBranch}-${formatDate(new Date())}.md`);
+}
+export async function createLog(config, options) {
+    if (!config.obsidian) {
+        throw new ObsidianError('Obsidian is not enabled');
+    }
+    const logPath = buildLogPath(config, options);
+    const sessionsDir = path.dirname(logPath);
+    await mkdir(sessionsDir, { recursive: true });
+    const lines = [
+        `# ${options.role} 세션 기록서`,
+        '',
+        `- **브랜치**: ${options.branch}`,
+        `- **시작 시각**: ${new Date().toISOString()}`,
+    ];
+    if (options.issueNumber) {
+        lines.push(`- **관련 Issue**: #${options.issueNumber}`);
+    }
+    if (options.prNumber) {
+        lines.push(`- **관련 PR**: #${options.prNumber}`);
+    }
+    lines.push('', '---', '');
+    await writeFile(logPath, lines.join('\n'), 'utf-8');
+    return logPath;
+}
+export async function append(logPath, content) {
+    const timestamp = new Date().toISOString().slice(11, 19);
+    const line = `- \`${timestamp}\` ${content}\n`;
+    await appendFile(logPath, line, 'utf-8');
+}
+export async function appendDecision(logPath, decision) {
+    await append(logPath, `**[DECISION]** ${decision}`);
+}
+export async function appendSotCandidate(logPath, content) {
+    await append(logPath, `**[SSoT]** ${content}`);
+}
+export async function appendBlocker(logPath, reason, issueNumber) {
+    await append(logPath, `**[BLOCKER]** ${reason} (Issue #${issueNumber})`);
+}
+export async function closeSummary(logPath, summary) {
+    const closing = [
+        '',
+        '---',
+        '',
+        '## 세션 종료 요약',
+        '',
+        summary,
+        '',
+        `> 종료 시각: ${new Date().toISOString()}`,
+        '',
+    ].join('\n');
+    await appendFile(logPath, closing, 'utf-8');
+}
+//# sourceMappingURL=session-log.js.map

package/dist/obsidian/session-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.js","sourceRoot":"","sources":["../../src/obsidian/session-log.ts"],"names":[],"mappings":"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"}

package/dist/obsidian/sot-sync.d.ts

@@ -0,0 +1,11 @@
+import type { ColonyConfig } from '../config.js';
+export interface SotEntry {
+    content: string;
+    source: string;
+    timestamp: string;
+}
+export declare function extractSotCandidates(logContent: string): string[];
+export declare function syncToClaudeMd(config: ColonyConfig, entries: SotEntry[]): Promise<void>;
+export declare function syncToSpec(config: ColonyConfig, topic: string, content: string): Promise<void>;
+export declare function promoteFromSessionLog(config: ColonyConfig, logPath: string): Promise<SotEntry[]>;
+//# sourceMappingURL=sot-sync.d.ts.map

package/dist/obsidian/sot-sync.js

@@ -0,0 +1,72 @@
+import { readFile, appendFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+const SSOT_TAG = '[SSoT]';
+const DECISION_TAG = '[DECISION]';
+function extractTaggedLines(content, tag) {
+    return content
+        .split('\n')
+        .filter((line) => line.includes(tag))
+        .map((line) => line.replace(new RegExp(`\\*\\*\\${tag}\\*\\*\\s*`, 'g'), '').trim())
+        .map((line) => line.replace(/^-\s*`\d{2}:\d{2}:\d{2}`\s*/, ''));
+}
+export function extractSotCandidates(logContent) {
+    const ssotLines = extractTaggedLines(logContent, SSOT_TAG);
+    const decisionLines = extractTaggedLines(logContent, DECISION_TAG);
+    return [...ssotLines, ...decisionLines];
+}
+export async function syncToClaudeMd(config, entries) {
+    if (!config.obsidian || entries.length === 0)
+        return;
+    const claudeMdPath = path.join(config.obsidian.vaultPath, 'context', 'CLAUDE.md');
+    const existing = await readFile(claudeMdPath, 'utf-8').catch(() => '');
+    const newSection = [
+        '',
+        `### 업데이트 (${new Date().toISOString().slice(0, 10)})`,
+        '',
+        ...entries.map((e) => `- ${e.content} _(출처: ${e.source})_`),
+        '',
+    ].join('\n');
+    await appendFile(claudeMdPath, newSection, 'utf-8');
+}
+export async function syncToSpec(config, topic, content) {
+    if (!config.obsidian)
+        return;
+    const specDir = path.join(config.obsidian.vaultPath, 'spec');
+    await mkdir(specDir, { recursive: true });
+    const sanitizedTopic = topic.replace(/[^a-zA-Z0-9가-힣\-_]/g, '-').toLowerCase();
+    const specPath = path.join(specDir, `${sanitizedTopic}.md`);
+    const existing = await readFile(specPath, 'utf-8').catch(() => '');
+    if (existing) {
+        const update = [
+            '',
+            `---`,
+            '',
+            `## 업데이트 (${new Date().toISOString().slice(0, 10)})`,
+            '',
+            content,
+            '',
+        ].join('\n');
+        await appendFile(specPath, update, 'utf-8');
+    }
+    else {
+        const newDoc = [`# ${topic}`, '', content, ''].join('\n');
+        await writeFile(specPath, newDoc, 'utf-8');
+    }
+}
+export async function promoteFromSessionLog(config, logPath) {
+    if (!config.obsidian)
+        return [];
+    const logContent = await readFile(logPath, 'utf-8');
+    const candidates = extractSotCandidates(logContent);
+    if (candidates.length === 0)
+        return [];
+    const source = path.basename(logPath);
+    const entries = candidates.map((content) => ({
+        content,
+        source,
+        timestamp: new Date().toISOString(),
+    }));
+    await syncToClaudeMd(config, entries);
+    return entries;
+}
+//# sourceMappingURL=sot-sync.js.map

package/dist/obsidian/sot-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sot-sync.js","sourceRoot":"","sources":["../../src/obsidian/sot-sync.ts"],"names":[],"mappings":"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"}

package/dist/obsidian/vault-init.d.ts

@@ -0,0 +1,3 @@
+import type { ColonyConfig } from '../config.js';
+export declare function initVault(config: ColonyConfig): Promise<void>;
+//# sourceMappingURL=vault-init.d.ts.map

package/dist/obsidian/vault-init.js

@@ -0,0 +1,44 @@
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import path from 'node:path';
+const VAULT_DIRS = ['spec', 'context', 'sessions'];
+const DEFAULT_CLAUDE_MD = `# 프로젝트 컨벤션 및 패턴
+
+> 이 문서는 SSoT (Single Source of Truth)입니다.
+> 세션이 발견한 중요 결정사항이 여기에 승격됩니다.
+
+---
+
+## 코드 컨벤션
+
+(프로젝트 초기화 후 자동으로 채워집니다)
+
+## 아키텍처 결정사항
+
+(세션 작업 중 중요 결정사항이 승격되면 여기에 추가됩니다)
+
+## 반복 패턴
+
+(세션이 발견한 반복 패턴이 여기에 기록됩니다)
+`;
+async function exists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function initVault(config) {
+    if (!config.obsidian)
+        return;
+    const vaultPath = config.obsidian.vaultPath;
+    for (const dir of VAULT_DIRS) {
+        await mkdir(path.join(vaultPath, dir), { recursive: true });
+    }
+    const claudeMdPath = path.join(vaultPath, 'context', 'CLAUDE.md');
+    if (!(await exists(claudeMdPath))) {
+        await writeFile(claudeMdPath, DEFAULT_CLAUDE_MD, 'utf-8');
+    }
+}
+//# sourceMappingURL=vault-init.js.map

package/dist/obsidian/vault-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-init.js","sourceRoot":"","sources":["../../src/obsidian/vault-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAE5D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;CAkBzB,CAAC;AAEF,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAoB;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO;IAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,CAAC,YAAY,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/prompts/lead.md

@@ -0,0 +1,57 @@
+# Colony Lead Session
+
+> 이 프롬프트는 `claude-colony get` 실행 시 리드 세션에 주입됩니다.
+
+---
+
+## 컨텍스트
+
+- **레포지토리**: {repo}
+- **로컬 경로**: {target-repo}
+- **베이스 브랜치**: {base-branch}
+- **이슈 번호**: #{issue-number}
+- **이슈 제목**: {issue-title}
+
+### 이슈 내용
+
+{issue-body}
+
+---
+
+## 지시사항
+
+당신은 개발 Colony의 리드입니다. Agent Team을 생성하여 이슈를 해결하세요.
+
+### 1. 팀 생성
+
+다음 두 명의 팀원으로 Agent Team을 생성하세요:
+
+- **Worker (B)**: 코드 구현 담당
+- **Reviewer (A)**: 코드 리뷰 담당
+
+### 2. Worker (B) 규칙
+
+{worker-rules}
+
+### 3. Reviewer (A) 규칙
+
+{reviewer-rules}
+
+### 4. 핑퐁 프로토콜
+
+1. B가 `{base-branch}` 기반으로 feature 브랜치를 생성합니다.
+2. B가 이슈를 구현하고 PR을 생성합니다 (`closes #{issue-number}` 포함).
+3. B가 A에게 메시지: "PR 생성 완료. 리뷰 부탁드립니다."
+4. A가 PR diff를 검토하고 리뷰합니다.
+5. 문제 발견 시: A가 B에게 피드백 메시지 → B가 수정 → B가 A에게 재리뷰 요청 → 반복
+6. 문제 없을 시: A가 PR 승인 코멘트 작성 → B에게 종료 메시지
+
+### 5. 종료 조건
+
+- A가 승인하면 A 세션 종료
+- B가 승인 메시지를 받으면 최종 요약을 출력하고 B 세션 종료
+- 최종 요약에는 PR 번호, 수정사항, 리뷰 라운드 수를 포함
+
+### 6. Obsidian Vault (선택)
+
+{vault-section}

package/dist/prompts/reviewer.md

@@ -0,0 +1,67 @@
+# 리뷰어 세션 규칙
+
+> 이 규칙은 Agent Team의 Reviewer 팀원에게 주입됩니다.
+
+---
+
+## 리뷰 시작 시
+
+1. **컨텍스트 로드**
+   - 프로젝트의 CLAUDE.md 또는 컨벤션 문서를 읽고 패턴을 숙지한다.
+
+2. **PR 전체 diff 검토**
+   - Worker로부터 메시지를 받으면 해당 PR의 전체 diff를 검토한다.
+   - 변경된 파일 목록과 변경량을 파악한다.
+
+---
+
+## 리뷰 중
+
+더 이상 문제를 발견하지 못할 때까지 아래 과정을 반복한다.
+
+1. **검토 우선순위**
+   - 다음 순서로 검토한다:
+     1. **코드 품질** — 가독성, 구조, 컨벤션 준수
+     2. **버그** — 로직 오류, 엣지 케이스 누락
+     3. **보안** — 인젝션, 인증/인가, 민감 정보 노출
+     4. **성능** — 불필요한 연산, N+1 쿼리, 메모리 누수
+
+2. **발견된 이슈 분류**
+   - **현재 PR 스코프 (수정 필요)**: Worker에게 메시지로 수정 요청한다. 구체적 근거와 수정 예시를 포함한다.
+   - **별도 스코프 (이 PR과 무관)**: GitHub Issue를 분리 등록한다 (라벨: `backlog`). 현재 PR을 블로킹하지 않는다.
+   - **블로커급 (심각한 문제)**: GitHub Issue를 등록하고 (라벨: `blocked`), Worker에게 블로킹 사유를 명시한다.
+
+3. **수정 요청 시**
+   - 반드시 구체적인 근거를 제시한다.
+   - "X 때문에 Y 문제가 발생하므로 Z로 변경해야 합니다" 형태로 작성한다.
+   - 가능하면 수정 코드 예시를 함께 제공한다.
+
+4. **Worker 수정 후 재리뷰**
+   - Worker로부터 "수정 완료" 메시지를 받으면 변경된 부분을 다시 검토한다.
+   - 이전에 요청한 수정 사항이 반영되었는지 확인한다.
+   - 새로운 문제가 없는지 전체 diff를 재검토한다.
+   - 문제가 남아있으면 다시 피드백 → Worker 수정 → 재리뷰를 반복한다.
+
+---
+
+## 승인 조건
+
+모든 조건이 충족되면 승인한다:
+
+1. **수정 요청 전부 반영됨**
+2. **크리티컬 이슈 부재** (보안 취약점, 데이터 유실, 심각한 버그 없음)
+3. **더 이상 발견된 문제 없음**
+
+---
+
+## 승인 시
+
+1. **PR 승인 코멘트 작성**
+   - 리뷰 요약 (총 라운드 수, 발견한 이슈 수, 수정 반영 확인)
+   - 별도 Issue로 분리한 항목 목록
+   - 유저에게 최종 머지 판단 요청
+
+2. **Worker에게 종료 메시지**
+   - "승인합니다. 세션을 종료하세요."
+
+3. **세션 종료**

package/dist/prompts/worker.md

@@ -0,0 +1,68 @@
+# 워커 세션 규칙
+
+> 이 규칙은 Agent Team의 Worker 팀원에게 주입됩니다.
+
+---
+
+## 작업 시작 시
+
+1. **컨텍스트 로드**
+   - 프로젝트의 CLAUDE.md 또는 컨벤션 문서를 읽고 패턴을 숙지한다.
+   - 이슈 내용을 분석하고 작업 계획을 세운다.
+
+2. **브랜치 생성**
+   - 베이스 브랜치에서 feature 브랜치를 생성한다.
+   - 브랜치명: `feat/{issue-number}-{간단한-설명}` 또는 `fix/{issue-number}-{간단한-설명}`
+
+---
+
+## 작업 중
+
+1. **코드 구현**
+   - 이슈 요구사항에 따라 코드를 작성한다.
+   - 프로젝트 컨벤션을 준수한다.
+
+2. **블로커 발생 시**
+   - GitHub Issue를 등록한다 (라벨: `blocked`).
+   - Reviewer에게 메시지로 블로커 사유를 알린다.
+
+3. **스코프 외 작업 발견 시**
+   - GitHub Issue를 분리 등록한다 (라벨: `backlog`).
+   - 현재 작업을 계속 진행한다.
+
+---
+
+## PR 생성 시
+
+1. **PR 본문 작성**
+   - `closes #{issue-number}`를 포함한다.
+   - 주요 변경사항과 결정 근거를 명시한다.
+
+2. **Reviewer 호출**
+   - PR 생성 후 Reviewer에게 메시지를 보낸다: "PR #{pr-number} 생성 완료. 리뷰 부탁드립니다."
+
+---
+
+## 리뷰 피드백 수신 시
+
+Reviewer로부터 메시지를 받으면:
+
+1. **피드백 분석**
+   - 수정 요청 사항을 파악한다.
+
+2. **이슈 분류**
+   - **현재 PR 스코프**: 바로 수정한다.
+   - **별도 스코프**: GitHub Issue를 분리 등록한다 (라벨: `backlog`). 근거와 함께 Reviewer에게 알린다.
+   - **블로커급**: GitHub Issue를 등록하고 (라벨: `blocked`), Reviewer에게 블로킹 사유를 알린다.
+
+3. **수정 및 재푸시**
+   - 코드를 수정하고 커밋 → 푸시한다.
+   - Reviewer에게 메시지: "수정 완료했습니다. 재리뷰 부탁드립니다."
+
+---
+
+## 세션 종료
+
+- Reviewer로부터 승인 메시지를 받으면:
+  1. 총 수정사항을 간단히 정리한다.
+  2. 세션을 종료한다.