@silbaram/artifact-driven-agent 0.1.0

package/examples/todo-app/artifacts/backlog.md

@@ -0,0 +1,23 @@
+# Backlog
+
+> DONE: 5개
+
+## ~~TASK-001: 데이터 모델~~ ✅
+- 상태: DONE
+- 크기: S
+
+## ~~TASK-002: 추가 기능~~ ✅
+- 상태: DONE
+- 크기: M
+
+## ~~TASK-003: 삭제 기능~~ ✅
+- 상태: DONE
+- 크기: S
+
+## ~~TASK-004: 완료 토글~~ ✅
+- 상태: DONE
+- 크기: S
+
+## ~~TASK-005: 필터~~ ✅
+- 상태: DONE
+- 크기: M

package/examples/todo-app/artifacts/plan.md

@@ -0,0 +1,23 @@
+# Todo App 기획서
+
+> 상태: Confirmed | 버전: v1.0
+
+## ✅ 체크리스트
+
+- [x] 서비스 개요 작성
+- [x] 기능 목록 정의
+- [x] 비기능 요구사항 정의
+
+## 서비스 개요
+
+- **무엇**: 웹 기반 Todo 리스트
+- **누가**: 개인 사용자
+- **왜**: 간단한 할 일 관리
+
+## 기능 목록
+
+| ID | 기능명 | 우선순위 |
+|----|--------|:--------:|
+| F001 | Task CRUD | P0 |
+| F002 | 완료 표시 | P0 |
+| F003 | 필터링 | P1 |

package/examples/todo-app/artifacts/project.md

@@ -0,0 +1,23 @@
+# Project Standards (Frozen)
+
+> 🔒 Frozen 상태
+
+## ✅ 체크리스트
+
+- [x] 기술 스택 결정
+- [x] 프로젝트 구조 정의
+
+## 프로젝트 규모
+
+| 항목 | 값 |
+|------|-----|
+| 규모 | S |
+| 복잡도 | 낮음 |
+
+## 기술 스택
+
+| 영역 | 선택 | 버전 |
+|------|------|------|
+| 언어 | JavaScript | ES2022 |
+| 번들러 | Vite | 5.0.10 |
+| 테스트 | Vitest | 1.1.0 |

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@silbaram/artifact-driven-agent",
+  "version": "0.1.0",
+  "description": "CLI 기반 멀티 AI 에이전트 개발 프레임워크 - AI가 규칙을 어기지 못하게 하는 문서 기반 개발",
+  "type": "module",
+  "bin": {
+    "ada": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "core",
+    "templates",
+    "docs",
+    "examples",
+    "ai-dev-team"
+  ],
+  "scripts": {
+    "test": "node --test src/**/*.test.js",
+    "lint": "echo 'No linter configured'"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "development",
+    "framework",
+    "artifact",
+    "multi-agent",
+    "claude",
+    "codex",
+    "automation"
+  ],
+  "author": "silbaram <silbaram79@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/silbaram/artifact-driven-agent"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.15"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/interactive.js

