aiwf 0.3.1 → 0.3.3

package/.aiwf/98_PROMPTS/SAAS_DEVELOPMENT_GUIDE.md

@@ -0,0 +1,302 @@
+# 🚀 AIWF를 활용한 SaaS 개발 Step-by-Step 가이드
+
+## 📋 시나리오: "CloudAnalytics" - B2B 데이터 분석 SaaS 플랫폼 개발
+
+### 🎯 Phase 1: 프로젝트 초기화 및 설정 (Day 1-2)
+
+#### Step 1: AIWF 프로젝트 생성
+```bash
+# 프로젝트 디렉토리 생성 및 AIWF 설치
+mkdir cloudanalytics
+cd cloudanalytics
+npx aiwf@latest
+
+# 언어 선택: 한국어
+# IDE 선택: Claude Code
+```
+
+#### Step 2: 프로젝트 매니페스트 초기화
+```bash
+# Claude Code에서 실행
+/project:aiwf:update_manifest
+
+# 다음 내용 입력:
+# 프로젝트명: CloudAnalytics
+# 설명: B2B 데이터 분석 SaaS 플랫폼
+# 기술스택: Next.js, TypeScript, PostgreSQL, Redis, AWS
+```
+
+#### Step 3: 아키텍처 문서 작성
+```bash
+# 아키텍처 전문가 페르소나 활성화
+/project:aiwf:architect
+
+# 프롬프트:
+"B2B SaaS 플랫폼을 위한 마이크로서비스 아키텍처를 설계해주세요.
+요구사항:
+- 멀티테넌트 지원
+- 실시간 데이터 처리
+- 확장 가능한 API 게이트웨이
+- 보안 및 인증 시스템"
+```
+
+### 🔨 Phase 2: 핵심 기능 개발 (Day 3-14)
+
+#### Step 4: Feature Ledger로 기능 관리
+```bash
+# 첫 번째 기능: 사용자 인증 시스템
+/project:aiwf:create_feature_ledger
+
+# Feature 정보 입력:
+# ID: AUTH-001
+# 제목: 멀티테넌트 인증 시스템
+# 설명: JWT 기반 인증 및 권한 관리
+# 우선순위: Critical
+```
+
+#### Step 5: 백엔드 개발 시작
+```bash
+# 백엔드 전문가 페르소나 활성화
+/project:aiwf:backend
+
+# 프롬프트:
+"AUTH-001 기능을 위한 NestJS 기반 인증 마이크로서비스를 구현해주세요.
+포함사항:
+- JWT 토큰 발급/검증
+- 역할 기반 접근 제어(RBAC)
+- 테넌트 격리
+- Rate limiting"
+```
+
+#### Step 6: Git 커밋과 Feature 연동
+```bash
+# 구현 후 커밋
+git add .
+git commit -m "feat(AUTH-001): JWT 기반 인증 서비스 구현"
+
+# Feature 상태 업데이트
+/project:aiwf:update_feature_status
+# Feature ID: AUTH-001
+# 새 상태: In Progress -> Testing
+```
+
+### 🎨 Phase 3: 프론트엔드 개발 (Day 15-25)
+
+#### Step 7: 프론트엔드 Feature 생성
+```bash
+/project:aiwf:create_feature_ledger
+
+# Feature 정보:
+# ID: UI-001
+# 제목: 대시보드 UI 구현
+# 설명: 실시간 데이터 시각화 대시보드
+```
+
+#### Step 8: 프론트엔드 개발
+```bash
+# 프론트엔드 전문가 페르소나 활성화
+/project:aiwf:frontend
+
+# 프롬프트:
+"UI-001을 위한 Next.js 대시보드를 구현해주세요.
+요구사항:
+- Recharts를 사용한 실시간 차트
+- WebSocket 연결
+- 반응형 디자인
+- 다크모드 지원"
+```
+
+### 🔒 Phase 4: 보안 강화 (Day 26-30)
+
+#### Step 9: 보안 감사
+```bash
+# 보안 전문가 페르소나 활성화
+/project:aiwf:security
+
+# 프롬프트:
+"현재 구현된 시스템의 보안 취약점을 분석하고 개선사항을 제안해주세요.
+중점 검토 영역:
+- API 보안
+- 데이터 암호화
+- OWASP Top 10
+- 컴플라이언스 (SOC2, GDPR)"
+```
+
+### 📊 Phase 5: 데이터 분석 기능 (Day 31-40)
+
+#### Step 10: 데이터 파이프라인 설계
+```bash
+# 데이터 분석가 페르소나 활성화
+/project:aiwf:data_analyst
+
+# 프롬프트:
+"실시간 데이터 분석 파이프라인을 설계해주세요.
+요구사항:
+- Kafka 스트리밍
+- ClickHouse 시계열 DB
+- 머신러닝 모델 통합
+- 실시간 이상 탐지"
+```
+
+### 🚀 Phase 6: 배포 준비 (Day 41-45)
+
+#### Step 11: Context 압축 및 최적화
+```bash
+# 전체 프로젝트 컨텍스트 압축
+/project:aiwf:compress_context
+
+# 압축 모드: Balanced
+# 중요 파일 우선순위 설정
+```
+
+#### Step 12: Feature 대시보드 생성
+```bash
+# 전체 기능 진행상황 리포트
+/project:aiwf:feature_commit_report
+
+# Git 히스토리와 Feature 동기화
+/project:aiwf:sync_feature_commits
+```
+
+### 📝 Phase 7: 문서화 및 릴리스 (Day 46-50)
+
+#### Step 13: 프로젝트 스냅샷 생성
+```bash
+# 현재 상태 스냅샷
+/project:aiwf:snapshot
+
+# 스냅샷 ID: v1.0-release
+# 설명: 첫 번째 정식 릴리스
+```
+
+#### Step 14: 최종 문서 업데이트
+```bash
+/project:aiwf:update_docs
+
+# 자동으로 다음 문서 업데이트:
+- README.md
+- API 문서
+- 배포 가이드
+- 사용자 매뉴얼
+```
+
+## 💡 핵심 활용 팁
+
+### 1. **Feature Ledger 활용 전략**
+```bash
+# 매일 시작 시
+/project:aiwf:list_features --status=in-progress
+
+# 주간 리뷰
+/project:aiwf:feature_dashboard --period=week
+```
+
+### 2. **AI 페르소나 전환 시나리오**
+- **아침**: `/project:aiwf:architect` - 전체 구조 검토
+- **개발 중**: `/project:aiwf:backend` 또는 `/project:aiwf:frontend`
+- **코드 리뷰**: `/project:aiwf:security` - 보안 검토
+- **성능 최적화**: `/project:aiwf:data_analyst` - 병목 분석
+
+### 3. **Context 관리 전략**
+```bash
+# 대규모 리팩토링 전
+/project:aiwf:compress_context --mode=aggressive
+
+# 새로운 개발자 온보딩
+/project:aiwf:compress_context --mode=minimal --target=onboarding
+```
+
+### 4. **Git 워크플로우 통합**
+```bash
+# Feature 브랜치 생성 시
+git checkout -b feature/AUTH-001
+/project:aiwf:create_feature_ledger
+
+# PR 생성 전
+/project:aiwf:feature_commit_report --feature=AUTH-001
+```
+
+## 📊 예상 결과
+
+### 개발 효율성 향상
+- **토큰 사용량**: 53% 감소
+- **개발 속도**: 40% 향상
+- **버그 발생률**: 60% 감소
+- **문서화 시간**: 70% 절약
+
+### 프로젝트 관리 개선
+- 모든 기능의 실시간 추적
+- Git 커밋과 자동 연동
+- AI 페르소나별 전문적 조언
+- 체계적인 프로젝트 히스토리
+
+## 🎯 실제 사용 시나리오 예시
+
+### 시나리오 1: 버그 수정
+```bash
+# 1. 버그 리포트 접수
+/project:aiwf:create_feature_ledger
+# ID: BUG-042
+# 제목: 대시보드 로딩 지연 문제
+
+# 2. 데이터 분석가로 성능 분석
+/project:aiwf:data_analyst
+"대시보드 로딩 성능을 분석하고 병목 지점을 찾아주세요"
+
+# 3. 백엔드 전문가로 최적화
+/project:aiwf:backend
+"쿼리 최적화와 캐싱 전략을 구현해주세요"
+
+# 4. 수정 완료 후
+git commit -m "fix(BUG-042): 대시보드 로딩 성능 개선"
+/project:aiwf:update_feature_status
+# Status: Resolved
+```
+
+### 시나리오 2: 새 기능 추가
+```bash
+# 1. 기획 단계
+/project:aiwf:architect
+"실시간 협업 기능을 위한 WebRTC 아키텍처를 설계해주세요"
+
+# 2. Feature 생성
+/project:aiwf:create_feature_ledger
+# ID: FEAT-015
+# 제목: 실시간 협업 도구
+
+# 3. 구현
+/project:aiwf:backend
+"WebRTC 시그널링 서버를 구현해주세요"
+
+/project:aiwf:frontend
+"협업 UI 컴포넌트를 구현해주세요"
+
+# 4. 보안 검토
+/project:aiwf:security
+"WebRTC 구현의 보안 취약점을 검토해주세요"
+```
+
+## 📈 프로젝트 진행 모니터링
+
+### 일일 체크리스트
+- [ ] Feature 상태 확인: `/project:aiwf:list_features`
+- [ ] 진행 중인 작업 검토
+- [ ] 블로커 확인 및 해결
+- [ ] Git 커밋과 Feature 동기화
+
+### 주간 리뷰
+- [ ] Feature 대시보드 생성
+- [ ] 완료된 기능 검토
+- [ ] 다음 주 계획 수립
+- [ ] Context 압축 실행
+
+### 마일스톤 완료 시
+- [ ] 프로젝트 스냅샷 생성
+- [ ] 전체 문서 업데이트
+- [ ] 성과 지표 분석
+- [ ] 다음 마일스톤 계획
+
+---
+
+*이 가이드는 AIWF v0.3.0 기준으로 작성되었습니다.*
+*최신 버전에서는 일부 명령어가 변경될 수 있습니다.*

