timsquad 2.0.0 → 3.3.0

package/templates/project-types/platform/process/workflow.xml

@@ -0,0 +1,254 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad Platform 워크플로우
+  프레임워크, SDK, 라이브러리 전용 프로세스 정의
+-->
+<workflow type="platform" version="1.0">
+  <metadata>
+    <description>플랫폼/라이브러리 개발 워크플로우</description>
+    <focus>API 설계, 확장성, 문서화, 버전 관리</focus>
+  </metadata>
+
+  <!-- ============================================================
+       Phase 정의
+       ============================================================ -->
+  <phases>
+    <!-- Planning Phase -->
+    <phase id="planning" order="1">
+      <name>API 설계</name>
+      <description>Public API 설계, 확장 포인트 정의</description>
+
+      <tasks>
+        <task id="public-api" required="true">
+          <name>Public API 설계</name>
+          <agent>tsq-planner</agent>
+          <output>service-spec.md</output>
+          <checklist>
+            <item>함수/클래스 시그니처</item>
+            <item>타입 정의</item>
+            <item>옵션 객체</item>
+            <item>반환값</item>
+          </checklist>
+        </task>
+
+        <task id="extension-points" required="true">
+          <name>확장 포인트 정의</name>
+          <agent>tsq-planner</agent>
+          <output>integration-spec.md</output>
+          <checklist>
+            <item>훅/콜백</item>
+            <item>플러그인 인터페이스</item>
+            <item>이벤트 시스템</item>
+          </checklist>
+        </task>
+
+        <task id="glossary" required="true">
+          <name>용어 정의</name>
+          <agent>tsq-planner</agent>
+          <output>glossary.md</output>
+          <checklist>
+            <item>핵심 개념</item>
+            <item>용어 설명</item>
+            <item>예제</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>모든 Public API 문서화</rule>
+        <rule>확장 포인트 명확히 정의</rule>
+      </validation>
+
+      <exit-criteria>
+        <criterion>service-spec.md 완성</criterion>
+        <criterion>integration-spec.md 완성</criterion>
+        <criterion>glossary.md 완성</criterion>
+        <criterion>사용자 승인</criterion>
+      </exit-criteria>
+    </phase>
+
+    <!-- Implementation Phase -->
+    <phase id="implementation" order="2">
+      <name>구현</name>
+      <description>타입 안전한 구현, 문서화</description>
+
+      <tasks>
+        <task id="core-implementation" required="true">
+          <name>핵심 기능 구현</name>
+          <agent>tsq-developer</agent>
+          <dependency>public-api</dependency>
+          <checklist>
+            <item>타입 정의</item>
+            <item>핵심 로직</item>
+            <item>에러 처리</item>
+            <item>TSDoc 문서화</item>
+          </checklist>
+        </task>
+
+        <task id="plugin-system" required="false">
+          <name>플러그인 시스템</name>
+          <agent>tsq-developer</agent>
+          <dependency>extension-points</dependency>
+        </task>
+
+        <task id="examples" required="true">
+          <name>예제 코드 작성</name>
+          <agent>tsq-developer</agent>
+          <dependency>core-implementation</dependency>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>모든 Public API에 TSDoc</rule>
+        <rule>타입 검사 통과</rule>
+        <rule>no-any 규칙 준수</rule>
+      </validation>
+    </phase>
+
+    <!-- Testing Phase -->
+    <phase id="testing" order="3">
+      <name>테스트</name>
+      <description>단위 테스트, 타입 테스트, 번들 테스트</description>
+
+      <tasks>
+        <task id="unit-test" required="true">
+          <name>단위 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>모든 Public API 테스트</item>
+            <item>엣지 케이스</item>
+            <item>에러 케이스</item>
+          </checklist>
+        </task>
+
+        <task id="type-test" required="true">
+          <name>타입 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>타입 추론 테스트</item>
+            <item>제네릭 테스트</item>
+            <item>에러 타입 테스트</item>
+          </checklist>
+        </task>
+
+        <task id="bundle-test" required="true">
+          <name>번들 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>번들 크기 확인</item>
+            <item>Tree-shaking 테스트</item>
+            <item>ESM/CJS 호환성</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>테스트 커버리지 90% 이상</rule>
+        <rule>Public API 100% 테스트</rule>
+        <rule>번들 크기 50kb 이하</rule>
+      </validation>
+    </phase>
+
+    <!-- Documentation Phase -->
+    <phase id="documentation" order="4">
+      <name>문서화</name>
+      <description>API 레퍼런스, 가이드 작성</description>
+
+      <tasks>
+        <task id="api-reference" required="true">
+          <name>API 레퍼런스</name>
+          <agent>tsq-developer</agent>
+          <checklist>
+            <item>함수 레퍼런스</item>
+            <item>타입 레퍼런스</item>
+            <item>옵션 설명</item>
+          </checklist>
+        </task>
+
+        <task id="getting-started" required="true">
+          <name>Getting Started</name>
+          <agent>tsq-developer</agent>
+          <checklist>
+            <item>설치 방법</item>
+            <item>기본 사용법</item>
+            <item>간단한 예제</item>
+          </checklist>
+        </task>
+
+        <task id="advanced-guides" required="false">
+          <name>고급 가이드</name>
+          <agent>tsq-developer</agent>
+          <checklist>
+            <item>플러그인 작성</item>
+            <item>커스터마이징</item>
+            <item>마이그레이션</item>
+          </checklist>
+        </task>
+      </tasks>
+    </phase>
+
+    <!-- Release Phase -->
+    <phase id="release" order="5">
+      <name>릴리스</name>
+      <description>버전 관리, 배포</description>
+
+      <tasks>
+        <task id="version-bump" required="true">
+          <name>버전 업데이트</name>
+          <agent>tsq-developer</agent>
+          <checklist>
+            <item>SemVer 규칙 준수</item>
+            <item>Breaking Changes 확인</item>
+          </checklist>
+        </task>
+
+        <task id="changelog" required="true">
+          <name>CHANGELOG 작성</name>
+          <agent>tsq-developer</agent>
+        </task>
+
+        <task id="publish" required="true">
+          <name>npm 배포</name>
+          <agent>tsq-developer</agent>
+          <checklist>
+            <item>dry-run 실행</item>
+            <item>태그 확인</item>
+            <item>배포</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <approval>
+        <required>true</required>
+        <approvers>
+          <approver>user</approver>
+        </approvers>
+      </approval>
+    </phase>
+  </phases>
+
+  <!-- ============================================================
+       Platform 특화 규칙
+       ============================================================ -->
+  <rules>
+    <rule id="api-stability">
+      <description>Public API는 SemVer 준수</description>
+      <enforcement>strict</enforcement>
+    </rule>
+
+    <rule id="documentation-first">
+      <description>문서화 없이 릴리스 금지</description>
+      <enforcement>strict</enforcement>
+    </rule>
+
+    <rule id="type-safety">
+      <description>any 타입 사용 금지</description>
+      <enforcement>strict</enforcement>
+    </rule>
+
+    <rule id="bundle-size">
+      <description>번들 크기 50kb 이하 유지</description>
+      <enforcement>warning</enforcement>
+    </rule>
+  </rules>
+</workflow>

