AI 개발 방법론

신사업, 이제 명령어 하나로 시작한다. Superwork가 선택한 변증법 AI 개발 방법론.

아이디어를 입력하면 기획·개발·검증·통합이 자동으로 진행됩니다. 우리는 이 시스템으로 Superwork의 모든 프로젝트를 운영합니다.

워크플로우 살펴보기 ↓

개요

Superwork팀은 프로젝트를 Superwork Workflow로 시작합니다. 정반합(正反合) 변증법 기반 멀티 에이전트 시스템이 아이디어 강화부터 배포까지 전 과정을 자동화합니다.

ThesisAgent(正)가 초안을 제시하면 AntithesisAgent(反)가 검증하고, ACCEPT Verdict가 나올 때까지 반복해 산출물 품질을 끌어올립니다.

사람은 방향을 정하고, 시스템이 실행합니다.

시작하기: tas init

tas init 한 번이면 개발 환경이 완성됩니다. 안전 가드 하네스 설치, 프로젝트 설정 자동화, 환경 변수 구성이 한 번에 처리됩니다.

하네스 자동 설치

tas init 실행 시 .claude/hooks/ 디렉터리에 6종의 안전 가드가 자동으로 복사됩니다.

bash_safety_guard.py — 파괴적 Bash 명령(rm -rf, git reset --hard 등) 차단
protected_file_guard.py — 상태 파일(.env, sprint-status.yaml 등) 무단 수정 방지
content_quality_guard.py — LLM 슬롭(빈 구현, 플레이스홀더 코드) 감지 및 거부
edit_error_recovery.py — Edit 도구 실패 시 자동 복구 로직
ruff_lint_check.sh — 커밋 전 Python 코드 Ruff 린트 검사
commit_message_check.sh — 커밋 메시지 포맷 규칙 강제

에이전트가 코드를 작성할 때 사람이 개입하지 않아도 품질이 자동으로 유지됩니다.

프로젝트 설정 자동화

프로젝트를 클론하고 tas init 한 번이면 팀 모든 구성원이 동일한 에이전트 환경을 공유합니다.

자동으로 설정되는 항목:

settings.json — Claude Code 권한 정책 + Hook 매핑
CLAUDE.md — 프로젝트 구조 가이드 (에이전트 컨텍스트 초기화)
rules/tech-stack.md — 기술 스택 선택 강제 (BaaS, 프레임워크)
.gitignore managed block — idempotent 삽입으로 중복 없이 패턴 추가

전체 라이프사이클: tas lifecycle

tas lifecycle "아이디어" 명령 하나로 전체 개발 라이프사이클이 시작됩니다.

NavigatorAgent가 아이디어를 분석해 Discovery & Planning 단계를 동적으로 구성하고, Story Cycle이 모든 스토리를 ACCEPT까지 자동 실행합니다.

아이디어 강화 (raw → enriched)

tas lifecycle "아이디어" 입력 시 NavigatorAgent가 아이디어를 분석하고 관련 플랫폼·도메인·경쟁사를 조사해 구조화된 프로젝트 컨셉 문서를 생성합니다.

플랫폼 제약·핵심 개념·미결정 항목 구조화
이 문서가 이후 모든 단계(Discovery·Planning·Story Cycle)의 컨텍스트로 공유됩니다.

Discovery & Planning

NavigatorAgent가 프로젝트 성격을 분석해 아래 단계 중 필요한 것만 동적으로 선택·실행합니다. 각 단계는 변증법 루프로 산출물 완성도를 보장합니다.

0000

Brainstorm
막연한 아이디어를 구체적 방향으로 흔들어 깨웁니다.
- 산출물: Brainstorm 세션 기록
- 언제: 아이디어가 "한 줄"일 때, 방향을 펼쳐야 할 때
- 특징: 단일·다중 기법 가이드 퍼실리테이션 — 발산과 수렴을 한 번에
Market Research
"이거 이미 누가 하고 있나?"에 답하기 전에 넘어가지 않습니다.
- 산출물: 시장·경쟁·고객 니즈 리포트
- 언제: 사업성·차별화가 쟁점일 때
- 특징: 경쟁 구도·트렌드·타깃 분석을 구조화된 문서로 — 차별화 포인트를 데이터로 뒷받침
Domain Research
업계 전문가의 어휘로 말할 수 있게 합니다.
- 산출물: 도메인 딥다이브 문서 (용어·규제·관행)
- 언제: 의료·금융·게임 등 전문 도메인, LLM이 맞는 용어를 못 쓸 때
- 특징: 이후 모든 스펙이 "해당 업계 사람이 읽어도 어색하지 않은" 언어로 작성되게 하는 토대
Tech Research
"만들 수 있나?"를 코드 한 줄 쓰기 전에 검증합니다.
- 산출물: 기술 타당성·아키텍처 옵션·리스크 리포트
- 언제: 생소한 스택, 성능·확장 이슈, 엔진·프레임워크 선정이 필요할 때
- 특징: 여러 옵션을 trade-off로 비교 — Architecture 단계 전에 선택지를 정리
Create PRD필수
제품 요구사항을 "실행 가능한 문서"로 고정합니다.
- 산출물: Product Requirements Document
- 언제: Discovery가 끝나고 범위를 박아야 할 때
- 특징: 에픽·스토리로 바로 쪼갤 수 있는 수준의 요구사항 명세. AntithesisAgent(反)가 검증·수정 루프 동반
Create UX
화면이 제품의 얼굴이라면, 먼저 얼굴을 그립니다.
- 산출물: UX 설계서 (플로우·패턴·화면 스펙)
- 언제: UI가 제품의 주요 가치일 때
- 특징: PRD 위에서 사용자 여정·상호작용 패턴을 설계 — 이후 구현 스토리에 바로 반영
Create Architecture필수
"어떻게 만들지"를 한 문서에 담습니다.
- 산출물: 기술 아키텍처 문서 (시스템·데이터·통합)
- 언제: 구현 전
- 특징: 기술 결정·의존성·확장 포인트를 기록 — 이후 Dev 루프의 모든 스토리가 이 문서를 참조
Create Epics & Stories필수
설계를 "AI가 병렬로 먹을 수 있는 단위"로 쪼갭니다.
- 산출물: 에픽 + 스토리 리스트
- 언제: Architecture 완료 후
- 특징: 여기서 쪼개진 스토리 단위가 그대로 병렬 Dev 파이프라인의 입력이 됩니다. 설계와 실행을 잇는 핵심 변환점