@@ -0,0 +1,101 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { setup } from './setup.js';
+import { run } from './run.js';
+import {
+  isWorkspaceSetup,
+  getAvailableRoles,
+  getAvailableTools,
+  getAvailableTemplates
+} from '../utils/files.js';
+
+export async function interactive() {
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.cyan.bold('🤖 Artifact-Driven AI Agent'));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log('');
+
+  // 세팅되지 않은 경우
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.yellow('⚠️  프로젝트가 세팅되지 않았습니다.'));
+    console.log('');
+
+    const answer = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'doSetup',
+        message: '지금 세팅하시겠습니까?',
+        default: true
+      }
+    ]);
+
+    if (answer.doSetup) {
+      await setup();
+    } else {
+      console.log(chalk.gray('나중에 `ada setup`으로 세팅할 수 있습니다.'));
+      return;
+    }
+  }
+
+  // 역할 선택
+  const roles = getAvailableRoles();
+  const tools = getAvailableTools();
+
+  if (roles.length === 0) {
+    console.log(chalk.red('❌ 사용 가능한 역할이 없습니다.'));
+    console.log(chalk.gray('`ada setup`으로 다시 세팅하세요.'));
+    return;
+  }
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'role',
+      message: '역할을 선택하세요:',
+      choices: roles.map(r => ({
+        name: getRoleDescription(r),
+        value: r
+      }))
+    },
+    {
+      type: 'list',
+      name: 'tool',
+      message: 'AI 도구를 선택하세요:',
+      choices: tools.map(t => ({
+        name: getToolDescription(t),
+        value: t
+      }))
+    }
+  ]);
+
+  await run(answers.role, answers.tool);
+}
+
+function getRoleDescription(role) {
+  const descriptions = {
+    planner: 'planner      - 요구사항 수집, Task 분해',
+    architect: 'architect    - 규모 예측, 기술 스택 결정',
+    developer: 'developer    - 코드 구현 (범용)',
+    reviewer: 'reviewer     - 코드 리뷰',
+    qa: 'qa           - 수용 조건 검증',
+    manager: 'manager      - 스프린트 관리, 승인',
+    backend: 'backend      - API 설계, 서버 구현',
+    frontend: 'frontend     - UI 구현, API 연동',
+    'library-developer': 'library-dev  - 공개 API 설계, 버전 관리',
+    'game-logic': 'game-logic   - 게임 시스템 설계',
+    rendering: 'rendering    - 화면/이펙트 구현',
+    'cli-developer': 'cli-dev      - 명령어 설계, 출력 형식'
+  };
+  return descriptions[role] || role;
+}
+
+function getToolDescription(tool) {
+  const descriptions = {
+    claude: 'Claude       - Anthropic Claude CLI',
+    codex: 'Codex        - OpenAI Codex CLI',
+    gemini: 'Gemini       - Google Gemini CLI',
+    copilot: 'Copilot      - GitHub Copilot CLI'
+  };
+  return descriptions[tool] || tool;
+}

package/src/commands/logs.js

@@ -0,0 +1,81 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { getLogsDir, getSessionsDir, isWorkspaceSetup } from '../utils/files.js';
+
+export async function logs(sessionId) {
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.red('❌ 먼저 setup을 실행하세요.'));
+    process.exit(1);
+  }
+
+  const logsDir = getLogsDir();
+  const sessionsDir = getSessionsDir();
+
+  // 세션 ID가 없으면 가장 최근 세션 찾기
+  if (!sessionId) {
+    if (fs.existsSync(sessionsDir)) {
+      const sessions = fs.readdirSync(sessionsDir)
+        .filter(f => fs.statSync(path.join(sessionsDir, f)).isDirectory())
+        .sort()
+        .reverse();
+      
+      if (sessions.length > 0) {
+        sessionId = sessions[0];
+      }
+    }
+  }
+
+  if (!sessionId) {
+    console.log(chalk.yellow('⚠️  세션 기록이 없습니다.'));
+    return;
+  }
+
+  const logFile = path.join(logsDir, `${sessionId}.log`);
+
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log(chalk.cyan.bold(`📄 로그: ${sessionId}`));
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log('');
+
+  if (!fs.existsSync(logFile)) {
+    console.log(chalk.gray('  로그 파일 없음'));
+    console.log('');
+    
+    // 세션 정보라도 표시
+    const sessionFile = path.join(sessionsDir, sessionId, 'session.json');
+    if (fs.existsSync(sessionFile)) {
+      try {
+        const session = JSON.parse(fs.readFileSync(sessionFile, 'utf-8'));
+        console.log(chalk.white.bold('  세션 정보:'));
+        console.log(chalk.gray(`    역할: ${session.role || '-'}`));
+        console.log(chalk.gray(`    도구: ${session.tool || '-'}`));
+        console.log(chalk.gray(`    템플릿: ${session.template || '-'}`));
+        console.log(chalk.gray(`    시작: ${session.started_at || '-'}`));
+        console.log(chalk.gray(`    상태: ${session.status || '-'}`));
+        console.log('');
+      } catch (e) {
+        // ignore
+      }
+    }
+    return;
+  }
+
+  const content = fs.readFileSync(logFile, 'utf-8');
+  const lines = content.split('\n');
+
+  for (const line of lines) {
+    if (line.includes('[ERROR]')) {
+      console.log(chalk.red(line));
+    } else if (line.includes('[WARN]')) {
+      console.log(chalk.yellow(line));
+    } else if (line.includes('[INFO]')) {
+      console.log(chalk.gray(line));
+    } else {
+      console.log(line);
+    }
+  }
+
+  console.log('');
+}