package/.aiwf/98_PROMPTS/github_integration.md

@@ -0,0 +1,130 @@
+# GitHub Integration with AIWF Framework
+
+This document provides guidance on integrating GitHub issues and pull requests with the AIWF task management system.
+
+## Overview
+
+The AIWF framework now supports seamless integration with GitHub issues and pull requests, enabling better tracking and collaboration through the `gh` CLI tool.
+
+## Key Features
+
+### 1. Task-Issue Linking
+
+- Each task can be linked to a GitHub issue via the `github_issue` field in frontmatter
+- Automatic status synchronization between tasks and issues
+- Bidirectional updates ensure consistency
+
+### 2. Automated Workflows
+
+- Create GitHub issues from tasks: `/project:aiwf:issue_create {task_id}`
+- Generate pull requests with issue linking: `/project:aiwf:pr_create {task_id}`
+- Commit messages automatically include issue references
+
+### 3. Status Management
+
+- Task status changes trigger GitHub issue updates
+- Issues are labeled based on task status (in-progress, completed, etc.)
+- Comments are added to issues for transparency
+
+## Commands Reference
+
+### Issue Creation
+
+```bash
+/project:aiwf:issue_create {task_id}
+```
+
+Creates a GitHub issue from a task file with:
+
+- Title including task ID
+- Description from task content
+- Appropriate labels
+- Automatic assignment
+
+### Pull Request Creation
+
+```bash
+/project:aiwf:pr_create {task_id}
+```
+
+Creates a pull request that:
+
+- Links to the associated issue
+- Includes commit history
+- Auto-closes issue on merge
+- Assigns reviewers
+
+### Manual GitHub Commands
+
+Update issue status:
+
+```bash
+gh issue comment {issue_number} --body "Status update message"
+gh issue edit {issue_number} --add-label "label-name"
+```
+
+Create issue manually:
+
+```bash
+gh issue create \
+  --title "Task: Description" \
+  --body "Detailed description" \
+  --label "task,sprint-01"
+```
+
+## Best Practices
+
+### 1. Issue Creation Timing
+
+- Create issues when starting a sprint
+- Link issues immediately after creation
+- Update frontmatter with issue number
+
+### 2. Commit Messages
+
+- Use `fixes #123` for bug fixes
+- Use `relates to #123` for partial work
+- Include task ID in commit message
+
+### 3. Pull Request Workflow
+
+- Create PR after task completion
+- Ensure all tests pass
+- Link to original issue
+- Request appropriate reviewers
+
+## Integration Points
+
+### Task Files
+
+Add to frontmatter:
+
+```yaml
+github_issue: #123
+```
+
+### Sprint Planning
+
+- Create issues for all tasks at sprint start
+- Use labels to group by sprint
+- Track progress via GitHub Projects
+
+### YOLO Mode
+
+- Automatically creates issues if enabled
+- Creates PRs after successful commits
+- Maintains full automation flow
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Missing gh CLI**: Install GitHub CLI first
+2. **Authentication**: Run `gh auth login`
+3. **Permissions**: Ensure repo access rights
+
+### Error Handling
+
+- Check task file for valid issue number
+- Verify GitHub API limits
+- Ensure branch protection rules allow automation