package/templates/project-types/web-app/config.yaml

@@ -0,0 +1,198 @@
+# TimSquad Web App Template Configuration
+# BaaS 기반 웹 앱 (Supabase, Firebase 등) 전용
+
+template:
+  name: web-app
+  description: BaaS 기반 웹앱을 위한 템플릿
+  version: 2.0.0
+
+# ============================================================
+# 프로젝트 기본값
+# ============================================================
+project:
+  type: web-app
+  level: 2
+  architecture: baas     # BaaS 기반 아키텍처
+
+# ============================================================
+# 개발 방법론 기본값
+# ============================================================
+methodology:
+  development: tdd
+  process: agile
+  branching: github-flow
+  review: required
+
+# ============================================================
+# 권장 기술 스택
+# ============================================================
+stack:
+  language: typescript
+
+  frontend:
+    enabled: true
+    framework: nextjs
+    state: zustand
+    styling: tailwind
+    testing: vitest
+
+  backend:
+    enabled: false         # BaaS 사용 → 별도 백엔드 서버 없음
+    baas: supabase         # supabase | firebase | appwrite
+    runtime: edge          # Edge Functions (Supabase/Vercel)
+    testing: vitest
+
+  database:
+    primary: postgresql    # BaaS 관리형 DB
+    orm: none              # BaaS SDK 직접 사용
+    rls: required          # Row Level Security 필수
+    cache: none
+
+  infrastructure:
+    hosting: vercel
+    baas_provider: supabase
+    container: false
+    ci_cd: github
+
+# ============================================================
+# 스킬 자동 로딩 규칙
+# ============================================================
+skills:
+  base:
+    - coding
+    - testing
+    - security
+    - planning
+    - architecture
+
+  type-specific:
+    - typescript
+    - frontend/react
+    - frontend/nextjs
+    - methodology/tdd
+
+# ============================================================
+# SSOT 문서 설정
+# ============================================================
+ssot:
+  required:
+    - prd.md
+    - planning.md
+    - requirements.md
+    - service-spec.md       # API / BaaS 호출 명세
+    - data-design.md        # 테이블, RLS, 인덱스 설계 (필수)
+    - ui-ux-spec.md         # UI/UX 명세 (필수)
+    - error-codes.md
+
+  recommended:
+    - functional-spec.md
+    - glossary.md
+    - test-spec.md
+    - env-config.md
+
+  optional:
+    - integration-spec.md   # BaaS 외 외부 연동이 있을 때만
+    - security-spec.md
+    - deployment-spec.md
+
+# ============================================================
+# BaaS 특화 설정
+# ============================================================
+baas:
+  provider: supabase
+
+  # Supabase 기능별 활성화
+  features:
+    auth: true             # Supabase Auth
+    storage: false         # Supabase Storage
+    realtime: false        # Supabase Realtime
+    edge_functions: false  # Supabase Edge Functions
+    rpc: false             # Database RPC
+
+  # RLS (Row Level Security) 정책
+  rls:
+    required: true
+    audit: required        # 모든 테이블에 RLS 정책 존재 확인
+
+  # 데이터 설계 주의사항
+  data_design:
+    # BaaS는 ORM 없이 직접 SQL/SDK 사용
+    migration: supabase    # Supabase Migration
+    naming: snake_case     # PostgreSQL 네이밍
+    soft_delete: recommended
+
+# ============================================================
+# 추가 에이전트
+# ============================================================
+additional_agents:
+  - name: tsq-frontend
+    description: 프론트엔드 전문 개발자
+    base: tsq-developer
+    skills: [frontend/react, frontend/nextjs, typescript]
+
+# ============================================================
+# 레벨별 권장 사항
+# ============================================================
+level_recommendations:
+  1:  # MVP
+    focus:
+      - 핵심 기능 구현
+      - BaaS Auth 연동
+      - 최소 UI
+      - 기본 RLS 설정
+    skip:
+      - 성능 최적화
+      - 상세 모니터링
+      - 복잡한 권한 체계
+
+  2:  # Standard
+    focus:
+      - 완전한 기능
+      - 테스트 커버리지 80%+
+      - UI/UX 품질
+      - RLS 정책 완성
+      - 기본 모니터링
+    skip:
+      - 엔터프라이즈 보안
+      - 멀티 리전
+
+  3:  # Enterprise
+    focus:
+      - 전체 기능
+      - 테스트 커버리지 90%+
+      - 보안 강화 (OWASP)
+      - 상세 모니터링
+      - 문서화 완성
+      - RLS 감사
+    additional_agents:
+      - tsq-security
+
+# ============================================================
+# 배포 설정
+# ============================================================
+deployment:
+  frontend: vercel         # Vercel 배포
+  baas: supabase           # Supabase 관리형
+  environments:
+    - development
+    - staging
+    - production
+  env_sync: required       # 환경별 환경변수 동기화 필수
+
+# ============================================================
+# 코딩 규칙
+# ============================================================
+coding:
+  # BaaS 클라이언트 패턴
+  baas_client:
+    server_client: required    # 서버 컴포넌트용 클라이언트
+    browser_client: required   # 브라우저용 클라이언트
+    middleware: required       # Auth 미들웨어
+
+  # Server Actions / API Routes
+  api_pattern: server-actions  # server-actions | api-routes
+
+  # 타입 생성
+  type_generation:
+    source: supabase           # supabase gen types
+    auto_update: recommended