package/src/commands/reset.js

@@ -0,0 +1,66 @@
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { getWorkspaceDir, isWorkspaceSetup } from '../utils/files.js';
+
+export async function reset(options = {}) {
+  const workspace = getWorkspaceDir();
+
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.yellow('⚠️  이미 초기화 상태입니다.'));
+    return;
+  }
+
+  // 확인
+  if (!options.force) {
+    const answer = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm',
+        message: chalk.red('ai-dev-team 디렉토리를 초기화하시겠습니까? (모든 작업 내용이 삭제됩니다)'),
+        default: false
+      }
+    ]);
+
+    if (!answer.confirm) {
+      console.log(chalk.gray('취소되었습니다.'));
+      return;
+    }
+  }
+
+  console.log('');
+  console.log(chalk.yellow('🗑️  초기화 중...'));
+
+  // roles, artifacts, rules 내용 삭제 (.gitkeep 유지)
+  const dirs = ['roles', 'artifacts', 'rules'];
+  
+  for (const dir of dirs) {
+    const dirPath = `${workspace}/${dir}`;
+    if (fs.existsSync(dirPath)) {
+      const files = fs.readdirSync(dirPath);
+      for (const file of files) {
+        if (file !== '.gitkeep') {
+          fs.removeSync(`${dirPath}/${file}`);
+        }
+      }
+    }
+  }
+
+  // .current-template 삭제
+  const templateFile = `${workspace}/.current-template`;
+  if (fs.existsSync(templateFile)) {
+    fs.removeSync(templateFile);
+  }
+
+  // .sessions 삭제
+  const sessionsDir = `${workspace}/.sessions`;
+  if (fs.existsSync(sessionsDir)) {
+    fs.removeSync(sessionsDir);
+  }
+
+  console.log(chalk.green('✅ 초기화 완료'));
+  console.log('');
+  console.log(chalk.gray('다시 세팅하려면:'));
+  console.log(chalk.white('  ada setup'));
+  console.log('');
+}

package/src/commands/run.js

