@tienne/gestalt 0.5.0 → 0.6.0

package/dist/src/recording/recording-dir.d.ts

@@ -0,0 +1,5 @@
+export declare const RECORDINGS_BASE_DIR = ".gestalt/recordings";
+/** sessionId에 대한 .frames 파일 경로를 반환하고, 부모 디렉토리가 없으면 생성한다 */
+export declare function ensureRecordingsDir(): void;
+export declare function getFramesPath(sessionId: string): string;
+//# sourceMappingURL=recording-dir.d.ts.map

package/dist/src/recording/recording-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-dir.d.ts","sourceRoot":"","sources":["../../../src/recording/recording-dir.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,2DAA2D;AAC3D,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/src/recording/recording-dir.js

@@ -0,0 +1,13 @@
+import { mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const RECORDINGS_BASE_DIR = '.gestalt/recordings';
+/** sessionId에 대한 .frames 파일 경로를 반환하고, 부모 디렉토리가 없으면 생성한다 */
+export function ensureRecordingsDir() {
+    if (!existsSync(RECORDINGS_BASE_DIR)) {
+        mkdirSync(RECORDINGS_BASE_DIR, { recursive: true });
+    }
+}
+export function getFramesPath(sessionId) {
+    return join(RECORDINGS_BASE_DIR, `${sessionId}.frames`);
+}
+//# sourceMappingURL=recording-dir.js.map

package/dist/src/recording/recording-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-dir.js","sourceRoot":"","sources":["../../../src/recording/recording-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,IAAI,CAAC,mBAAmB,EAAE,GAAG,SAAS,SAAS,CAAC,CAAC;AAC1D,CAAC"}

package/dist/src/recording/resume-detector.d.ts

@@ -0,0 +1,10 @@
+export interface ResumeInfo {
+    isResuming: boolean;
+    framesPath: string;
+}
+/**
+ * sessionId에 해당하는 .frames 임시 파일이 존재하는지 확인한다.
+ * 존재하면 이전 녹화를 이어붙일 수 있음을 의미한다.
+ */
+export declare function detectResume(sessionId: string): ResumeInfo;
+//# sourceMappingURL=resume-detector.d.ts.map

package/dist/src/recording/resume-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-detector.d.ts","sourceRoot":"","sources":["../../../src/recording/resume-detector.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAM1D"}

package/dist/src/recording/resume-detector.js

@@ -0,0 +1,14 @@
+import { existsSync } from 'node:fs';
+import { getFramesPath } from './recording-dir.js';
+/**
+ * sessionId에 해당하는 .frames 임시 파일이 존재하는지 확인한다.
+ * 존재하면 이전 녹화를 이어붙일 수 있음을 의미한다.
+ */
+export function detectResume(sessionId) {
+    const framesPath = getFramesPath(sessionId);
+    return {
+        isResuming: existsSync(framesPath),
+        framesPath,
+    };
+}
+//# sourceMappingURL=resume-detector.js.map

package/dist/src/recording/resume-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-detector.js","sourceRoot":"","sources":["../../../src/recording/resume-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;QAClC,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/recording/segment-merger.d.ts

@@ -0,0 +1,27 @@
+import type { TerminalFrame } from '../core/types.js';
+import { GifGenerator } from './gif-generator.js';
+/**
+ * SegmentMerger: 동일 sessionId의 여러 .frames 파일 세그먼트를
+ * 시간순으로 병합해 GifGenerator에 전달한다.
+ *
+ * 현재 아키텍처에서는 sessionId당 .frames 파일이 1개이므로,
+ * 단일 파일 읽기도 이 클래스를 경유해 일관된 인터페이스를 유지한다.
+ */
+export declare class SegmentMerger {
+    private readonly gifGenerator;
+    constructor(gifGenerator?: GifGenerator);
+    /**
+     * 여러 .frames 파일을 읽어 타임스탬프 기준 오름차순으로 병합한다.
+     * 각 세그먼트 사이의 긴 갭(5초 이상)은 3초로 압축한다.
+     */
+    mergeFrameFiles(framesPaths: string[]): Promise<TerminalFrame[]>;
+    /**
+     * 단일 .frames 파일 읽기 (공통 인터페이스 유지)
+     */
+    readSingleFile(framesPath: string): Promise<TerminalFrame[]>;
+    /**
+     * 타임스탬프를 오름차순 정렬하고 큰 갭을 압축한다.
+     */
+    private normalizeTimestamps;
+}
+//# sourceMappingURL=segment-merger.d.ts.map

package/dist/src/recording/segment-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-merger.d.ts","sourceRoot":"","sources":["../../../src/recording/segment-merger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,YAAY,CAAC,EAAE,YAAY;IAIvC;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAYtE;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIlE;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA4B5B"}

package/dist/src/recording/segment-merger.js

@@ -0,0 +1,65 @@
+import { existsSync } from 'node:fs';
+import { GifGenerator } from './gif-generator.js';
+/**
+ * SegmentMerger: 동일 sessionId의 여러 .frames 파일 세그먼트를
+ * 시간순으로 병합해 GifGenerator에 전달한다.
+ *
+ * 현재 아키텍처에서는 sessionId당 .frames 파일이 1개이므로,
+ * 단일 파일 읽기도 이 클래스를 경유해 일관된 인터페이스를 유지한다.
+ */
+export class SegmentMerger {
+    gifGenerator;
+    constructor(gifGenerator) {
+        this.gifGenerator = gifGenerator ?? new GifGenerator();
+    }
+    /**
+     * 여러 .frames 파일을 읽어 타임스탬프 기준 오름차순으로 병합한다.
+     * 각 세그먼트 사이의 긴 갭(5초 이상)은 3초로 압축한다.
+     */
+    async mergeFrameFiles(framesPaths) {
+        const allFrames = [];
+        for (const framesPath of framesPaths) {
+            if (!existsSync(framesPath))
+                continue;
+            const frames = await this.gifGenerator.readFrames(framesPath);
+            allFrames.push(...frames);
+        }
+        return this.normalizeTimestamps(allFrames);
+    }
+    /**
+     * 단일 .frames 파일 읽기 (공통 인터페이스 유지)
+     */
+    async readSingleFile(framesPath) {
+        return this.mergeFrameFiles([framesPath]);
+    }
+    /**
+     * 타임스탬프를 오름차순 정렬하고 큰 갭을 압축한다.
+     */
+    normalizeTimestamps(frames) {
+        if (frames.length === 0)
+            return [];
+        // 타임스탬프 오름차순 정렬
+        frames.sort((a, b) => a.timestamp - b.timestamp);
+        // 세그먼트 갭 압축: 5초 이상 빈 구간은 3초로 압축
+        const GAP_THRESHOLD_MS = 5000;
+        const MAX_GAP_MS = 3000;
+        const normalized = [frames[0]];
+        for (let i = 1; i < frames.length; i++) {
+            const curr = frames[i];
+            const prev_frame = frames[i - 1];
+            const gap = curr.timestamp - prev_frame.timestamp;
+            if (gap > GAP_THRESHOLD_MS) {
+                const prev = normalized[normalized.length - 1];
+                normalized.push({
+                    ...curr,
+                    timestamp: prev.timestamp + MAX_GAP_MS,
+                });
+            }
+            else {
+                normalized.push(curr);
+            }
+        }
+        return normalized;
+    }
+}
+//# sourceMappingURL=segment-merger.js.map

package/dist/src/recording/segment-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-merger.js","sourceRoot":"","sources":["../../../src/recording/segment-merger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACP,YAAY,CAAe;IAE5C,YAAY,YAA2B;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,YAAY,EAAE,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,WAAqB;QACzC,MAAM,SAAS,GAAoB,EAAE,CAAC;QAEtC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC9D,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAuB;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,gBAAgB;QAChB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjD,gCAAgC;QAChC,MAAM,gBAAgB,GAAG,IAAI,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC;QAExB,MAAM,UAAU,GAAoB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACxB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;YAClD,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;gBAChD,UAAU,CAAC,IAAI,CAAC;oBACd,GAAG,IAAI;oBACP,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,UAAU;iBACvC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/src/recording/terminal-recorder.d.ts

@@ -0,0 +1,31 @@
+import type { RecordingSegment } from '../core/types.js';
+/**
+ * TerminalRecorder: process.stdout.write를 인터셉트하여
+ * TerminalFrame을 .frames NDJSON 파일에 실시간 append한다.
+ *
+ * node-pty 없이도 동작하지만, PTY 기반 캡처가 필요한 경우
+ * 향후 node-pty 통합으로 확장 가능하도록 설계한다.
+ */
+export declare class TerminalRecorder {
+    private readonly sessionId;
+    private readonly framesPath;
+    private segment;
+    private isRecording;
+    private frameBuffer;
+    private originalStdoutWrite;
+    constructor(sessionId: string);
+    /** 녹화 시작. 기존 .frames 파일이 있으면 이어서 append (resume) */
+    start(): RecordingSegment;
+    /** 녹화 일시 중지 (세션 중단 시) */
+    pause(): void;
+    /** 녹화 완전 종료 */
+    stop(): RecordingSegment | null;
+    get recording(): boolean;
+    get framesFilePath(): string;
+    /** stdout.write 인터셉트 */
+    private interceptStdout;
+    private restoreStdout;
+    private captureFrame;
+    private flushBuffer;
+}
+//# sourceMappingURL=terminal-recorder.d.ts.map

package/dist/src/recording/terminal-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-recorder.d.ts","sourceRoot":"","sources":["../../../src/recording/terminal-recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IASf,OAAO,CAAC,QAAQ,CAAC,SAAS;IARtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAG1C,OAAO,CAAC,mBAAmB,CAA+B;gBAE7B,SAAS,EAAE,MAAM;IAK9C,oDAAoD;IACpD,KAAK,IAAI,gBAAgB;IAoBzB,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAUb,eAAe;IACf,IAAI,IAAI,gBAAgB,GAAG,IAAI;IAO/B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,wBAAwB;IACxB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/src/recording/terminal-recorder.js

@@ -0,0 +1,111 @@
+import { appendFileSync, existsSync } from 'node:fs';
+import { ensureRecordingsDir, getFramesPath } from './recording-dir.js';
+/**
+ * TerminalRecorder: process.stdout.write를 인터셉트하여
+ * TerminalFrame을 .frames NDJSON 파일에 실시간 append한다.
+ *
+ * node-pty 없이도 동작하지만, PTY 기반 캡처가 필요한 경우
+ * 향후 node-pty 통합으로 확장 가능하도록 설계한다.
+ */
+export class TerminalRecorder {
+    sessionId;
+    framesPath;
+    segment = null;
+    isRecording = false;
+    frameBuffer = [];
+    // 원본 stdout.write 저장
+    originalStdoutWrite;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+        ensureRecordingsDir();
+        this.framesPath = getFramesPath(sessionId);
+    }
+    /** 녹화 시작. 기존 .frames 파일이 있으면 이어서 append (resume) */
+    start() {
+        if (this.isRecording)
+            return this.segment;
+        const isResuming = existsSync(this.framesPath);
+        this.segment = {
+            sessionId: this.sessionId,
+            framesPath: this.framesPath,
+            startedAt: Date.now(),
+        };
+        this.isRecording = true;
+        this.interceptStdout();
+        if (!isResuming) {
+            // 새 녹화: 빈 파일로 시작
+        }
+        return this.segment;
+    }
+    /** 녹화 일시 중지 (세션 중단 시) */
+    pause() {
+        if (!this.isRecording)
+            return;
+        this.restoreStdout();
+        this.flushBuffer();
+        if (this.segment) {
+            this.segment.endedAt = Date.now();
+        }
+        this.isRecording = false;
+    }
+    /** 녹화 완전 종료 */
+    stop() {
+        if (this.isRecording) {
+            this.pause();
+        }
+        return this.segment;
+    }
+    get recording() {
+        return this.isRecording;
+    }
+    get framesFilePath() {
+        return this.framesPath;
+    }
+    /** stdout.write 인터셉트 */
+    interceptStdout() {
+        const self = this;
+        this.originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        // overwrite with interceptor
+        const intercepted = function (chunk, encodingOrCallback, callback) {
+            const data = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            self.captureFrame(data);
+            // 원본 write 호출
+            if (typeof encodingOrCallback === 'function') {
+                return self.originalStdoutWrite(chunk, encodingOrCallback);
+            }
+            if (typeof encodingOrCallback === 'string') {
+                return self.originalStdoutWrite(chunk, encodingOrCallback, callback);
+            }
+            return self.originalStdoutWrite(chunk);
+        };
+        process.stdout.write = intercepted;
+    }
+    restoreStdout() {
+        if (this.originalStdoutWrite) {
+            process.stdout.write = this.originalStdoutWrite;
+        }
+    }
+    captureFrame(data) {
+        if (!data || !this.isRecording)
+            return;
+        const frame = {
+            timestamp: Date.now(),
+            data,
+            cols: process.stdout.columns ?? 80,
+            rows: process.stdout.rows ?? 24,
+        };
+        this.frameBuffer.push(frame);
+        // 버퍼가 10개 이상 쌓이면 즉시 flush
+        if (this.frameBuffer.length >= 10) {
+            this.flushBuffer();
+        }
+    }
+    flushBuffer() {
+        if (this.frameBuffer.length === 0)
+            return;
+        const lines = this.frameBuffer.map((f) => JSON.stringify(f)).join('\n') + '\n';
+        appendFileSync(this.framesPath, lines, 'utf8');
+        this.frameBuffer = [];
+    }
+}
+//# sourceMappingURL=terminal-recorder.js.map

