timsquad 2.1.0 → 3.3.0

package/templates/project-types/platform/config.yaml

@@ -0,0 +1,254 @@
+# TimSquad Platform 프로젝트 설정
+# 프레임워크, SDK, 라이브러리 전용
+
+type: platform
+description: "프레임워크, SDK, 라이브러리, 플러그인 시스템"
+
+# ============================================================
+# 에이전트 설정
+# ============================================================
+agents:
+  # Planner는 API 설계와 문서화에 집중
+  planner:
+    model: opus
+    focus:
+      - api_design
+      - extensibility
+      - backward_compatibility
+      - documentation
+    ssot_priority:
+      - service-spec.md      # Public API
+      - integration-spec.md  # 확장 포인트
+      - glossary.md          # 용어 정의 중요
+
+  # Developer는 라이브러리 구현
+  developer:
+    model: sonnet
+    skills:
+      - coding
+      - testing
+      - typescript
+    focus:
+      - clean_code
+      - type_safety
+      - performance
+      - tree_shaking
+
+  # QA는 API 안정성에 집중
+  qa:
+    model: sonnet
+    focus:
+      - api_stability
+      - regression_testing
+      - compatibility_testing
+      - documentation_testing
+
+  # Security는 의존성 관리
+  security:
+    model: sonnet
+    focus:
+      - dependency_audit
+      - supply_chain
+      - api_security
+
+# ============================================================
+# SSOT 문서 설정
+# ============================================================
+ssot:
+  required:
+    - prd.md
+    - planning.md
+    - requirements.md
+    - service-spec.md       # Public API 명세
+    - glossary.md           # 용어 정의 필수
+    - integration-spec.md   # 확장 포인트, 훅
+
+  recommended:
+    - test-spec.md
+    - error-codes.md
+    - functional-spec.md
+
+  optional:
+    - ui-ux-spec.md
+    - data-design.md       # 내부 상태만
+    - deployment-spec.md   # npm publish 정도
+
+# ============================================================
+# 워크플로우 설정
+# ============================================================
+workflow:
+  phases:
+    planning:
+      focus:
+        - Public API 설계
+        - 확장 포인트 정의
+        - 버전 전략
+      deliverables:
+        - service-spec.md
+        - integration-spec.md
+        - glossary.md
+
+    implementation:
+      focus:
+        - 타입 안전한 구현
+        - 문서화 (TSDoc/JSDoc)
+        - 예제 코드
+      validation:
+        - type_check
+        - api_stability
+
+    testing:
+      focus:
+        - 단위 테스트 (100% public API)
+        - 타입 테스트
+        - 번들 크기 테스트
+      coverage_target: 90
+
+    documentation:
+      required: true
+      deliverables:
+        - API 레퍼런스
+        - Getting Started
+        - 예제 코드
+        - 마이그레이션 가이드
+
+    release:
+      checklist:
+        - 버전 번호 확인 (SemVer)
+        - CHANGELOG 업데이트
+        - Breaking Changes 문서화
+        - 타입 정의 확인
+
+# ============================================================
+# 코딩 규칙
+# ============================================================
+coding:
+  typescript:
+    strict: true
+    # 타입 내보내기 필수
+    export_types: required
+    # 제네릭 활용
+    generics: encouraged
+
+  api_design:
+    # 일관된 네이밍
+    naming:
+      functions: camelCase
+      classes: PascalCase
+      constants: UPPER_SNAKE_CASE
+      types: PascalCase
+
+    # 메서드 체이닝 지원
+    fluent_api: encouraged
+
+    # 옵션 객체 패턴
+    options_pattern: required
+
+  documentation:
+    # TSDoc 필수
+    tsdoc: required
+    # 모든 public API 문서화
+    public_api: 100%
+    # 예제 포함
+    examples: required
+
+  bundle:
+    # Tree-shaking 지원
+    tree_shaking: required
+    # ESM + CJS 지원
+    formats: ["esm", "cjs"]
+    # 타입 정의 포함
+    types: required
+    # 번들 크기 제한
+    size_limit: "50kb"  # gzipped
+
+# ============================================================
+# 버전 관리
+# ============================================================
+versioning:
+  strategy: semver
+
+  breaking_changes:
+    # Major 버전에서만
+    allowed_in: major
+    # 마이그레이션 가이드 필수
+    migration_guide: required
+    # Deprecation 기간
+    deprecation_period: "2 minor versions"
+
+  changelog:
+    format: "keep-a-changelog"
+    required: true
+
+# ============================================================
+# 테스트 규칙
+# ============================================================
+testing:
+  required:
+    - unit
+    - type_test
+    - api_stability
+
+  optional:
+    - integration
+    - browser_compatibility
+    - node_version_matrix
+
+  coverage:
+    minimum: 90
+    public_api: 100
+
+  type_testing:
+    tool: "tsd"  # 또는 expect-type
+    required: true
+
+  bundle_testing:
+    size_limit: required
+    tree_shaking_test: required
+
+# ============================================================
+# 품질 기준
+# ============================================================
+quality:
+  # 번들 크기
+  bundle_size:
+    max_gzipped: "50kb"
+    monitor: true
+
+  # 의존성
+  dependencies:
+    minimize: true
+    peer_deps: encouraged
+    audit: required
+
+  # 타입 안전성
+  type_safety:
+    strict_null_checks: true
+    no_any: true
+
+  # 문서화 품질
+  documentation:
+    api_coverage: 100%
+    examples: required
+    changelog: required
+
+# ============================================================
+# 릴리스 규칙
+# ============================================================
+release:
+  registry: npm
+
+  pre_release:
+    checklist:
+      - 모든 테스트 통과
+      - 타입 체크 통과
+      - 번들 크기 확인
+      - CHANGELOG 업데이트
+      - 버전 번호 확인
+
+  publish:
+    dry_run_first: true
+    tag:
+      latest: "stable releases"
+      next: "pre-releases"
+      beta: "beta versions"

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