Story Cycle

매 스토리마다 독립된 워커트리에서 실행됩니다. Code Review ACCEPT 판정이 나올 때까지 Dev → (QA) → Review → Playtest 루프를 자동 반복합니다.

최대 5개 스토리를 동시에 병렬 진행하며, 완료된 스토리는 자동 머지됩니다. 웨이브 간 통합 무결성은 자동으로 보장됩니다.

0000

Sprint Planning필수
병렬 실행의 웨이브를 설계합니다.
- 산출물: 웨이브 그룹 계획 (execution-plan.yaml)
- 언제: Dev 루프 시작 전
- 특징: 의존성을 위상정렬해 "동시에 돌려도 안전한 스토리 묶음"을 구성 — 격리된 워커트리에서 최대 5개 스토리 병렬 진행
Create Story
스토리 한 건을 "구현 직전" 상태까지 준비합니다.
- 산출물: 컨텍스트가 채워진 스토리 파일
- 언제: 각 스토리 사이클의 시작
- 특징: 에픽·아키텍처·이전 스토리 학습을 주입한 풍부한 컨텍스트 — 개발자 AI가 더 이상 물어볼 게 없을 만큼 준비
Dev Story
격리된 워커트리에서 실제 구현을 진행합니다.
- 산출물: 실제 코드·테스트·스토리 상태 업데이트
- 언제: Create Story 직후
- 특징: 워커트리 격리 + 피드백 루프 — Review/Playtest 반려 시 피드백을 먹고 재작업
QA 자동화 테스트
리그레션 방지선을 자동으로 세웁니다.
- 산출물: API/E2E 자동화 테스트 스위트
- 언제: 구현된 스토리에 대해 (선택)
- 특징: "실행 가능한 안전망" 생성 — 이후 모든 스토리의 변경이 자동으로 검증됨
코드 리뷰
정적 품질의 1차 관문입니다.
- 산출물: REFINE / ACCEPT / COUNTER / HALT 중 하나의 판정
- 언제: Dev Story 후
- 특징: AntithesisAgent(反)가 AC 충족·코드 품질·일관성을 독립 평가, ACCEPT 없이 통과 없음, Dev로 회귀
Antithesis Playtest
AC 체크리스트 통과 ≠ 실제로 동작함. 진짜 돌려봅니다.
- 산출물: 런타임 증거 (스크린샷·로그·판정)
- 언제: Code Review ACCEPT 직후 (선택)
- 특징: Dev 서버를 실제로 띄우고 브라우저/프로세스/HTTP 드라이버로 조작 — 정적 리뷰를 통과했지만 런타임에 깨지는 실패를 잡아냄. 실패 시 Dev로 회귀

Use Cases

Superwork Workflow로 만든 실제 프로덕트. 모바일 네이티브부터 웹 게임, 설치형 웹앱까지 런타임을 가리지 않습니다.

프로덕트 3종 and more..

0000

Flutter 앱
네이티브 모바일 · TAS 라이프사이클 풀코스
Cocos 웹게임
웹 게임 · Story Cycle + Minigame Assets MCP 에셋 자동화
Next.js PWA
설치형 웹앱 · TAS 라이프사이클 풀코스

Core Module

TAS (Thesis Antithesis Synthesis)

TAS — Claude Code 기반 변증법 멀티 에이전트 오케스트레이션 플러그인.

3계층 구조:

MainOrchestrator — 전체 라이프사이클 조율
MetaAgent — 단계 계획 및 에이전트 파견
ThesisAgent(正) · AntithesisAgent(反) — 변증법적 산출물 검증

5 스킬:

