@silbaram/artifact-driven-agent 0.1.7 → 0.2.3

package/dist/src/utils/promptBuilder.js

@@ -0,0 +1,726 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { parseTaskMetadata, normalizeTaskStatus } from './taskParser.js';
+// ============================================================================
+// 역할별 콘텐츠 설정 (제약 조건 유지가 핵심!)
+// ============================================================================
+/**
+ * 역할별 문서 포함 레벨 설정
+ *
+ * 제약 조건 원칙:
+ * 1. Developer는 project.md 전체 필요 (기술 제약)
+ * 2. Reviewer는 코드 리뷰를 위해 Task와 Interface 필요 (개발은 못함)
+ * 3. Planner는 plan.md 전체 필요 (요구사항 관리)
+ * 4. 모든 역할은 decision.md 전체 필요 (최우선 결정)
+ * 5. 현재 스프린트 meta.md는 항상 포함 (범위 제한)
+ */
+const ROLE_CONTENT_CONFIG = {
+    developer: {
+        plan: 'summary', // 현재 스프린트 관련 요약 (전체는 너무 김)
+        project: 'full', // 기술 기준 전체 필수 (제약!)
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'full', // 작업 중인 Task 전체 (현재 작업)
+            backlog: 'summary', // 제목 + 수용조건 (다음 작업 파악)
+            done: 'list', // 제목만 (완료된 건 상세 불필요)
+            reject: 'list', // 제목만
+            inReview: 'list', // 리뷰 중인 건 제목만
+        },
+        interface: 'full', // API/UI 문서 전체 (구현 기준)
+        rules: 'full', // 규칙 전체 (제약!)
+        skills: 'full', // 스킬 전체 (코딩 패턴)
+    },
+    reviewer: {
+        plan: 'summary', // 요구사항 요약 (리뷰 기준)
+        project: 'summary', // 코딩 규칙 섹션만 (리뷰 기준)
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'full', // 리뷰 대상 Task 전체
+            backlog: 'none', // 백로그는 리뷰 대상 아님
+            done: 'summary', // 최근 완료된 것 요약 (참고용)
+            reject: 'full', // 반려 사유 확인 필요
+            inReview: 'full', // 리뷰 중인 Task 전체
+        },
+        interface: 'full', // API 계약 확인 필요
+        rules: 'full', // 규칙 전체 (리뷰 기준!)
+        skills: 'summary', // 스킬 요약 (패턴 확인)
+    },
+    planner: {
+        plan: 'full', // 전체 요구사항 필수 (기획!)
+        project: 'summary', // 기술 스택 요약
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'list', // 진행 상황 파악
+            backlog: 'full', // 백로그 관리 (기획!)
+            done: 'list', // 완료 현황 파악
+            reject: 'summary', // 반려 사유 파악
+            inReview: 'list', // 리뷰 현황 파악
+        },
+        interface: 'list', // 인터페이스 목록만
+        rules: 'full', // 규칙 전체
+        skills: 'summary', // 스킬 안내 (Task 작성 패턴)
+    },
+    improver: {
+        plan: 'full', // 개선 대상 파악
+        project: 'summary', // 기술 스택 요약
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'summary', // 진행 중인 작업 파악
+            backlog: 'summary', // 개선 대상 파악
+            done: 'summary', // 완료된 기능 분석
+            reject: 'full', // 반려 사유 분석 (개선 포인트)
+            inReview: 'list',
+        },
+        interface: 'summary', // 인터페이스 요약
+        rules: 'full',
+        skills: 'summary', // 스킬 안내 (개선 Task 작성 패턴)
+    },
+    documenter: {
+        plan: 'summary', // 문서화할 기능 파악
+        project: 'summary', // 기술 스택 요약
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'list', // 진행 상황 파악
+            backlog: 'none', // 백로그 불필요
+            done: 'summary', // 문서화 대상 (완료된 기능)
+            reject: 'none',
+            inReview: 'list',
+        },
+        interface: 'full', // API 문서화 필요
+        rules: 'summary', // 규칙 요약
+        skills: 'none',
+    },
+    analyzer: {
+        plan: 'summary', // 분석 범위 파악
+        project: 'full', // 기술 스택 전체 분석
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'list',
+            backlog: 'list',
+            done: 'list',
+            reject: 'list',
+            inReview: 'list',
+        },
+        interface: 'full', // 인터페이스 분석
+        rules: 'full',
+        skills: 'none',
+    },
+    manager: {
+        plan: 'summary', // 프로젝트 현황 파악
+        project: 'summary', // 기술 스택 요약
+        decision: 'full', // 최우선 결정 필수
+        tasks: {
+            inDev: 'summary', // 진행 현황
+            backlog: 'summary', // 대기 현황
+            done: 'summary', // 완료 현황
+            reject: 'summary', // 이슈 파악
+            inReview: 'summary', // 리뷰 현황
+        },
+        interface: 'list',
+        rules: 'full',
+        skills: 'none',
+    },
+};
+/**
+ * 기본 콘텐츠 설정 (정의되지 않은 역할용)
+ */
+const DEFAULT_CONTENT_CONFIG = {
+    plan: 'summary',
+    project: 'summary',
+    decision: 'full',
+    tasks: {
+        inDev: 'summary',
+        backlog: 'summary',
+        done: 'list',
+        reject: 'list',
+        inReview: 'summary',
+    },
+    interface: 'summary',
+    rules: 'full',
+    skills: 'summary',
+};
+// ============================================================================
+// 역할별 규칙 (기존 유지 - 제약 조건!)
+// ============================================================================
+const ROLE_RULES = {
+    planner: ['iteration.md', 'escalation.md', 'document-priority.md'],
+    improver: ['iteration.md', 'escalation.md', 'document-priority.md', 'rfc.md'],
+    developer: ['iteration.md', 'escalation.md', 'rollback.md', 'document-priority.md', 'rfc.md'],
+    reviewer: ['iteration.md', 'rollback.md', 'escalation.md', 'document-priority.md'],
+    documenter: ['escalation.md', 'document-priority.md'],
+    analyzer: ['escalation.md', 'document-priority.md'],
+    manager: ['escalation.md', 'document-priority.md', 'rfc.md'],
+};
+// ============================================================================
+// 메인 함수
+// ============================================================================
+/**
+ * 최적화된 시스템 프롬프트 생성
+ */
+export function buildOptimizedSystemPrompt(workspace, role, roleContent) {
+    const artifactsDir = path.join(workspace, 'artifacts');
+    const rulesDir = path.join(workspace, 'rules');
+    const skillsDir = path.join(workspace, 'skills');
+    const config = ROLE_CONTENT_CONFIG[role] || DEFAULT_CONTENT_CONFIG;
+    const sections = [];
+    // ========================================
+    // 1. Role 정의 (항상 전체 - 제약 필수!)
+    // ========================================
+    sections.push(`# Role: ${role}\n\n${roleContent}`);
+    // ========================================
+    // 2. Rules (역할별 필수 규칙)
+    // ========================================
+    const rulesSection = buildRulesSection(rulesDir, role, config.rules);
+    if (rulesSection)
+        sections.push(rulesSection);
+    // ========================================
+    // 3. Skills (역할에 지정된 스킬)
+    // ========================================
+    const skillsSection = buildSkillsSection(skillsDir, role, config.skills);
+    if (skillsSection)
+        sections.push(skillsSection);
+    // ========================================
+    // 4. 핵심 산출물 (decision, project, plan)
+    // ========================================
+    const coreArtifactsSection = buildCoreArtifactsSection(artifactsDir, config);
+    if (coreArtifactsSection)
+        sections.push(coreArtifactsSection);
+    // ========================================
+    // 5. 현재 스프린트 정보 (항상 meta.md 포함!)
+    // ========================================
+    const sprintSection = buildSprintSection(artifactsDir, role, config.tasks);
+    if (sprintSection)
+        sections.push(sprintSection);
+    // ========================================
+    // 6. 인터페이스 문서
+    // ========================================
+    const interfaceSection = buildInterfaceSection(artifactsDir, config.interface);
+    if (interfaceSection)
+        sections.push(interfaceSection);
+    // ========================================
+    // 7. 기타 산출물 (항상 목록만)
+    // ========================================
+    const otherArtifactsSection = buildOtherArtifactsSection(artifactsDir);
+    if (otherArtifactsSection)
+        sections.push(otherArtifactsSection);
+    // ========================================
+    // 8. 작업 지침 (역할별 차별화)
+    // ========================================
+    const instructionsSection = buildInstructionsSection(role);
+    sections.push(instructionsSection);
+    return sections.join('\n\n---\n\n');
+}
+// ============================================================================
+// 섹션 빌더 함수들
+// ============================================================================
+/**
+ * Rules 섹션 생성
+ */
+function buildRulesSection(rulesDir, role, level) {
+    const requiredRules = ROLE_RULES[role] || [];
+    if (requiredRules.length === 0)
+        return null;
+    let section = '# 규칙 (Rules)\n\n';
+    section += `**이 역할의 필수 규칙:** ${requiredRules.join(', ')}\n\n`;
+    if (!fs.existsSync(rulesDir)) {
+        section += '(rules 디렉토리 없음)\n';
+        return section;
+    }
+    for (const ruleFile of requiredRules) {
+        const rulePath = path.join(rulesDir, ruleFile);
+        if (!fs.existsSync(rulePath)) {
+            section += `## ${ruleFile} (파일 없음)\n\n`;
+            continue;
+        }
+        try {
+            const content = fs.readFileSync(rulePath, 'utf-8');
+            section += `## ${ruleFile}\n\n`;
+            if (level === 'full') {
+                section += content + '\n';
+            }
+            else {
+                // summary: 첫 번째 섹션만 또는 요약
+                section += extractDocumentSummary(content, 30) + '\n';
+            }
+        }
+        catch {
+            section += `## ${ruleFile} (읽기 실패)\n\n`;
+        }
+    }
+    return section;
+}
+/**
+ * Skills 섹션 생성 (네이티브 방식 안내)
+ *
+ * 스킬은 각 AI 도구의 네이티브 경로에서 자동 로드됩니다:
+ * - Claude Code: .claude/skills/
+ * - Gemini CLI: .gemini/skills/
+ * - Codex: .agents/skills/
+ *
+ * `ada skills apply <name>` 명령으로 스킬을 네이티브 경로에 배포하세요.
+ */
+function buildSkillsSection(_skillsDir, _role, level) {
+    if (level === 'none')
+        return null;
+    // 네이티브 방식에서는 스킬 내용을 시스템 프롬프트에 포함하지 않음
+    // AI 도구가 자체 스킬 탐색 경로에서 자동으로 로드함
+    let section = '# 전문 스킬 (Specialized Skills)\n\n';
+    section += '스킬은 AI 도구의 네이티브 스킬 시스템으로 로드됩니다.\n\n';
+    section += '**스킬 탐색 경로:**\n';
+    section += '- Claude Code: `.claude/skills/`\n';
+    section += '- Gemini CLI: `.gemini/skills/`\n';
+    section += '- Codex: `.agents/skills/`\n\n';
+    section += '**중요:** 적용된 스킬의 패턴과 규칙을 정확히 따르세요.\n';
+    return section;
+}
+/**
+ * 핵심 산출물 섹션 생성 (decision, project, plan)
+ */
+function buildCoreArtifactsSection(artifactsDir, config) {
+    let section = '# 핵심 산출물 (Core Artifacts)\n\n';
+    // decision.md (항상 전체 - 최우선 문서)
+    section += buildArtifactContent(path.join(artifactsDir, 'decision.md'), 'decision.md', config.decision);
+    // project.md (역할별 차등)
+    section += buildArtifactContent(path.join(artifactsDir, 'project.md'), 'project.md', config.project, ['## 기술 스택', '## 코딩 규칙', '## 프로젝트 구조'] // summary용 섹션
+    );
+    // plan.md (역할별 차등)
+    section += buildArtifactContent(path.join(artifactsDir, 'plan.md'), 'plan.md', config.plan, ['## 핵심 요구사항', '## 현재 목표', '## 우선순위'] // summary용 섹션
+    );
+    return section;
+}
+/**
+ * 개별 산출물 콘텐츠 생성
+ */
+function buildArtifactContent(filePath, fileName, level, summarySections) {
+    if (level === 'none')
+        return '';
+    if (!fs.existsSync(filePath)) {
+        return `## ${fileName} (아직 작성되지 않음)\n\n`;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        let result = `## ${fileName}\n\n`;
+        if (level === 'full') {
+            result += content + '\n';
+        }
+        else if (level === 'summary') {
+            if (summarySections && summarySections.length > 0) {
+                result += extractSections(content, summarySections) + '\n';
+            }
+            else {
+                result += extractDocumentSummary(content, 50) + '\n';
+            }
+        }
+        else if (level === 'list') {
+            // 제목만 추출
+            const titleMatch = content.match(/^#\s+(.+)$/m);
+            const title = titleMatch ? titleMatch[1] : fileName;
+            result += `- ${title}\n`;
+            result += `  (전체 내용은 파일을 읽어서 확인: artifacts/${fileName})\n\n`;
+        }
+        return result;
+    }
+    catch {
+        return `## ${fileName} (읽기 실패)\n\n`;
+    }
+}
+/**
+ * 스프린트 섹션 생성 (핵심 최적화!)
+ */
+function buildSprintSection(artifactsDir, role, taskConfig) {
+    let section = '# 현재 스프린트 정보\n\n';
+    const sprintsDir = path.join(artifactsDir, 'sprints');
+    if (!fs.existsSync(sprintsDir)) {
+        section += '## ⚠️ sprints 디렉토리 없음\n\n';
+        section += '`ada sprint create` 명령으로 스프린트를 생성하세요.\n';
+        return section;
+    }
+    // 가장 최근 스프린트 찾기
+    const sprints = fs.readdirSync(sprintsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory() && /^sprint-\d+$/.test(d.name))
+        .map(d => d.name)
+        .sort((a, b) => parseInt(b.split('-')[1]) - parseInt(a.split('-')[1]));
+    const activeSprint = sprints[0];
+    if (!activeSprint) {
+        section += '## ⚠️ 현재 활성 스프린트 없음\n\n';
+        section += '`ada sprint create` 명령으로 스프린트를 생성하세요.\n';
+        return section;
+    }
+    // meta.md는 항상 전체 포함 (범위 제한 필수!)
+    const metaPath = path.join(sprintsDir, activeSprint, 'meta.md');
+    if (fs.existsSync(metaPath)) {
+        try {
+            const metaContent = fs.readFileSync(metaPath, 'utf-8');
+            section += `## 현재 스프린트: ${activeSprint}/meta.md\n\n`;
+            section += metaContent + '\n\n';
+        }
+        catch {
+            section += `## ${activeSprint}/meta.md (읽기 실패)\n\n`;
+        }
+    }
+    // Task 파일들 (상태별 차등 포함!)
+    const tasksDir = path.join(sprintsDir, activeSprint, 'tasks');
+    if (fs.existsSync(tasksDir)) {
+        const taskFiles = fs.readdirSync(tasksDir)
+            .filter(f => f.endsWith('.md') && !f.includes('template'));
+        if (taskFiles.length > 0) {
+            section += buildTasksContent(tasksDir, taskFiles, taskConfig);
+        }
+        else {
+            section += '## ⚠️ 스프린트에 Task 없음\n\n';
+            section += '`ada sprint add task-001` 명령으로 Task를 추가하세요.\n';
+        }
+    }
+    // Backlog 목록 (항상 목록만 - Planner만 상세 필요)
+    const backlogDir = path.join(artifactsDir, 'backlog');
+    if (fs.existsSync(backlogDir)) {
+        const backlogFiles = fs.readdirSync(backlogDir)
+            .filter(f => f.endsWith('.md') && f.startsWith('task-'));
+        if (backlogFiles.length > 0) {
+            section += '\n## Backlog Task 목록\n\n';
+            if (taskConfig.backlog === 'full') {
+                // Planner용: 백로그 전체 내용
+                for (const f of backlogFiles) {
+                    const taskPath = path.join(backlogDir, f);
+                    try {
+                        const content = fs.readFileSync(taskPath, 'utf-8');
+                        section += `### ${f}\n\n${content}\n\n`;
+                    }
+                    catch {
+                        section += `### ${f} (읽기 실패)\n\n`;
+                    }
+                }
+            }
+            else {
+                // 목록만
+                section += '필요시 파일을 읽어서 확인하세요:\n';
+                for (const f of backlogFiles) {
+                    section += `- backlog/${f}\n`;
+                }
+                section += '\n';
+            }
+        }
+    }
+    return section;
+}
+/**
+ * Task 콘텐츠 생성 (상태별 차등!)
+ */
+function buildTasksContent(tasksDir, taskFiles, config) {
+    // 상태별로 Task 분류
+    const tasksByStatus = {
+        IN_DEV: [],
+        IN_REVIEW: [],
+        BACKLOG: [],
+        DONE: [],
+        REJECT: [],
+        OTHER: [],
+    };
+    for (const file of taskFiles) {
+        const filePath = path.join(tasksDir, file);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const metadata = parseTaskMetadata(content, file);
+            const status = normalizeTaskStatus(metadata.status);
+            const category = tasksByStatus[status] ? status : 'OTHER';
+            tasksByStatus[category].push({ file, content, metadata });
+        }
+        catch {
+            tasksByStatus['OTHER'].push({
+                file,
+                content: '',
+                metadata: { id: file, title: file, status: 'UNKNOWN', priority: 'P2', size: 'M', assignee: '-', hasReviewReport: false }
+            });
+        }
+    }
+    let section = '## 현재 스프린트 Task\n\n';
+    // 상태별 콘텐츠 생성
+    section += buildTaskStatusSection('작업 중 (IN_DEV)', tasksByStatus['IN_DEV'], config.inDev);
+    section += buildTaskStatusSection('리뷰 중 (IN_REVIEW)', tasksByStatus['IN_REVIEW'], config.inReview);
+    section += buildTaskStatusSection('대기 (BACKLOG)', tasksByStatus['BACKLOG'], config.backlog);
+    section += buildTaskStatusSection('완료 (DONE)', tasksByStatus['DONE'], config.done);
+    section += buildTaskStatusSection('반려 (REJECT)', tasksByStatus['REJECT'], config.reject);
+    if (tasksByStatus['OTHER'].length > 0) {
+        section += buildTaskStatusSection('기타', tasksByStatus['OTHER'], 'list');
+    }
+    return section;
+}
+/**
+ * 상태별 Task 섹션 생성
+ */
+function buildTaskStatusSection(title, tasks, level) {
+    if (tasks.length === 0 || level === 'none')
+        return '';
+    let section = `### ${title} (${tasks.length}개)\n\n`;
+    for (const task of tasks) {
+        if (level === 'full') {
+            section += `#### ${task.file}\n\n`;
+            section += task.content + '\n\n';
+        }
+        else if (level === 'summary') {
+            section += `#### ${task.file}: ${task.metadata.title}\n\n`;
+            // 수용 조건 섹션만 추출
+            const acceptanceCriteria = extractSection(task.content, '## 수용 조건') ||
+                extractSection(task.content, '## Acceptance Criteria') ||
+                extractSection(task.content, '## 작업 내용');
+            if (acceptanceCriteria) {
+                section += acceptanceCriteria + '\n\n';
+            }
+            else {
+                section += extractDocumentSummary(task.content, 20) + '\n\n';
+            }
+        }
+        else if (level === 'list') {
+            section += `- **${task.file}**: ${task.metadata.title} [${task.metadata.status}]\n`;
+        }
+    }
+    if (level === 'list')
+        section += '\n';
+    return section;
+}
+/**
+ * 인터페이스 문서 섹션 생성
+ */
+function buildInterfaceSection(artifactsDir, level) {
+    if (level === 'none')
+        return null;
+    const interfaceFiles = [
+        'api.md', 'ui.md', 'public-api.md', 'commands.md',
+        'output-format.md', 'game-systems.md', 'assets.md',
+        'hud.md', 'examples.md', 'changelog.md'
+    ];
+    const existingFiles = [];
+    for (const file of interfaceFiles) {
+        if (fs.existsSync(path.join(artifactsDir, file))) {
+            existingFiles.push(file);
+        }
+    }
+    if (existingFiles.length === 0)
+        return null;
+    let section = '# 인터페이스 산출물 (Interface Artifacts)\n\n';
+    if (level === 'list') {
+        section += '다음 인터페이스 문서를 필요시 읽어서 확인하세요:\n';
+        for (const file of existingFiles) {
+            section += `- artifacts/${file}\n`;
+        }
+        return section;
+    }
+    for (const file of existingFiles) {
+        const filePath = path.join(artifactsDir, file);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            section += `## ${file}\n\n`;
+            if (level === 'full') {
+                section += content + '\n';
+            }
+            else {
+                section += extractDocumentSummary(content, 40) + '\n';
+            }
+        }
+        catch {
+            section += `## ${file} (읽기 실패)\n\n`;
+        }
+    }
+    return section;
+}
+/**
+ * 기타 산출물 섹션 (항상 목록만)
+ */
+function buildOtherArtifactsSection(artifactsDir) {
+    if (!fs.existsSync(artifactsDir))
+        return null;
+    const coreFiles = ['decision.md', 'project.md', 'plan.md'];
+    const interfaceFiles = [
+        'api.md', 'ui.md', 'public-api.md', 'commands.md',
+        'output-format.md', 'game-systems.md', 'assets.md',
+        'hud.md', 'examples.md', 'changelog.md'
+    ];
+    const excludeFiles = [...coreFiles, ...interfaceFiles];
+    const allFiles = fs.readdirSync(artifactsDir, { withFileTypes: true });
+    const otherFiles = allFiles
+        .filter(d => d.isFile() && d.name.endsWith('.md') && !excludeFiles.includes(d.name))
+        .map(d => d.name);
+    if (otherFiles.length === 0)
+        return null;
+    let section = '# 기타 산출물 (목록)\n\n';
+    section += '필요시 파일을 읽어서 확인하세요:\n';
+    for (const file of otherFiles) {
+        section += `- artifacts/${file}\n`;
+    }
+    // Features 디렉토리
+    const featuresDir = path.join(artifactsDir, 'features');
+    if (fs.existsSync(featuresDir)) {
+        const features = fs.readdirSync(featuresDir, { withFileTypes: true })
+            .filter(d => d.isDirectory() && !d.name.startsWith('_'))
+            .map(d => d.name);
+        if (features.length > 0) {
+            section += '\n**Features:**\n';
+            for (const f of features) {
+                section += `- features/${f}/\n`;
+            }
+        }
+    }
+    // RFC 디렉토리
+    const rfcDir = path.join(artifactsDir, 'rfc');
+    if (fs.existsSync(rfcDir)) {
+        const rfcs = fs.readdirSync(rfcDir).filter(f => f.endsWith('.md') && !f.includes('template'));
+        if (rfcs.length > 0) {
+            section += '\n**RFC:**\n';
+            for (const rfc of rfcs) {
+                section += `- rfc/${rfc}\n`;
+            }
+        }
+    }
+    return section;
+}
+/**
+ * 작업 지침 섹션 (역할별 차별화)
+ */
+function buildInstructionsSection(role) {
+    let section = '# 작업 지침\n\n';
+    // 공통 지침
+    section += '## 필수 준수 사항\n\n';
+    section += '- **문서 기준 판단**: 위에 포함된 문서 내용을 기준으로 판단\n';
+    section += '- **추측 금지**: 문서에 없는 내용은 사용자에게 에스컬레이션\n';
+    section += '- **규칙 준수**: 모든 규칙(Rules)을 반드시 따름\n';
+    section += '- **현재 범위**: 현재 스프린트 Task만 작업 (범위 초과 금지)\n';
+    section += '- **우선순위**: 문서 충돌 시 document-priority.md 따름\n\n';
+    // 의사결정 권한 (Manager 이외 역할에 대해 명시)
+    if (role !== 'manager') {
+        section += '## 의사결정 권한 제한 (CRITICAL)\n\n';
+        section += '- 스프린트 생성/종료/승인: **Manager(사용자)만 가능**\n';
+        section += '- Task 상태 전환 승인 (→ DONE): **Manager만 가능**\n';
+        section += '- decision.md 기록: **Manager만 가능**\n';
+        section += '- 최종 의사결정/승인: **Manager(사용자)만 가능**\n';
+        section += '- 당신의 역할: 분석/제안/실행만 가능, 결정/승인 권한 없음\n';
+        section += '- 결정이 필요한 상황: 사용자에게 에스컬레이션\n\n';
+    }
+    // 역할별 제약 명시
+    section += '## 역할별 제약 (CRITICAL)\n\n';
+    const roleConstraints = {
+        developer: [
+            '✅ 현재 스프린트의 IN_DEV Task만 구현',
+            '✅ project.md 기술 기준 절대 준수',
+            '✅ Interface 문서(api.md, ui.md) 계약 준수',
+            '❌ DONE/REJECT Task 수정 금지',
+            '❌ 스프린트 범위 외 작업 금지',
+            '❌ project.md에 없는 기술 추가 금지',
+            '❌ 기획 문서 작성 금지 (Planner 역할)',
+            '❌ 코드 리뷰 수행 금지 (Reviewer 역할)',
+            '❌ 아키텍처/기술 스택 결정 금지',
+        ],
+        reviewer: [
+            '✅ IN_DEV/IN_REVIEW Task 코드 리뷰',
+            '✅ project.md 코딩 규칙 기준으로 판정',
+            '✅ PASS/REJECT 판정 및 사유 기록',
+            '❌ 직접 코드 수정 금지 (리뷰만!)',
+            '❌ 기능 추가/변경 금지',
+            '❌ 범위 외 리뷰 금지',
+            '❌ 기획 작업 금지 (Planner 역할)',
+            '❌ 구현 작업 금지 (Developer 역할)',
+        ],
+        planner: [
+            '✅ 요구사항 수집 및 plan.md 작성',
+            '✅ backlog/ Task 생성 및 관리',
+            '✅ Task 우선순위/크기 산정',
+            '❌ 직접 코드 작성 금지 (절대 금지)',
+            '❌ 소스 파일 생성/수정 금지 (절대 금지)',
+            '❌ project.md 기술 결정 금지 (제안만)',
+            '❌ 스프린트 진행 중 Task 변경 금지',
+            '❌ 기술 스택 선택/아키텍처 결정 금지',
+            '❌ 개발 일정 추정 금지',
+        ],
+        improver: [
+            '✅ 기존 기능 개선점 분석',
+            '✅ improvement-reports/ 작성',
+            '✅ 개선 Task를 backlog/에 생성',
+            '❌ 직접 코드 수정/구현 금지 (절대 금지)',
+            '❌ 신규 기능 기획 금지 (Planner 역할)',
+            '❌ 코드 리뷰 수행 금지 (Reviewer 역할)',
+            '❌ 기술 스택 독단 결정 금지 (사용자 승인 필수)',
+            '❌ 다른 기능까지 확장 분석 금지 (범위 준수)',
+        ],
+        documenter: [
+            '✅ DONE Task 기반 문서 작성',
+            '✅ Release Notes, API Changelog 작성',
+            '✅ docs/ 디렉토리 문서 업데이트',
+            '❌ 코드 직접 수정 금지',
+            '❌ 미완료 Task 문서화 금지',
+            '❌ 존재하지 않는 기능 문서화 금지',
+            '❌ 빈 페이지 생성 금지 (내용 없으면 파일 만들지 않음)',
+            '❌ 추측으로 문서 작성 금지 (반드시 코드 확인 후)',
+            '❌ 개발/기획/리뷰 작업 금지 (다른 역할의 영역)',
+        ],
+        analyzer: [
+            '✅ 코드베이스 분석 및 project.md 역생성',
+            '✅ 기술 스택/패턴 파악',
+            '❌ 코드 수정/구현 금지 (절대 금지)',
+            '❌ 기존 코드 삭제/변경 금지 (절대 금지)',
+            '❌ 요구사항 정의 금지 (분석만)',
+            '❌ plan.md 작성 금지 (Planner 역할)',
+            '❌ backlog/ Task 파일 작성 금지 (Planner 역할)',
+            '❌ 분석 없이 가정으로 문서 작성 금지',
+        ],
+    };
+    const constraints = roleConstraints[role] || [
+        '✅ 역할에 정의된 책임만 수행',
+        '❌ 다른 역할의 책임 침범 금지',
+    ];
+    for (const constraint of constraints) {
+        section += `${constraint}\n`;
+    }
+    section += '\n## 멀티 세션 상태 관리\n\n';
+    section += '상태 공유: `ai-dev-team/.ada-status.json`\n';
+    section += '- Task 진행 상황 업데이트\n';
+    section += '- 질문은 pendingQuestions에 추가\n';
+    section += '- 알림은 notifications에 추가\n';
+    return section;
+}
+// ============================================================================
+// 유틸리티 함수
+// ============================================================================
+/**
+ * 문서에서 특정 섹션 추출 (## 제목 기준)
+ */
+function extractSection(content, sectionTitle) {
+    const escapedTitle = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex = new RegExp(`(${escapedTitle}[\\s\\S]*?)(?=\\n## |$)`, 'i');
+    const match = content.match(regex);
+    return match ? match[1].trim() : null;
+}
+/**
+ * 문서에서 여러 섹션 추출
+ */
+function extractSections(content, sectionTitles) {
+    const results = [];
+    for (const title of sectionTitles) {
+        const section = extractSection(content, title);
+        if (section) {
+            results.push(section);
+        }
+    }
+    if (results.length === 0) {
+        // 섹션을 찾지 못하면 요약 반환
+        return extractDocumentSummary(content, 30);
+    }
+    return results.join('\n\n');
+}
+/**
+ * 문서 요약 추출 (첫 N줄)
+ */
+function extractDocumentSummary(content, maxLines) {
+    const lines = content.split('\n');
+    const summaryLines = lines.slice(0, maxLines);
+    let summary = summaryLines.join('\n');
+    if (lines.length > maxLines) {
+        summary += `\n\n... (${lines.length - maxLines}줄 생략, 전체 내용은 파일 읽기)`;
+    }
+    return summary;
+}
+/**
+ * 콘텐츠 레벨 가져오기 (외부 사용)
+ */
+export function getRoleContentConfig(role) {
+    return ROLE_CONTENT_CONFIG[role] || DEFAULT_CONTENT_CONFIG;
+}
+//# sourceMappingURL=promptBuilder.js.map