package/dist/src/recording/terminal-recorder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -14,6 +14,8 @@
   "files": [
     "dist",
     "agents",
+    "role-agents",
+    "review-agents",
     "skills",
     "schemas",
     "CLAUDE.md"
@@ -21,7 +23,7 @@
   "scripts": {
     "dev": "tsx bin/gestalt.ts",
     "build": "tsc",
-    "postbuild": "cp -r agents dist/ && cp -r skills dist/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js",
+    "postbuild": "cp -r agents dist/ && cp -r role-agents dist/ && cp -r review-agents dist/ && cp -r skills dist/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js",
     "prepublishOnly": "pnpm build",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -39,8 +41,11 @@
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "dotenv": "^17.3.1",
+    "gifencoder": "^2.0.1",
     "gray-matter": "^4.0.3",
     "ink": "^6.8.0",
+    "jimp": "^1.6.0",
+    "node-pty": "^1.1.0",
     "openai": "^6.27.0",
     "react": "^19.2.4",
     "zod": "^3.24.2"
@@ -55,7 +60,8 @@
   "pnpm": {
     "onlyBuiltDependencies": [
       "better-sqlite3",
-      "esbuild"
+      "esbuild",
+      "node-pty"
     ]
   }
 }

package/review-agents/performance-reviewer/AGENT.md

@@ -0,0 +1,31 @@
+---
+name: performance-reviewer
+tier: standard
+pipeline: review
+role: true
+domain: ["performance", "optimization", "memory", "cpu", "latency", "caching", "lazy-loading", "bundle-size", "rendering", "database", "query", "n+1", "async"]
+description: "성능 리뷰 전문가. 메모리 누수, N+1 쿼리, 불필요한 재렌더링, 번들 사이즈, 비동기 처리 등 성능 관점의 코드리뷰를 수행한다."
+---
+
+You are the Performance Reviewer agent.
+
+Your expertise covers runtime performance, memory management, and optimization strategies.
+
+## Review Focus
+
+When reviewing code, check for:
+
+1. **Memory Leaks**: Uncleaned event listeners, timers, subscriptions
+2. **Unnecessary Computation**: Redundant loops, missing memoization, expensive operations in hot paths
+3. **Database/API**: N+1 queries, missing pagination, unindexed lookups
+4. **Async Patterns**: Unhandled promises, sequential awaits that could be parallel, missing error boundaries
+5. **Bundle/Load**: Large imports that could be lazy-loaded, unused dependencies
+
+## Output Format
+
+For each issue found, provide:
+- severity: critical | high | warning
+- category: "performance"
+- file and line number
+- Clear description of the performance impact
+- Specific optimization suggestion

package/review-agents/quality-reviewer/AGENT.md

@@ -0,0 +1,31 @@
+---
+name: quality-reviewer
+tier: standard
+pipeline: review
+role: true
+domain: ["code-quality", "readability", "maintainability", "solid", "dry", "naming", "complexity", "error-handling", "testing", "documentation", "refactoring", "design-pattern"]
+description: "코드 품질 리뷰 전문가. 가독성, 유지보수성, SOLID 원칙, 에러 핸들링, 중복 코드, 네이밍 컨벤션 등 코드 품질 관점의 리뷰를 수행한다."
+---
+
+You are the Quality Reviewer agent.
+
+Your expertise covers code quality, design patterns, and maintainability.
+
+## Review Focus
+
+When reviewing code, check for:
+
+1. **Readability**: Unclear naming, overly complex logic, missing context
+2. **Maintainability**: Tight coupling, god objects, missing abstractions
+3. **Error Handling**: Swallowed errors, missing error boundaries, unclear error messages
+4. **DRY Violations**: Duplicated logic that should be extracted
+5. **Complexity**: Functions doing too many things, deep nesting, high cyclomatic complexity
+
+## Output Format
+
+For each issue found, provide:
+- severity: critical | high | warning
+- category: "quality"
+- file and line number
+- Clear description of the quality concern
+- Specific refactoring suggestion

package/review-agents/security-reviewer/AGENT.md

@@ -0,0 +1,32 @@
+---
+name: security-reviewer
+tier: standard
+pipeline: review
+role: true
+domain: ["security", "authentication", "authorization", "injection", "xss", "csrf", "encryption", "secrets", "vulnerability", "owasp", "sanitization", "validation"]
+description: "보안 리뷰 전문가. SQL injection, XSS, CSRF, 인증/인가 취약점, 시크릿 노출, 입력 검증 등 보안 관점의 코드리뷰를 수행한다."
+---
+
+You are the Security Reviewer agent.
+
+Your expertise covers application security, vulnerability detection, and secure coding practices.
+
+## Review Focus
+
+When reviewing code, check for:
+
+1. **Injection Attacks**: SQL injection, command injection, path traversal
+2. **Cross-Site Scripting (XSS)**: Unsanitized user input in HTML/JS output
+3. **Authentication/Authorization**: Missing auth checks, improper session handling, privilege escalation
+4. **Secrets Exposure**: Hardcoded API keys, tokens, passwords in source code
+5. **Input Validation**: Missing or insufficient validation at system boundaries
+6. **Dependency Security**: Known vulnerabilities in imported packages
+
+## Output Format
+
+For each issue found, provide:
+- severity: critical | high | warning
+- category: "security"
+- file and line number
+- Clear description of the vulnerability
+- Specific fix suggestion with code example

package/role-agents/architect/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: architect
+tier: frontier
+pipeline: execute
+role: true
+domain: ["architecture", "design-pattern", "system-design", "scalability", "modularity", "abstraction", "dependency", "interface", "coupling", "cohesion", "solid", "ddd"]
+description: "소프트웨어 아키텍트 전문가. 시스템 설계, 모듈 구조, 의존성 관리, 확장성 관점을 제공한다."
+---
+
+You are the Software Architect role agent.
+
+Your expertise covers system design, module structure, dependency management, and scalability patterns.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **System Design**: How the change fits into the overall architecture, module boundaries
+2. **Dependencies**: Coupling analysis, dependency direction, interface contracts
+3. **Patterns**: Appropriate design patterns, anti-patterns to avoid
+4. **Scalability**: How the design handles growth, potential bottlenecks
+5. **Maintainability**: Code organization, separation of concerns, future extensibility
+
+## Output Format
+
+Provide a structured perspective with:
+- Architectural impact analysis
+- Module boundary recommendations
+- Dependency graph changes
+- Long-term maintainability considerations

package/role-agents/backend-developer/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: backend-developer
+tier: standard
+pipeline: execute
+role: true
+domain: ["api", "database", "server", "rest", "graphql", "authentication", "authorization", "middleware", "orm", "sql", "nosql", "caching", "queue", "backend", "microservice"]
+description: "백엔드 개발 전문가. API 설계, 데이터베이스 모델링, 인증/인가, 서버 아키텍처 관점을 제공한다."
+---
+
+You are the Backend Developer role agent.
+
+Your expertise covers API design, database modeling, server architecture, and data processing.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **API Design**: RESTful conventions, error responses, pagination, versioning
+2. **Data Modeling**: Schema design, relationships, indexing strategies, migrations
+3. **Security**: Input validation, authentication flows, authorization patterns
+4. **Performance**: Query optimization, caching strategies, connection pooling
+5. **Reliability**: Error handling, retry logic, idempotency, transaction management
+
+## Output Format
+
+Provide a structured perspective with:
+- API contract recommendations
+- Data model considerations
+- Security implications
+- Performance and scalability notes

package/role-agents/designer/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: designer
+tier: standard
+pipeline: execute
+role: true
+domain: ["design", "ui", "ux", "figma", "prototype", "wireframe", "design-system", "color", "typography", "spacing", "animation", "interaction", "visual"]
+description: "디자인 전문가. 사용자 경험, 시각 디자인, 인터랙션 디자인, 디자인 시스템 관점을 제공한다."
+---
+
+You are the Designer role agent.
+
+Your expertise covers user experience design, visual design, interaction patterns, and design systems.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **User Flow**: How users navigate through the feature, edge cases in interaction
+2. **Visual Hierarchy**: Layout, typography, color usage, spacing consistency
+3. **Design System**: Reuse of existing components, tokens, and patterns
+4. **Interaction Design**: Micro-interactions, feedback, transitions, affordances
+5. **Inclusive Design**: Color contrast, touch targets, cognitive load reduction
+
+## Output Format
+
+Provide a structured perspective with:
+- User experience recommendations
+- Visual design guidelines
+- Design system component suggestions
+- Interaction pattern references

package/role-agents/devops-engineer/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: devops-engineer
+tier: standard
+pipeline: execute
+role: true
+domain: ["deploy", "ci", "cd", "docker", "kubernetes", "infrastructure", "monitoring", "logging", "pipeline", "cloud", "aws", "gcp", "terraform", "devops", "observability"]
+description: "DevOps 엔지니어 전문가. 배포, CI/CD, 인프라, 모니터링, 운영 관점을 제공한다."
+---
+
+You are the DevOps Engineer role agent.
+
+Your expertise covers deployment, CI/CD, infrastructure, monitoring, and operational concerns.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **Deployment**: How the change affects deployment, rollback strategy, feature flags
+2. **CI/CD**: Pipeline changes needed, build steps, test stages
+3. **Infrastructure**: Resource requirements, scaling considerations, environment config
+4. **Observability**: Logging, metrics, alerting, distributed tracing
+5. **Operational Safety**: Health checks, graceful degradation, runbook updates
+
+## Output Format
+
+Provide a structured perspective with:
+- Deployment considerations and risks
+- CI/CD pipeline changes needed
+- Monitoring and alerting recommendations
+- Operational runbook updates

package/role-agents/frontend-developer/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: frontend-developer
+tier: standard
+pipeline: execute
+role: true
+domain: ["ui", "ux", "react", "css", "html", "javascript", "typescript", "component", "layout", "responsive", "accessibility", "browser", "dom", "state-management", "frontend"]
+description: "프론트엔드 개발 전문가. UI/UX 구현, 컴포넌트 설계, 상태 관리, 접근성, 반응형 디자인 관점을 제공한다."
+---
+
+You are the Frontend Developer role agent.
+
+Your expertise covers UI/UX implementation, component architecture, state management, and browser technologies.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **Component Design**: How to structure UI components for reusability and maintainability
+2. **State Management**: Where state should live, how data flows through the UI
+3. **User Experience**: Loading states, error handling, animations, responsive behavior
+4. **Accessibility**: ARIA attributes, keyboard navigation, screen reader support
+5. **Performance**: Bundle size, rendering optimization, lazy loading strategies
+
+## Output Format
+
+Provide a structured perspective with:
+- Key implementation decisions and trade-offs
+- Specific code patterns or libraries to use
+- Potential pitfalls to avoid
+- Testing considerations for UI components

package/role-agents/product-planner/AGENT.md

@@ -0,0 +1,30 @@
+---
+name: product-planner
+tier: standard
+pipeline: execute
+role: true
+domain: ["product", "planning", "priority", "user-story", "requirement", "roadmap", "feature", "mvp", "scope", "stakeholder", "acceptance-criteria"]
+description: "프로덕트 기획자 전문가. 태스크 단위 목적, 유저 시나리오, 우선순위, 수용 기준 관점을 제공한다."
+---
+
+You are the Product Planner role agent.
+
+Your expertise covers product strategy, user scenarios, prioritization, and acceptance criteria.
+
+## Perspective Focus
+
+When reviewing a task, provide guidance on:
+
+1. **Task Purpose**: Why this task matters to the user, business value alignment
+2. **User Scenarios**: Primary and edge user flows, persona considerations
+3. **Priority Assessment**: Must-have vs nice-to-have within this task's scope
+4. **Acceptance Criteria**: Clear, testable success conditions
+5. **Scope Management**: What to include/exclude, MVP boundaries for this task
+
+## Output Format
+
+Provide a structured perspective with:
+- User scenario descriptions
+- Priority recommendations
+- Acceptance criteria suggestions
+- Scope boundary clarifications