package/.aiwf/98_PROMPTS/useful-prompts.md

@@ -0,0 +1,31 @@
+# 유용한 프롬프트
+
+## 프로젝트 분석
+
+[Ask, sonnet4 그리고 o3 연속으로..]
+
+```
+이 프로젝트 구조를 자세히 파악해줘
+코드 컨벤션 스타일 디자인 규칙을 모두 분석해서 자세히 설명해줘
+```
+
+## 커서 Rule 생성
+
+[Agent, sonnet4]
+
+```
+/Generate Cursor Rules
+위의 분석한 내용을 기반으로 rule 만들어줘
+내용은 영어로 작성해.
+대표적인 프롬프트 엔지니어링 기법을 적용해서 최적화해줘.
+반드시 지켜야할 규칙, 반드시 하지말아야할 것들을 특히 강조해서 적어줘.
+```
+
+[Agent, sonnet4]
+
+```
+/Generate Cursor Rules
+지금까지 너는 실수를 했지이 실수의 원인을 자세히 분석하고, 로 작성해.
+대표적인 프롬프트 엔지니어링 기법을 적용해서 최적화해줘.
+반드시 지켜야할 규칙, 반드시 하지말아야할 것들을 특히 강조해서 적어줘.
+```

package/.aiwf/98_PROMPTS/vibe-front-prompts.md