@@ -0,0 +1,202 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { spawn } from 'child_process';
+import chalk from 'chalk';
+import {
+  getWorkspaceDir,
+  getSessionsDir,
+  getLogsDir,
+  getCurrentTemplate,
+  getAvailableRoles,
+  generateSessionId,
+  getTimestamp,
+  isWorkspaceSetup
+} from '../utils/files.js';
+
+export async function run(role, tool) {
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.red('❌ 먼저 setup을 실행하세요.'));
+    console.log(chalk.gray('  ada setup'));
+    process.exit(1);
+  }
+
+  const roles = getAvailableRoles();
+  const tools = ['claude', 'codex', 'gemini', 'copilot'];
+
+  // 역할 검증
+  if (!roles.includes(role)) {
+    console.log(chalk.red(`❌ 알 수 없는 역할: ${role}`));
+    console.log(chalk.gray(`사용 가능: ${roles.join(', ')}`));
+    process.exit(1);
+  }
+
+  // 도구 검증
+  if (!tools.includes(tool)) {
+    console.log(chalk.red(`❌ 알 수 없는 도구: ${tool}`));
+    console.log(chalk.gray(`사용 가능: ${tools.join(', ')}`));
+    process.exit(1);
+  }
+
+  const workspace = getWorkspaceDir();
+  const template = getCurrentTemplate();
+  const sessionId = generateSessionId();
+  const sessionsDir = getSessionsDir();
+  const logsDir = getLogsDir();
+
+  // 세션 디렉토리 생성
+  const sessionDir = path.join(sessionsDir, sessionId);
+  fs.ensureDirSync(sessionDir);
+  fs.ensureDirSync(logsDir);
+
+  // 세션 정보 저장
+  const sessionInfo = {
+    session_id: sessionId,
+    role: role,
+    tool: tool,
+    template: template,
+    started_at: getTimestamp(),
+    status: 'active'
+  };
+  fs.writeFileSync(path.join(sessionDir, 'session.json'), JSON.stringify(sessionInfo, null, 2));
+
+  // 로그 파일 초기화
+  const logFile = path.join(logsDir, `${sessionId}.log`);
+  const logMessage = (level, msg) => {
+    const line = `[${getTimestamp()}] [${level}] ${msg}\n`;
+    fs.appendFileSync(logFile, line);
+  };
+
+  logMessage('INFO', `세션 시작: role=${role}, tool=${tool}, template=${template}`);
+
+  // 역할 파일 경로
+  const roleFile = path.join(workspace, 'roles', `${role}.md`);
+  const roleContent = fs.readFileSync(roleFile, 'utf-8');
+
+  // 시스템 프롬프트 생성
+  const systemPrompt = buildSystemPrompt(workspace, role, roleContent);
+
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log(chalk.cyan.bold('🚀 AI 에이전트 실행'));
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log('');
+  console.log(chalk.white(`  세션 ID:  ${chalk.yellow(sessionId)}`));
+  console.log(chalk.white(`  템플릿:   ${chalk.green(template)}`));
+  console.log(chalk.white(`  역할:     ${chalk.green(role)}`));
+  console.log(chalk.white(`  도구:     ${chalk.green(tool)}`));
+  console.log(chalk.white(`  작업공간: ${chalk.gray('ai-dev-team/')}`));
+  console.log(chalk.white(`  로그:     ${chalk.gray(`logs/${sessionId}.log`)}`));
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log('');
+
+  // 도구별 실행
+  try {
+    await launchTool(tool, systemPrompt, logMessage);
+    
+    // 세션 완료 처리
+    sessionInfo.status = 'completed';
+    sessionInfo.ended_at = getTimestamp();
+    fs.writeFileSync(path.join(sessionDir, 'session.json'), JSON.stringify(sessionInfo, null, 2));
+    logMessage('INFO', '세션 종료');
+  } catch (error) {
+    sessionInfo.status = 'error';
+    sessionInfo.error = error.message;
+    fs.writeFileSync(path.join(sessionDir, 'session.json'), JSON.stringify(sessionInfo, null, 2));
+    logMessage('ERROR', error.message);
+    throw error;
+  }
+}
+
+function buildSystemPrompt(workspace, role, roleContent) {
+  const artifactsDir = path.join(workspace, 'artifacts');
+  const rulesDir = path.join(workspace, 'rules');
+  
+  let prompt = `# Role: ${role}\n\n`;
+  prompt += roleContent;
+  prompt += '\n\n---\n\n';
+  prompt += '# 참조 문서\n\n';
+
+  // 산출물 목록
+  if (fs.existsSync(artifactsDir)) {
+    const artifacts = fs.readdirSync(artifactsDir).filter(f => f.endsWith('.md'));
+    prompt += '## 산출물 (artifacts/)\n';
+    artifacts.forEach(a => {
+      prompt += `- ${a}\n`;
+    });
+    prompt += '\n';
+  }
+
+  // 규칙 목록
+  if (fs.existsSync(rulesDir)) {
+    const rules = fs.readdirSync(rulesDir).filter(f => f.endsWith('.md'));
+    prompt += '## 규칙 (rules/)\n';
+    rules.forEach(r => {
+      prompt += `- ${r}\n`;
+    });
+    prompt += '\n';
+  }
+
+  prompt += '---\n\n';
+  prompt += '위 역할과 규칙에 따라 작업을 수행하세요.\n';
+  prompt += '문서를 기준으로 판단하고, 문서에 없는 내용은 추측하지 마세요.\n';
+
+  return prompt;
+}
+
+async function launchTool(tool, systemPrompt, logMessage) {
+  const commands = {
+    claude: { cmd: 'claude', args: [] },
+    codex: { cmd: 'codex', args: [] },
+    gemini: { cmd: 'gemini', args: [] },
+    copilot: { cmd: 'gh', args: ['copilot', 'suggest'] }
+  };
+
+  const { cmd, args } = commands[tool];
+
+  // 도구 존재 확인
+  const which = spawn('which', [cmd], { shell: true });
+  
+  return new Promise((resolve, reject) => {
+    which.on('close', (code) => {
+      if (code !== 0) {
+        console.log(chalk.yellow(`⚠️  ${tool} CLI가 설치되어 있지 않습니다.`));
+        console.log('');
+        console.log(chalk.white('시스템 프롬프트를 출력합니다:'));
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(systemPrompt);
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log('');
+        console.log(chalk.gray('위 내용을 복사하여 AI 도구에 붙여넣으세요.'));
+        logMessage('WARN', `${tool} CLI not found, prompt displayed`);
+        resolve();
+        return;
+      }
+
+      // CLI 실행
+      console.log(chalk.green(`✓ ${tool} 실행 중...`));
+      logMessage('INFO', `${tool} CLI 실행`);
+
+      const child = spawn(cmd, args, {
+        stdio: 'inherit',
+        shell: true,
+        env: {
+          ...process.env,
+          ADA_SYSTEM_PROMPT: systemPrompt
+        }
+      });
+
+      child.on('close', (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`${tool} exited with code ${code}`));
+        }
+      });
+
+      child.on('error', (err) => {
+        reject(err);
+      });
+    });
+  });
+}