/tas — 주요 오케스트레이션 진입점
/tas-review — 산출물 리뷰
/tas-verify — 검증 단계 (역할반전: Attacker 모드)
/tas-explain — 워크플로우 설명
/tas-workspace — 워크스페이스 관리

4단계 라이프사이클:

기획 → 구현 → 검증(역할반전) → 테스트(역할반전)

설치:

# claude code 실행 후
/plugin marketplace add https://github.com/simsimhae91/tas.git
/plugin install tas@tas

Minigame Assets MCP

Minigame Assets MCP — Claude와 대화하면서 게임 에셋(캐릭터·스프라이트·배경·UI·로고·썸네일)을 그때그때 만들어 주는 MCP 서버.

워크플로우:

컨셉 → 실행 계획 → 캐릭터/에셋 생성 → 검토·검증 → 배포

모든 원본은 .minigame-assets/ 폴더에 모이고, asset_deploy 가 승인된 항목만 asset_size_spec.json 기반으로 리사이즈해 public/assets/ 같은 코드 경로로 복사합니다.

할 수 있는 것:

캐릭터 — 베이스 → 장비 결합 → 스프라이트 시트 (Sequential anchor+prev, 액션별 5+ 프레임 매트릭스, Phaser/Unity/Cocos atlas 자동 동반)
배경·화면 — 게임 씬 배경(spec-aware), 로딩·로비 화면, parallax 다층 레이어
UI — HUD · 버튼 · 팝업 · 아이콘 · 스타일 레퍼런스 시트
마케팅 — 타이틀 워드마크 PNG, 앱 로고·썸네일(워드마크+캐릭터 합성), 스토어 배너/스크린샷, SNS 팩
사운드, 영상 - 추가 예정

설치 (플러그인 권장):

export OPENAI_API_KEY=sk-...
claude plugin marketplace add LimSuyun/minigame-assets-mcp
claude plugin install minigame-assets@minigame-assets-mcp

설치 후 /reload-plugins. 슬래시 명령(/minigame-assets:create-minigame-assets, /minigame-assets:setup-minigame-assets-concept, /minigame-assets:minigame-assets-help)과 자동 트리거 워크플로우 스킬이 함께 제공됩니다.

Self-Healing (자가 복구)

운영 중인 서비스에서 발생하는 에러를 자동으로 감지하고 수정하는 자가 복구 시스템입니다.

Sentry와 Firebase Crashlytics로부터 에러를 수집하고, TAS 워크플로우로 자동 수정 후 PR을 생성합니다.

에러 감지 (Sentry + Firebase)

Sentry(백엔드/프론트엔드 런타임 에러)와 Firebase Crashlytics(모바일 크래시)로부터 실시간 에러 이벤트를 수집합니다.

에러 빈도·스택 트레이스·영향 범위를 기준으로 자동 처리 대상을 분류합니다.

낮은 심각도 → 로그 기록만
높은 심각도 → TAS Quick 자동 트리거

자동 수정

임계값을 초과하는 에러 이벤트 발생 시 TAS 워크플로우가 자동으로 트리거됩니다.

tas quick "{에러 스택 + 재현 조건}"

ThesisAgent(正)가 수정 코드를 제안하고, AntithesisAgent(反)가 변증법적으로 검증합니다. ACCEPT Verdict 시 자동 커밋됩니다.

Sentry

백엔드 / 프론트엔드

Firebase
Crashlytics

모바일 크래시

↓

에러 감지 & 분류

빈도 · 스택 트레이스 · 영향 범위

↙

낮은 심각도

↓

로그 기록

↘

높은 심각도

↓

TAS Quick 자동 트리거

tas quick "에러 스택 + 재현 조건"

↓

자동 수정 (PingPong)

ThesisAgent(正) → AntithesisAgent(反) → ACCEPT

↓

PR 자동 생성

GitHub API · 원인 분석 · 재발 방지 포함

↓

담당자 알림

Slack · 이메일 → 코드 리뷰 대기

PR 자동 생성

수정이 완료되면 GitHub API로 Pull Request가 자동으로 생성됩니다. PR에는 다음 내용이 포함됩니다:

에러 원인 분석 및 재현 조건
수정 내용 요약
재발 방지 조치

담당자에게 Slack/이메일 알림 후 코드 리뷰를 대기합니다.

신사업, 이제 명령어 하나로 시작한다. Superwork가 선택한 변증법 AI 개발 방법론.

개요

시작하기: tas init

하네스 자동 설치

프로젝트 설정 자동화

전체 라이프사이클: tas lifecycle

아이디어 강화 (raw → enriched)

Discovery & Planning

Brainstorm

Market Research

Domain Research

Tech Research

Create PRD필수

Create UX

Create Architecture필수

Create Epics & Stories필수

Story Cycle

Sprint Planning필수

Create Story

Dev Story

QA 자동화 테스트

코드 리뷰

Antithesis Playtest

Use Cases

프로덕트 3종 and more..

Flutter 앱

Cocos 웹게임

Next.js PWA

Core Module

TAS (Thesis Antithesis Synthesis)

Minigame Assets MCP

Self-Healing (자가 복구)

에러 감지 (Sentry + Firebase)

자동 수정

PR 자동 생성