package/templates/project-types/web-app/process/workflow.xml

@@ -0,0 +1,210 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<workflow extends="common/process/workflow-base.xml">
+  <metadata>
+    <name>web-app-workflow</name>
+    <description>BaaS 기반 웹앱 프로젝트용 워크플로우</description>
+    <type>web-app</type>
+    <version>1.0</version>
+  </metadata>
+
+  <!-- 레벨별 워크플로우 프리셋 -->
+  <presets>
+    <preset id="mvp" level="1" description="MVP - 빠른 개발">
+      <phases include="planning,implementation,review,complete"/>
+      <skip-phases>security</skip-phases>
+      <simplified-rules>
+        <rule>보안 검토 생략 가능</rule>
+        <rule>테스트 커버리지 60% 허용</rule>
+        <rule>기본 RLS 정책만 필수</rule>
+      </simplified-rules>
+    </preset>
+
+    <preset id="standard" level="2" description="표준 - 균형 잡힌 개발">
+      <phases include="planning,implementation,review,complete"/>
+      <optional-phases>security</optional-phases>
+      <rules>
+        <rule>UI/UX 명세 필수</rule>
+        <rule>데이터 설계 (RLS 포함) 필수</rule>
+        <rule>테스트 커버리지 80% 필수</rule>
+        <rule>코드 리뷰 필수</rule>
+      </rules>
+    </preset>
+
+    <preset id="enterprise" level="3" description="엔터프라이즈 - 완전한 프로세스">
+      <phases include="planning,implementation,review,security,complete"/>
+      <mandatory>
+        <item>모든 Phase 통과 필수</item>
+        <item>보안 검토 필수</item>
+        <item>RLS 감사 필수</item>
+        <item>테스트 커버리지 90% 필수</item>
+      </mandatory>
+    </preset>
+  </presets>
+
+  <!-- Web App 특화 Phase 확장 -->
+  <phase-extensions>
+    <!-- 기획 Phase 확장 -->
+    <extend-phase id="planning">
+      <additional-tasks>
+        <task id="ui-ux">UI/UX 설계 (화면 플로우, 테마, 컴포넌트)</task>
+        <task id="data-design">데이터 설계 (테이블, RLS, 인덱스)</task>
+        <task id="baas-integration">BaaS 기능 설계 (Auth, Storage, Realtime)</task>
+      </additional-tasks>
+
+      <additional-outputs>
+        <output required="true">ssot/ui-ux-spec.md</output>
+        <output required="true">ssot/data-design.md</output>
+      </additional-outputs>
+
+      <context-verification>
+        <instruction priority="critical">
+          템플릿 작성 시 프로젝트의 실제 BaaS 프로바이더와 기능을 확인하고,
+          사용하지 않는 외부 서비스(Stripe, SendGrid 등)를 포함하지 마세요.
+          config.yaml의 baas.features와 stack 설정을 먼저 확인하세요.
+        </instruction>
+      </context-verification>
+
+      <agent-assignment>
+        <task ref="ui-ux" agent="tsq-designer" fallback="tsq-planner"/>
+        <task ref="data-design" agent="tsq-dba" fallback="tsq-planner" mode="architect"/>
+        <task ref="baas-integration" agent="tsq-planner" mode="architect"/>
+      </agent-assignment>
+    </extend-phase>
+
+    <!-- 구현 Phase 확장: BaaS 앱은 프론트엔드 중심 -->
+    <extend-phase id="implementation">
+      <parallel-tracks>
+        <track id="frontend" agent="tsq-frontend" fallback="tsq-developer">
+          <description>프론트엔드 + BaaS 연동 구현</description>
+          <prerequisites>
+            <check>ssot/ui-ux-spec.md</check>
+            <check>ssot/service-spec.md</check>
+            <check>ssot/data-design.md</check>
+          </prerequisites>
+          <tasks>
+            <task id="baas-setup">BaaS 클라이언트 설정 (Server/Browser/Middleware)</task>
+            <task id="auth">BaaS Auth 연동 (로그인, 회원가입, 세션)</task>
+            <task id="components">UI 컴포넌트 구현</task>
+            <task id="pages">페이지 구현</task>
+            <task id="state">상태 관리</task>
+            <task id="data-access">데이터 접근 계층 (BaaS SDK 호출)</task>
+          </tasks>
+          <exit-criteria>
+            <criterion>모든 화면 구현 완료</criterion>
+            <criterion>BaaS 연동 테스트 통과</criterion>
+            <criterion>반응형 디자인 확인</criterion>
+          </exit-criteria>
+        </track>
+
+        <track id="database" agent="tsq-dba" fallback="tsq-developer">
+          <description>데이터베이스 + RLS 구현</description>
+          <prerequisites>
+            <check>ssot/data-design.md</check>
+          </prerequisites>
+          <tasks>
+            <task id="migrations">Migration 파일 작성</task>
+            <task id="rls">RLS 정책 구현</task>
+            <task id="indexes">인덱스 최적화</task>
+            <task id="seed">Seed 데이터 작성</task>
+          </tasks>
+          <exit-criteria>
+            <criterion>모든 테이블 생성 완료</criterion>
+            <criterion>RLS 정책 적용 완료</criterion>
+            <criterion>Migration 테스트 통과</criterion>
+          </exit-criteria>
+        </track>
+
+        <track id="edge-functions" optional="true" agent="tsq-developer">
+          <description>Edge Functions (서버사이드 로직)</description>
+          <condition>config.baas.features.edge_functions == true</condition>
+          <tasks>
+            <task id="edge-impl">Edge Function 구현</task>
+            <task id="edge-test">Edge Function 테스트</task>
+          </tasks>
+        </track>
+      </parallel-tracks>
+
+      <methodology-variants>
+        <variant methodology="tdd">
+          <task-order>test → implement → refactor</task-order>
+          <enforcement>테스트 없이 구현 코드 PR 금지</enforcement>
+        </variant>
+      </methodology-variants>
+    </extend-phase>
+
+    <!-- 검증 Phase 확장 -->
+    <extend-phase id="review">
+      <additional-checklists>
+        <checklist name="UI/UX 검증">
+          <item>디자인 명세 일치</item>
+          <item>반응형 동작 확인</item>
+          <item>접근성(a11y) 기본 체크</item>
+          <item>로딩/에러 상태 UI</item>
+        </checklist>
+
+        <checklist name="BaaS 연동 검증">
+          <item>Auth 플로우 정상 동작</item>
+          <item>RLS 정책 올바르게 적용됨</item>
+          <item>BaaS SDK 호출 패턴 일관성</item>
+          <item>환경별 BaaS 프로젝트 분리 확인</item>
+        </checklist>
+
+        <checklist name="데이터 검증">
+          <item>data-design.md와 실제 스키마 일치</item>
+          <item>모든 테이블에 RLS 정책 존재</item>
+          <item>인덱스 적절히 설정됨</item>
+          <item>Soft delete 정책 일관성</item>
+        </checklist>
+
+        <checklist name="성능 기본">
+          <item>First Contentful Paint &lt; 1.5s</item>
+          <item>Largest Contentful Paint &lt; 2.5s</item>
+          <item>BaaS 쿼리 응답 시간 &lt; 500ms</item>
+          <item>번들 사이즈 체크</item>
+        </checklist>
+      </additional-checklists>
+    </extend-phase>
+  </phase-extensions>
+
+  <!-- Web App 특화 에스컬레이션 규칙 -->
+  <escalation-extensions>
+    <rule trigger="UI/UX 불일치" route="tsq-designer" fallback="tsq-planner">
+      화면 설계와 구현이 맞지 않으면 Designer에게 확인
+    </rule>
+    <rule trigger="RLS 정책 누락" route="tsq-planner" mode="architect">
+      RLS 정책 미적용 테이블 발견 시 즉시 설계 보완
+    </rule>
+    <rule trigger="BaaS 연동 오류" route="tsq-developer">
+      BaaS SDK 호출 오류 시 Developer가 수정
+    </rule>
+    <rule trigger="성능 이슈" route="tsq-developer">
+      성능 기준 미달 시 Developer가 최적화
+    </rule>
+  </escalation-extensions>
+
+  <!-- 배포 설정 -->
+  <deployment>
+    <environments>
+      <env name="development" auto-deploy="true">
+        <baas-project>dev 프로젝트</baas-project>
+      </env>
+      <env name="staging" requires-review="true">
+        <baas-project>staging 프로젝트</baas-project>
+      </env>
+      <env name="production" requires-approval="true">
+        <baas-project>production 프로젝트</baas-project>
+      </env>
+    </environments>
+
+    <ci-cd>
+      <provider>github-actions</provider>
+      <checks>
+        <check>lint</check>
+        <check>type-check</check>
+        <check>unit-tests</check>
+        <check>build</check>
+        <check>rls-audit</check>
+      </checks>
+    </ci-cd>
+  </deployment>
+</workflow>