aiwf 0.1.0 → 0.3.1

package/CHANGELOG.md

@@ -1 +1,47 @@
 # Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### New Features
+
+- 🌐 **Multilingual Support System** - Complete English/Korean dual language support with automatic language detection
+- 🔧 **Advanced Installation System** - Validation, backup, and rollback capabilities
+- 🧪 **Testing Infrastructure** - Jest-based automated testing framework
+- 📚 **Project Documentation** - Architecture, manifest, and guide documentation
+- 🎯 **Language Management Commands** - language_manager, language_status, switch_language
+
+### Improvements
+
+- 📦 **Command Standardization** - Unified terminology and quality improvements for all Korean commands
+- 🔄 **Installation Process** - Multi-step installation with enhanced user experience
+- 📖 **Documentation Structure** - Language synchronization and consistency improvements
+
+### Bug Fixes
+
+- 🧹 **Code Cleanup** - Removed duplicate and deprecated commands
+- ⚠️ **Installation Issues** - Fixed GitHub repository path and CLI permissions
+- 🔧 **Command Consistency** - Resolved synchronization issues between language versions
+
+## [0.3.0] - 2024-12-20
+
+### Features
+
+- 🌍 **Multi-language Support** - Language selection during installation (English/Korean)
+- 📝 **Changelog Command** - Automatic generation from Git history
+- 🔔 **Developer Hooks** - Automated testing and completion notifications
+
+### Enhancements
+
+- 📚 **Documentation** - Updated README and unified guides
+- 🔧 **Configuration** - Pre-commit hooks and automated workflows
+
+### Technical Requirements
+
+- Node.js 14.0.0+ required
+- GitHub API integration for real-time updates
+- Claude Code, Cursor, Windsurf IDE support

package/CLAUDE.md

@@ -0,0 +1,19 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is **aiwf** (AI Workflow Framework), an NPM package that installs the AIWF project management framework for AI-assisted development. It's an updated version of the Simone framework, specifically designed for Claude Code integration.
+
+## Changelog Guidelines
+
+- **Changelog Best Practices**: Always summarize changes concisely by feature or component
+- Aim for clear, brief descriptions that highlight the key modifications in each update
+- Group changes by type: Added, Changed, Fixed, Removed
+- Provide context for significant changes without unnecessary details
+- Always use English
+
+## Core Architecture
+
+[... rest of the existing content remains unchanged ...]

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 moonklabs
+Copyright (c) 2025 aiwf
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.ko.md

@@ -1,28 +1,32 @@
-# aiwf
+# AIWF (AI Workflow Framework)
 