@@ -0,0 +1,89 @@
+# VIBE 코딩 프론트엔드 프롬프트
+
+https://github.com/roboco-io/handson-vibecoding-demo
+
+## STEP1
+
+지금부터 간단한 앱을 만드는 것을 데모로 보여주려 고해. TODO앱을 웹 앱으로 만들려고해. 우선 docs 폴더 아래에 요건 정의를 문서화 해 줘. 요건정의를 위해서 필요한 질문들을 포함해줘.
+
+- requirements.md 리뷰
+- .windsurfrules 생성
+
+@requirements.md 참고해서 설계문서 작성을 진행해줘
+
+- design.dm 리뷰
+  mermaid -> svg 로 설계문서를 작성
+
+@design.md 에서 아키텍처 다이어그램은 SVG를 사용해서 정확하고 상서하게 그려줘.
+
+리퀘스트 처리 부분에 대해서 시퀀스 다이어 그램을 추가해줘. 시퀀스 다이어그램은 mermaid 로 그려줘
+
+UI 설계에서 모바일뷰와 데스크톱 뷰의 와이어프레임도 SVG로 생성해줘
+
+카드뷰 보다는 리스트로 표시해줘
+
+@design.md 문서에 기반해서 앞으로 수행해 야 할 작업들을 순서대로 체크리스트로 만들어 줘. UI/UX를 제외한 코어 비즈니스 로직은 TDD 에 기반해서 작업해야해. 작업이 확인 가능한 단 위별로 커밋 포인트도 체크리스트에 표시해줘.
+
+## STEP2
+
+나는 좀 더 간편한 UI Kit을 사용해서 프론트를 구현하고 싶어. 어떤 UI Kit이 좋을까?
+
+Mantine 을 사용해서 UI를 구현하도록 요건과 설계문서를 업데이트 해줘
+
+@implementation-checklist.md 의 이름을 checklist.md 로 바꿔줘
+
+업데이트된 @design.md 내용에 맞춰서 @checklist.md 를 업데이트 해줘
+
+Windsurf rules 수정 :
+
+- 커뮤니케이션은 한국어로 해줘
+- 프론트엔드 UI 구현시에는 실행 코드를 먼저 작성한다. 코어 비즈니스 로직 구현 시에만 TDD로 진행 할 것.
+- 백엔드는 TDD로 구현할 것
+- 커밋 전에 docs/checklist.md에 진행상황을 업데이트 한다.
+- 설계 변경시에는 requirements.md 와 design.md 를 수정한다.
+
+업데이트 된 계획들을 커밋해줘
+
+이제 체크리스트 항목을 시작해줘
+
+프로젝트 설명을 위한 README 를 root 폴더에 만들어줘
+
+[자동화]
+Rules 파일은 자동화에 큰 역할을 담당한다
+Awesome cursor rules 를 참고해서 업데이트 해야한다
+
+@web https://github.com/PatrickJS/awesome-cursorrules/blob/main/rules/nextjs15-react19-vercelai-tailwind-cursorrules-prompt-file/.cursorrules 참고해서 이 프로젝트의 아키텍처와 요구사항 edesign.md, erequirements.nd 을 반영한 규칙 파일을 edocs 에 windsurfruels.md 에 만들어줘
+
+git hook을 이용해서 커밋시에 Iint fix, build, test가 자동으로 수행되도록 하고싶어. 실행 코드에 변경시에만 작동되어야 해.
+우선은 프론트에 대해서 적용해줘
+
+체크리스트에 방금 작업한 내용을 반영해줘. 설계문서와 README 에도 반영해줘
+
+변경사항을 커밋해줘
+
+@pre-commit 을 수정해서 좀 더 디테일한 로그를 남겨서 디버깅을 용이하게 해줘
+
+## STEP3
+
+[P] 나는 프른트 개발을 독립적으로 완료하고 그 다음 백엔드에 연결하는 방식으로 개발을 하고 싶어.
+
+- 관련 체크리스트 조정됨
+
+[P] 체크리스트에 따라서 다음 작업을 진행해줘
+
+- lint 작성확인
+- npm run lint
+
+[P] 이제부터 mantain v7 으로 UI를 구현해줘. 최신버전의 사용법은 @web https://mantine.dev 를 참고해서 구현해줘
+(시안 이미지 복붙후)
+이미지를 참고해서 모바일과 데스크톱 모두 대응되는 반응형 디자인으로 작성해줘.
+이미지는 와이어프레임 이므로 배치만 참고해줘
+
+- 공식문서 파일들을 rules에 업데이트 하자
+- 관련 MCP도 업데이트 되고 있으니 참고하자
+
+@checklist.md 에 데모로서 불필요한 부분을 삭제했어. 삭제된 내용을 @requirements.md, @design.md 에 반영해줘.
+
+@checklist.md 를 보고 다음 구현을 진행해줘. 우선 브라우저 전체 너비를 사용 하도록 레이아웃을 조정해줘. 현재 코드는 고정폭을 사용하고 있어. 수정 하기 전에 관련 코드를 먼저 꼼꼼히 살펴보고 수정을 계획을 세운다음 나에게 확인을 받고 진행 해.
+
+- 중간에 헤맬때는 조사를 하라고 시키면 좋다

package/.aiwf/99_TEMPLATES/adr_template.md

@@ -0,0 +1,49 @@
+---
+adr_id: ADR{{number}}
+title: "{{title}}"
+status: "proposed" # proposed | accepted | deprecated | superseded
+date: {{YYYY-MM-DD}}
+authors: ["{{author}}"]
+---
+
+# ADR{{number}}: {{title}}
+
+## Status
+
+{{status}} - {{YYYY-MM-DD}}
+
+## Context
+
+{{What is the issue that we're seeing that is motivating this decision or change?}}
+
+## Decision
+
+{{What is the change that we're proposing or have agreed to implement?}}
+
+## Consequences
+
+### Positive
+
+- {{e.g., improvement of quality attribute satisfaction, follows the architectural principles, ...}}
+
+### Negative
+
+- {{e.g., compromising quality attribute, follows the architectural principles, ...}}
+
+## Alternatives Considered
+
+### {{Alternative 1}}
+
+{{Description and reasoning for why this was not chosen}}
+
+### {{Alternative 2}}
+
+{{Description and reasoning for why this was not chosen}}
+
+## Implementation Notes
+
+{{Any specific implementation details, migration steps, or technical considerations}}
+
+## Related
+
+- {{Links to related ADRs, issues, or documentation}}