package/src/commands/sessions.js

@@ -0,0 +1,70 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { getSessionsDir, isWorkspaceSetup } from '../utils/files.js';
+
+export async function sessions() {
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.red('❌ 먼저 setup을 실행하세요.'));
+    process.exit(1);
+  }
+
+  const sessionsDir = getSessionsDir();
+
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log(chalk.cyan.bold('📋 세션 목록'));
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log('');
+
+  if (!fs.existsSync(sessionsDir)) {
+    console.log(chalk.gray('  세션 기록 없음'));
+    console.log('');
+    return;
+  }
+
+  const sessionDirs = fs.readdirSync(sessionsDir)
+    .filter(f => fs.statSync(path.join(sessionsDir, f)).isDirectory())
+    .sort()
+    .reverse();
+
+  if (sessionDirs.length === 0) {
+    console.log(chalk.gray('  세션 기록 없음'));
+    console.log('');
+    return;
+  }
+
+  // 헤더
+  console.log(chalk.gray('  세션 ID                      역할        도구      상태'));
+  console.log(chalk.gray('  ' + '─'.repeat(56)));
+
+  for (const sessionId of sessionDirs.slice(0, 20)) {
+    const sessionFile = path.join(sessionsDir, sessionId, 'session.json');
+    
+    if (fs.existsSync(sessionFile)) {
+      try {
+        const session = JSON.parse(fs.readFileSync(sessionFile, 'utf-8'));
+        const role = (session.role || '-').padEnd(10);
+        const tool = (session.tool || '-').padEnd(8);
+        const status = session.status || 'unknown';
+        
+        const statusColor = status === 'completed' ? chalk.green :
+                           status === 'active' ? chalk.yellow :
+                           chalk.gray;
+
+        console.log(`  ${sessionId}  ${role}  ${tool}  ${statusColor(status)}`);
+      } catch (e) {
+        console.log(`  ${sessionId}  ${chalk.gray('(읽기 실패)')}`);
+      }
+    } else {
+      console.log(`  ${sessionId}  ${chalk.gray('(정보 없음)')}`);
+    }
+  }
+
+  console.log('');
+  
+  if (sessionDirs.length > 20) {
+    console.log(chalk.gray(`  ... 그 외 ${sessionDirs.length - 20}개 세션`));
+    console.log('');
+  }
+}