-이 프로젝트는 [Simone](https://github.com/Helmi/claude-simone)의 업데이트된 버전입니다.
+[Read in Korean (한국어로 보기)](README.ko.md)
 
-> 🚀 Claude Code용 Moonklabs 프로젝트 관리 프레임워크를 위한 빠른 설치 프로그램
+[![NPM Version](https://img.shields.io/npm/v/aiwf.svg)](https://www.npmjs.com/package/aiwf)
+[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/aiwf/aiwf/blob/main/LICENSE)
+[![Downloads](https://img.shields.io/npm/dm/aiwf.svg)](https://www.npmjs.com/package/aiwf)
 
-## Moonklabs Framework란 무엇인가요?
+## AIWF란?
 
-Moonklabs는 Claude Code를 사용한 AI 지원 개발을 위해 특별히 설계된 마크다운 기반 프로젝트 관리 프레임워크입니다. 소프트웨어 프로젝트를 관리 가능한 덩어리로 나누어 효과적인 AI 처리를 돕습니다.
+AIWF는 Claude Code와 함께 AI 기반 개발을 위해 특별히 설계된 마크다운 기반 프로젝트 관리 프레임워크입니다. 소프트웨어 프로젝트를 AI가 효과적으로 처리할 수 있는 관리 가능한 단위로 분해하여 생산성을 극대화합니다.
+이 프로젝트는 [Simone](https://github.com/Helmi/claude-simone)의 업데이트된 버전입니다.
 
-## 설치
+## 📦 설치
 
-모든 프로젝트 디렉토리에 Moonklabs를 설치하세요:
+프로젝트 디렉토리에서 AIWF 설치:
 
 ```bash
 npx aiwf
 ```
 
-이것으로 끝입니다! 설치 프로그램은 다음을 수행합니다:
+설치 프로그램의 동작:
 
-- 프로젝트 관리를 위한 `.moonklabs/` 디렉토리 구조 생성
-- 사용자 지정 Claude 명령어를 위한 `.claude/commands/moonklabs/` 설정
-- 최신 템플릿 및 문서 다운로드
+1. **언어 선택**: 한국어와 영어 중 선택
+2. **디렉토리 구성**: 프로젝트 관리를 위한 `.aiwf/` 디렉토리 구조 생성
+3. **명령어 설치**: 선택한 언어의 `.claude/commands/aiwf/` Claude 명령어 설정
+4. **콘텐츠 다운로드**: 선택한 언어의 최신 템플릿과 문서 다운로드
 
-## 사용법
+## 🚀 사용법
 
 ### 첫 설치
 
@@ -32,7 +36,7 @@ npx aiwf
 
 ### 기존 설치 업데이트
 
-Moonklabs가 이미 설치된 경우, 설치 프로그램이 이를 감지하고 다음 옵션을 제공합니다:
+AIWF가 이미 설치되어 있다면 설치 프로그램이 자동으로 감지하고 다음 옵션을 제공합니다:
 
 - 업데이트 (자동 백업 포함)
 - 설치 건너뛰기
@@ -40,76 +44,100 @@ Moonklabs가 이미 설치된 경우, 설치 프로그램이 이를 감지하고
 
 ### 강제 설치
 
-모든 프롬프트를 건너뛰고 강제로 설치합니다:
+모든 프롬프트를 건너뛰고 강제 설치 (기본값: 한국어):
 
 ```bash
 npx aiwf --force
 ```
 
-## 설치되는 항목
+### 언어별 설치
+
+설치 프로그램은 선택한 언어에 따라 적절한 언어 버전을 자동으로 선택합니다:
+
+- 한국어 버전: 한국어 명령어와 문서 포함 (기본값)
+- English version: English commands and documentation
+
+## 📁 설치 내용
+
+### 디렉토리 구조
 
 ```
-aiwf/
-├── AI-WORKFLOW.md
-├── CHANGELOG.md
-├── claude-code/
-│   ├── docker/
-│   │   └── Dockerfile
-│   ├── moonklabs/
-│   └── simone/
-│       ├── CHANGELOG.md
-│       ├── LICENSE
-│       ├── README.md
-│       ├── SYNC_GUIDE.md
-│       └── sync-simone.sh
-├── COMMANDS_GUIDE.md
-├── LICENSE
-├── package-lock.json
-├── package.json
-├── PRD.ko.md
-├── PRD.md
-├── README.ko.md
-├── README.md
-└── rules/
-    ├── global/
-    │   ├── code-style-guide.md
-    │   ├── coding-principles.md
-    │   ├── development-process.md
-    │   └── global-rules.md
-    └── manual/
-        └── generate-plan-docs.md
+your_project/
+├── .aiwf/                        # 프로젝트 관리 루트
+│   ├── 00_PROJECT_MANIFEST.md    # 중앙 추적 문서
+│   ├── 01_PROJECT_DOCS/          # 프로젝트 문서
+│   ├── 02_REQUIREMENTS/          # 마일스톤 요구사항
+│   ├── 03_SPRINTS/              # 스프린트 실행 추적
+│   ├── 04_GENERAL_TASKS/        # 독립 작업
+│   ├── 05_ARCHITECTURE_DECISIONS/ # ADR 문서
+│   ├── 10_STATE_OF_PROJECT/     # 프로젝트 상태 스냅샷
+│   ├── 98_PROMPTS/              # 유용한 AI 프롬프트
+│   └── 99_TEMPLATES/            # 문서 템플릿
+├── .claude/commands/aiwf/       # 언어별 Claude 명령어
+├── .cursor/rules/               # Cursor IDE 개발 규칙
+└── .windsurf/rules/             # Windsurf IDE 개발 규칙
 ```
 
-## 다음 단계
+### 언어별 콘텐츠
+
+선택한 언어에 따라 다음이 설치됩니다:
+
+**한국어 버전 (`ko/`)** (기본값):
+
+- 한국어 Claude 명령어 (`_kr` 접미사 포함)
+- 한국어 문서 및 템플릿
+- 현지화된 프로젝트 관리 콘텐츠
+
+**English Version (`en/`)**:
+
+- English Claude commands
+- English documentation and templates
+- Standard project management content
+
+## 🎯 시작하기
+
+설치 후 다음 단계:
+
+1. Claude Code에서 프로젝트를 엽니다
+2. `/project:aiwf` 명령어를 사용하여 프로젝트를 관리합니다
+3. `/project:aiwf:initialize` 명령어로 프로젝트 설정을 시작합니다
 
-설치 후:
+### 주요 명령어
 
-1.  Claude Code에서 프로젝트를 엽니다
-2.  `/project:moonklabs` 명령어를 사용하여 프로젝트를 관리합니다
-3.  `/project:moonklabs:initialize`로 시작하여 프로젝트를 설정합니다
+- **초기화**: `/project:aiwf:initialize` - 프로젝트 초기 설정
+- **계획**: `/project:aiwf:plan_milestone` - 마일스톤 계획 수립
+- **스프린트**: `/project:aiwf:create_sprints_from_milestone` - 스프린트 생성
+- **작업**: `/project:aiwf:do_task` - 작업 실행
+- **리뷰**: `/project:aiwf:code_review` - 코드 리뷰
+- **GitHub 연동**: `/project:aiwf:issue_create`, `/project:aiwf:pr_create`
 
-## 명령어 가이드
+## 📚 문서 참조
 
-Moonklabs의 전체 명령어 목록과 자세한 사용법은 [COMMANDS_GUIDE.md](COMMANDS_GUIDE.md) 문서를 참고하세요.
+전체 AIWF 명령어 목록과 자세한 사용법은 [COMMANDS_GUIDE.md](docs/COMMANDS_GUIDE.md)를 참조하세요.
 
-## 특징
+## ✨ 주요 기능
 
-- 🎨 색상과 진행 표시기가 있는 아름다운 CLI
-- 🔄 자동 백업 기능이 있는 스마트 업데이트 감지
-- 📦 공식 GitHub 리포지토리에서 직접 다운로드
-- 🚀 `npx`로 작동 - 전역 설치 필요 없음
-- 💾 업데이트 시 타임스탬프가 찍힌 백업 생성
+- 🌍 **다국어 지원** - 한국어와 영어 완전 지원
+- 🎨 **아름다운 CLI** - 컬러와 진행 표시기가 있는 사용자 친화적 인터페이스
+- 🔄 **스마트 업데이트** - 자동 백업과 함께 지능형 업데이트 감지
+- 📦 **직접 다운로드** - 공식 GitHub 저장소에서 직접 다운로드
+- 🚀 **간편한 사용** - `npx` 사용으로 전역 설치 불필요
+- 💾 **안전한 백업** - 업데이트 시 타임스탬프 백업 생성
+- 🎯 **언어별 맞춤** - 언어별 명령어와 문서
+- 🔧 **IDE 통합** - Cursor와 Windsurf 개발 규칙 지원
+- 🔗 **GitHub 연동** - 이슈 및 PR 생성 자동화
+- 📊 **프로젝트 추적** - 마일스톤, 스프린트, 작업 체계적 관리
 
-## 요구사항
+## 🔧 요구사항
 
 - Node.js 14.0.0 이상
 - GitHub에서 다운로드하기 위한 인터넷 연결
 
-## 소스
+## 📖 소스
 
-이 설치 프로그램은 다음에서 Moonklabs 프레임워크를 가져옵니다:
-https://github.com/moonklabs/aiwf
+이 설치 프로그램은 다음에서 AIWF 프레임워크를 가져옵니다:
+https://github.com/aiwf/aiwf
 
-## 라이선스
+## 📝 라이선스
 
 MIT

package/README.md

@@ -1,30 +1,34 @@
-[Read in Korean (한국어로 보기)](README.ko.md)
+# AIWF (AI Workflow Framework)
 
-# aiwf
+[Read in Korean (한국어로 보기)](README.ko.md)
 
-This project is an updated version of [Simone](https://github.com/Helmi/claude-simone).
+[![NPM Version](https://img.shields.io/npm/v/aiwf.svg)](https://www.npmjs.com/package/aiwf)
+[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/aiwf/aiwf/blob/main/LICENSE)
+[![Downloads](https://img.shields.io/npm/dm/aiwf.svg)](https://www.npmjs.com/package/aiwf)
 
-> 🚀 Quick installer for the Moonklabs project management framework for Claude Code
+## What is AIWF?
 
-## What is Moonklabs?
+AIWF is a markdown-based project management framework designed specifically for AI-assisted development with Claude Code. It helps break down software projects into manageable units that AI can effectively handle, maximizing productivity.
 
-Moonklabs is a markdown-based project management framework designed specifically for AI-assisted development with Claude Code. It helps break down software projects into manageable chunks for effective AI handling.
+This project is an updated version of [Simone](https://github.com/Helmi/claude-simone).
 
-## Installation
+## 📦 Installation
 
-Install Moonklabs in any project directory:
+Install AIWF in any project directory:
 
 ```bash
 npx aiwf
 ```
 
-That's it! The installer will:
+The installer will:
 
-- Create the `.moonklabs/` directory structure for project management
-- Set up `.claude/commands/moonklabs/` for custom Claude commands
-- Download the latest templates and documentation
+1. **Intelligent Language Detection**: Automatically detect your system language or let you choose
+2. **Language Preference Storage**: Save your language preference for future installations
+3. **Directory Setup**: Create the `.aiwf/` directory structure for project management
+4. **Commands**: Set up `.claude/commands/aiwf/` with localized Claude commands
+5. **Content**: Download the latest templates and documentation in your selected language
 
-## Usage
+## 🚀 Usage
 
 ### First Time Installation
 
@@ -34,84 +38,127 @@ npx aiwf
 
 ### Update Existing Installation
 
-If Moonklabs is already installed, the installer will detect it and offer options to:
+If AIWF is already installed, the installer will automatically detect it and offer options to:
 
 - Update (with automatic backup)
 - Skip installation
 - Cancel
 
+### Language Management
+
+AIWF includes a sophisticated language management system:
+
+```bash
+# Check current language settings
+aiwf-lang status
+
+# Change language interactively
+aiwf-lang set
+
+# Set specific language
+aiwf-lang set ko    # Korean
+aiwf-lang set en    # English
+
+# Reset to auto-detection
+aiwf-lang reset
+```
+
 ### Force Installation
 
-Skip all prompts and force installation:
+Skip all prompts and force installation (uses auto-detected language):
 
 ```bash
 npx aiwf --force
 ```
 
-## What Gets Installed
+### Language-Specific Installation
 
+The installer automatically selects the appropriate language version based on your choice:
+
+- English version: English commands and documentation (default)
+- Korean version: Korean commands and documentation
+
+## 📁 What Gets Installed
+
+### Directory Structure
+
+```text
+your_project/
+├── .aiwf/                        # Project management root
+│   ├── 00_PROJECT_MANIFEST.md    # Central tracking document
+│   ├── 01_PROJECT_DOCS/          # Project documentation
+│   ├── 02_REQUIREMENTS/          # Milestone requirements
+│   ├── 03_SPRINTS/              # Sprint execution tracking
+│   ├── 04_GENERAL_TASKS/        # Standalone tasks
+│   ├── 05_ARCHITECTURE_DECISIONS/ # ADR documents
+│   ├── 10_STATE_OF_PROJECT/     # Project state snapshots
+│   ├── 98_PROMPTS/              # Useful AI prompts
+│   └── 99_TEMPLATES/            # Document templates
+├── .claude/commands/aiwf/       # Language-specific Claude commands
+├── .cursor/rules/               # Cursor IDE development rules
+└── .windsurf/rules/             # Windsurf IDE development rules
 ```
-aiwf/
-├── AI-WORKFLOW.md
-├── CHANGELOG.md
-├── claude-code/
-│   ├── docker/
-│   │   └── Dockerfile
-│   ├── moonklabs/
-│   └── simone/
-│       ├── CHANGELOG.md
-│       ├── LICENSE
-│       ├── README.md
-│       ├── SYNC_GUIDE.md
-│       └── sync-simone.sh
-├── COMMANDS_GUIDE.md
-├── LICENSE
-├── package-lock.json
-├── package.json
-├── PRD.ko.md
-├── PRD.md
-├── README.ko.md
-├── README.md
-└── rules/
-    ├── global/
-    │   ├── code-style-guide.md
-    │   ├── coding-principles.md
-    │   ├── development-process.md
-    │   └── global-rules.md
-    └── manual/
-        └── generate-plan-docs.md
-```
 
-## Next Steps
+### Language-Specific Content
+
+Based on your language selection, you'll get:
+
+**English Version (`en/`)** (Default):
+
+- English Claude commands
+- English documentation and templates
+- Standard project management content
+
+**Korean Version (`ko/`)**:
+
+- Korean Claude commands (with `_kr` suffix available)
+- Korean documentation and templates
+- Localized project management content
+
+## 🎯 Getting Started
 
 After installation:
 
 1. Open your project in Claude Code
-2. Use `/project:moonklabs` commands to manage your project
-3. Start with `/project:moonklabs:initialize` to set up your project
+2. Use `/project:aiwf` commands to manage your project
+3. Start with `/project:aiwf:initialize` to set up your project
+
+### Key Commands
+
+- **Initialize**: `/project:aiwf:initialize` - Initial project setup
+- **Plan**: `/project:aiwf:plan_milestone` - Create milestone plans
+- **Sprint**: `/project:aiwf:create_sprints_from_milestone` - Generate sprints
+- **Task**: `/project:aiwf:do_task` - Execute tasks
+- **Review**: `/project:aiwf:code_review` - Code review
+- **GitHub Integration**: `/project:aiwf:issue_create`, `/project:aiwf:pr_create`
 
-## Command Reference
+## 📚 Documentation
 
-For a full list of available Moonklabs commands and detailed usage, see [COMMANDS_GUIDE.md](COMMANDS_GUIDE.md).
+For a complete list of AIWF commands and detailed usage, see [COMMANDS_GUIDE.md](docs/COMMANDS_GUIDE.md).
 
-## Features
+## ✨ Features
 
-- 🎨 Beautiful CLI with colors and progress indicators
-- 🔄 Smart update detection with automatic backups
-- 📦 Downloads directly from the official GitHub repository
-- 🚀 Works with `npx` - no global installation needed
-- 💾 Creates timestamped backups when updating
+- 🌍 **Multi-language Support** - Complete English and Korean support
+- 🎨 **Beautiful CLI** - User-friendly interface with colors and progress indicators
+- 🔄 **Smart Updates** - Intelligent update detection with automatic backups
+- 📦 **Direct Download** - Downloads directly from official GitHub repository
+- 🚀 **Easy to Use** - Works with `npx` - no global installation needed
+- 💾 **Safe Backups** - Creates timestamped backups when updating
+- 🎯 **Language-Specific** - Language-specific commands and documentation
+- 🔧 **IDE Integration** - Cursor and Windsurf development rules support
+- 🔗 **GitHub Integration** - Automated issue and PR creation
+- 📊 **Project Tracking** - Systematic management of milestones, sprints, and tasks
 
-## Requirements
+## 🔧 Requirements
 
 - Node.js 14.0.0 or higher
 - Internet connection to download from GitHub
 
-## Source
+## 📖 Source
 
-This installer fetches the Moonklabs framework from:
-https://github.com/moonklabs/aiwf
+This installer fetches the AIWF framework from:
+<https://github.com/aiwf/aiwf>
 
-## License
+## 📝 License
 
 MIT

package/claude-code/{simone/.simone → aiwf/en/.aiwf}/01_PROJECT_DOCS/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Demo Project Architecture (EXAMPLE)
 
-This document outlines the high-level architecture of the Demo Project. **This is an example document to demonstrate how architecture might be documented in the Simone framework.**
+This document outlines the high-level architecture of the Demo Project. **This is an example document to demonstrate how architecture might be documented in the AIWF framework.**
 
 ## System Overview
 

package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md

@@ -8,6 +8,7 @@ last_updated: 2023-07-10
 # Milestone: Backend Setup (EXAMPLE)
 
 ## Goals
+
 This milestone focuses on establishing the core backend infrastructure for the project, including:
 
 1. Setting up the initial project structure
@@ -16,11 +17,13 @@ This milestone focuses on establishing the core backend infrastructure for the p
 4. Establishing authentication and authorization systems
 
 ## Key Documents
+
 - [Product Requirements Document](./PRD_Backend_Setup.md)
 - [API Specifications V1](./SPECS_API_V1.md)
 - [Auth Flow Update Amendment](./PRD_AMEND_01_Auth_Flow_Update.md)
 
 ## Definition of Done (DoD)
+
 This milestone will be considered complete when:
 
 - The backend server can be started and responds to API requests
@@ -30,7 +33,8 @@ This milestone will be considered complete when:
 - Integration tests are passing for all endpoints
 
 ## Notes / Context
-This is an example milestone document to demonstrate how milestones might be structured in a project using the Simone framework. The backend infrastructure established here would be the foundation for a typical web application.
+
+This is an example milestone document to demonstrate how milestones might be structured in a project using the AIWF framework. The backend infrastructure established here would be the foundation for a typical web application.
 
 ## Related Sprints
 

package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md

@@ -6,7 +6,7 @@
 
 This amendment updates the authentication flow requirements to incorporate OAuth 2.0 support for social logins in addition to the existing email/password authentication.
 
-**Note: This is an example amendment document to demonstrate how requirement changes might be tracked in the Simone framework.**
+**Note: This is an example amendment document to demonstrate how requirement changes might be tracked in the AIWF framework.**
 
 ## Changes to Product Requirements
 
@@ -23,12 +23,14 @@ This amendment updates the authentication flow requirements to incorporate OAuth
 **Updated FR-2.1 (User model):**
 
 Add the following fields to the User model:
+
 - `oauth_provider`: string (null, 'google', 'github')
 - `oauth_id`: string (provider-specific user ID)
 
 ### API Endpoints (FR-3)
 
 **Added Endpoints to FR-3.1:**
+
 - GET /api/auth/oauth/google (Redirect URL for Google OAuth)
 - GET /api/auth/oauth/github (Redirect URL for GitHub OAuth)
 - GET /api/auth/oauth/callback (OAuth provider callback)
@@ -36,9 +38,11 @@ Add the following fields to the User model:
 ## Changes to Non-Functional Requirements
 
 **Updated NFR-5:**
+
 - NFR-5: The system shall implement JWT-based authentication with support for OAuth 2.0 providers
 
 **Added NFR:**
+
 - NFR-9: The system shall securely store OAuth provider credentials in environment variables
 
 ## Implementation Impact

package/claude-code/{simone/.simone/03_SPRINTS/CLAUDE.MD → aiwf/en/.aiwf/03_SPRINTS/CLAUDE.md}

@@ -35,7 +35,7 @@ Update status as progress occurs:
 
 - planning → in_progress → review → complete
 
-Always use the template at `.simone/99_TEMPLATES/sprint_template.md` when creating new sprint meta files.
+Always use the template at `.AIWF/99_TEMPLATES/sprint_template.md` when creating new sprint meta files.
 
 ## Sprint Tasks
 
@@ -47,16 +47,37 @@ Tasks within a sprint follow a standard format:
   - Update status to "done"
   - Rename file from T... to TX... (e.g., `TX01_S01_Task_Name.md`)
   - Update Output Log with final entry
+  - If GitHub issue is linked, update issue status
 
-Always use the template at `.simone/99_TEMPLATES/task_template.md` when creating new sprint tasks.
+Always use the template at `.AIWF/99_TEMPLATES/task_template.md` when creating new sprint tasks.
+
+### GitHub Issue Integration
+
+When working with tasks that have GitHub issues:
+
+1. **Creating Issues**: Use `/project:aiwf:issue_create {task_id}` to create a GitHub issue from a task
+2. **Linking Issues**: Add `github_issue: #123` to task frontmatter
+3. **Status Updates**: Update issue status when task status changes
+4. **Commit Integration**: Include `fixes #123` or `relates to #456` in commit messages
+5. **Pull Requests**: Use `/project:aiwf:pr_create {task_id}` to create PR with issue linking
 
 ## Working with Sprint Tasks
 
 When executing a sprint task:
 
 1. Analyze task's Acceptance Criteria and Subtasks
-2. Update status to "in_progress"
-3. Log activities in the Output Log with timestamps after every Subtask(!)
-4. Mark subtasks as completed using [x] only when they are really completed. If you were not able to complete them, don't mark them and tell the user.
-5. Reference architectural guidelines when implementing technical solutions
-6. Ensure the task follows the structure from the task template
+2. Check if task has a linked GitHub issue (look for `github_issue` in frontmatter)
+3. Update status to "in_progress" and update GitHub issue if linked:
+   ```bash
+   gh issue comment {issue_number} --body "🚀 Task work has started."
+   gh issue edit {issue_number} --add-label "in-progress"
+   ```
+4. Log activities in the Output Log with timestamps after every Subtask(!)
+5. Mark subtasks as completed using [x] only when they are really completed. If you were not able to complete them, don't mark them and tell the user.
+6. Reference architectural guidelines when implementing technical solutions
+7. Ensure the task follows the structure from the task template
+8. When task is complete, update GitHub issue if linked:
+   ```bash
+   gh issue comment {issue_number} --body "✅ Task has been completed."
+   gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
+   ```