aiwf 0.1.0

package/README.ko.md

@@ -0,0 +1,115 @@
+# aiwf
+
+이 프로젝트는 [Simone](https://github.com/Helmi/claude-simone)의 업데이트된 버전입니다.
+
+> 🚀 Claude Code용 Moonklabs 프로젝트 관리 프레임워크를 위한 빠른 설치 프로그램
+
+## Moonklabs Framework란 무엇인가요?
+
+Moonklabs는 Claude Code를 사용한 AI 지원 개발을 위해 특별히 설계된 마크다운 기반 프로젝트 관리 프레임워크입니다. 소프트웨어 프로젝트를 관리 가능한 덩어리로 나누어 효과적인 AI 처리를 돕습니다.
+
+## 설치
+
+모든 프로젝트 디렉토리에 Moonklabs를 설치하세요:
+
+```bash
+npx aiwf
+```
+
+이것으로 끝입니다! 설치 프로그램은 다음을 수행합니다:
+
+- 프로젝트 관리를 위한 `.moonklabs/` 디렉토리 구조 생성
+- 사용자 지정 Claude 명령어를 위한 `.claude/commands/moonklabs/` 설정
+- 최신 템플릿 및 문서 다운로드
+
+## 사용법
+
+### 첫 설치
+
+```bash
+npx aiwf
+```
+
+### 기존 설치 업데이트
+
+Moonklabs가 이미 설치된 경우, 설치 프로그램이 이를 감지하고 다음 옵션을 제공합니다:
+
+- 업데이트 (자동 백업 포함)
+- 설치 건너뛰기
+- 취소
+
+### 강제 설치
+
+모든 프롬프트를 건너뛰고 강제로 설치합니다:
+
+```bash
+npx aiwf --force
+```
+
+## 설치되는 항목
+
+```
+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
+```
+
+## 다음 단계
+
+설치 후:
+
+1.  Claude Code에서 프로젝트를 엽니다
+2.  `/project:moonklabs` 명령어를 사용하여 프로젝트를 관리합니다
+3.  `/project:moonklabs:initialize`로 시작하여 프로젝트를 설정합니다
+
+## 명령어 가이드
+
+Moonklabs의 전체 명령어 목록과 자세한 사용법은 [COMMANDS_GUIDE.md](COMMANDS_GUIDE.md) 문서를 참고하세요.
+
+## 특징
+
+- 🎨 색상과 진행 표시기가 있는 아름다운 CLI
+- 🔄 자동 백업 기능이 있는 스마트 업데이트 감지
+- 📦 공식 GitHub 리포지토리에서 직접 다운로드
+- 🚀 `npx`로 작동 - 전역 설치 필요 없음
+- 💾 업데이트 시 타임스탬프가 찍힌 백업 생성
+
+## 요구사항
+
+- Node.js 14.0.0 이상
+- GitHub에서 다운로드하기 위한 인터넷 연결
+
+## 소스
+
+이 설치 프로그램은 다음에서 Moonklabs 프레임워크를 가져옵니다:
+https://github.com/moonklabs/aiwf
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,117 @@
+[Read in Korean (한국어로 보기)](README.ko.md)
+
+# aiwf
+
+This project is an updated version of [Simone](https://github.com/Helmi/claude-simone).
+
+> 🚀 Quick installer for the Moonklabs project management framework for Claude Code
+
+## What is Moonklabs?
+
+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.
+
+## Installation
+
+Install Moonklabs in any project directory:
+
+```bash
+npx aiwf
+```
+
+That's it! 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
+
+## Usage
+
+### First Time Installation
+
+```bash
+npx aiwf
+```
+
+### Update Existing Installation
+
+If Moonklabs is already installed, the installer will detect it and offer options to:
+
+- Update (with automatic backup)
+- Skip installation
+- Cancel
+
+### Force Installation
+
+Skip all prompts and force installation:
+
+```bash
+npx aiwf --force
+```
+
+## What Gets Installed
+
+```
+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
+
+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
+
+## Command Reference
+
+For a full list of available Moonklabs commands and detailed usage, see [COMMANDS_GUIDE.md](COMMANDS_GUIDE.md).
+
+## 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
+
+## Requirements
+
+- Node.js 14.0.0 or higher
+- Internet connection to download from GitHub
+
+## Source
+
+This installer fetches the Moonklabs framework from:
+https://github.com/moonklabs/aiwf
+
+## License
+
+MIT

package/claude-code/docker/Dockerfile

@@ -0,0 +1,117 @@
+FROM node:20
+
+ARG TZ
+ENV TZ="$TZ"
+ARG SANDBOX_NAME="ai-code-sandbox"
+ARG CLI_VERSION_ARG
+ENV SANDBOX="$SANDBOX_NAME"
+ENV CLI_VERSION=$CLI_VERSION_ARG
+
+# Install basic development tools and iptables/ipset
+RUN apt update && apt install -y less \
+  git \
+  procps \
+  sudo \
+  fzf \
+  zsh \
+  man-db \
+  unzip \
+  gnupg2 \
+  gh \
+  iptables \
+  ipset \
+  iproute2 \
+  dnsutils \
+  aggregate \
+  jq \
+  ripgrep \
+  nano \
+  python3 \
+  make \
+  g++ \
+  curl \
+  bc \
+  git \
+  rsync \
+  psmisc \
+  lsof \
+  socat \
+  neovim \
+  fasd \
+  ca-certificates \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+# Ensure default node user has access to /usr/local/share
+RUN mkdir -p /usr/local/share/npm-global && \
+  chown -R node:node /usr/local/share/npm-global && \
+  chown -R node:node /usr/local/share
+
+ARG USERNAME=node
+
+# Persist bash history.
+RUN SNIPPET="export PROMPT_COMMAND='history -a' && export HISTFILE=/commandhistory/.bash_history" \
+  && mkdir /commandhistory \
+  && touch /commandhistory/.bash_history \
+  && chown -R $USERNAME /commandhistory
+
+# Set `DEVCONTAINER` environment variable to help with orientation
+ENV DEVCONTAINER=true
+
+# Create workspace and config directories and set permissions
+RUN mkdir -p /workspace /home/node/.claude && \
+  chown -R node:node /workspace /home/node/.claude
+
+WORKDIR /workspace
+
+RUN ARCH=$(dpkg --print-architecture) && \
+  wget "https://github.com/dandavison/delta/releases/download/0.18.2/git-delta_0.18.2_${ARCH}.deb" && \
+  sudo dpkg -i "git-delta_0.18.2_${ARCH}.deb" && \
+  rm "git-delta_0.18.2_${ARCH}.deb"
+
+# Set up non-root user
+USER node
+
+# Install global packages
+ENV NPM_CONFIG_PREFIX=/usr/local/share/npm-global
+ENV PATH=$PATH:/usr/local/share/npm-global/bin
+
+# Set the default shell to bash rather than sh
+ENV SHELL /bin/zsh
+
+# Default powerline10k theme
+RUN sh -c "$(wget -O- https://github.com/deluan/zsh-in-docker/releases/download/v1.2.0/zsh-in-docker.sh)" -- \
+  -p git \
+  -p fzf \
+  -p fasd \
+  -p zsh-autosuggestions \
+  -p zsh-syntax-highlighting \
+  -a "source /usr/share/doc/fzf/examples/key-bindings.zsh" \
+  -a "source /usr/share/doc/fzf/examples/completion.zsh" \
+  -a "export PROMPT_COMMAND='history -a' && export HISTFILE=/commandhistory/.bash_history" \
+  -x
+
+# Install Claude
+RUN npm install -g @anthropic-ai/claude-code
+
+# Setup Claude config
+RUN mkdir ~/.claude-code.config && \
+  echo "{}" > ~/.claude-code.config/.claude.json && \
+  ln -sf ~/.claude-code.config/.claude.json ~/.claude.json
+
+# Install Gemini
+RUN npm install -g @google/gemini-cli
+
+# Install Taskmaster
+RUN npm install -g task-master-ai
+
+RUN echo "alias tm='task-master'" >> ~/.zshrc
+RUN echo "export GOOGLE_CLOUD_PROJECT="sellerking"" >> ~/.zshrc
+
+# Copy and set up firewall script
+# COPY init-firewall.sh /usr/local/bin/
+# USER root
+# RUN chmod +x /usr/local/bin/init-firewall.sh && \
+#   echo "node ALL=(root) NOPASSWD: /usr/local/bin/init-firewall.sh" > /etc/sudoers.d/node-firewall && \
+#   chmod 0440 /etc/sudoers.d/node-firewall
+# USER node

package/claude-code/simone/.simone/00_PROJECT_MANIFEST.md

@@ -0,0 +1,49 @@
+---
+project_name: Your Project Name
+current_milestone_id: M01
+highest_sprint_in_milestone: S02
+current_sprint_id: S01
+status: active
+last_updated: 2025-01-01 00:00:00
+---
+
+# Project Manifest: Your Project Name
+
+This manifest serves as the central reference point for the project. It tracks the current focus and links to key documentation.
+
+## 1. Project Vision & Overview
+
+[Describe your project's core vision, purpose, and goals here. What problem does it solve? Who is it for? What makes it unique?]
+
+This project follows a milestone-based development approach.
+
+## 2. Current Focus
+
+- **Milestone:** M01 - [Your First Milestone Name]
+- **Sprint:** S01 - [Current Sprint Focus]
+
+## 3. Sprints in Current Milestone
+
+### S01 [Sprint Name] (🚧 IN PROGRESS)
+
+🚧 [First deliverable or feature]
+📋 [Second deliverable or feature]
+📋 [Third deliverable or feature]
+
+### S02 [Sprint Name] (📋 PLANNED)
+
+📋 [First planned deliverable]
+📋 [Second planned deliverable]
+📋 [Third planned deliverable]
+
+## 4. Key Documentation
+
+- [Architecture Documentation](./01_PROJECT_DOCS/ARCHITECTURE.md)
+- [Current Milestone Requirements](./02_REQUIREMENTS/M01_[Milestone_Name]/)
+- [General Tasks](./04_GENERAL_TASKS/)
+
+## 5. Quick Links
+
+- **Current Sprint:** [S01 Sprint Folder](./03_SPRINTS/S01_M01_[Sprint_Name]/)
+- **Active Tasks:** Check sprint folder for T##_S01_*.md files
+- **Project Reviews:** [Latest Review](./10_STATE_OF_PROJECT/)

package/claude-code/simone/.simone/01_PROJECT_DOCS/ARCHITECTURE.md

@@ -0,0 +1,55 @@
+# 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.**
+
+## System Overview
+
+This is a demonstration of how a system architecture document might be structured. In a real project, this would contain actual architectural details.
+
+## Technical Architecture (Example)
+
+### Backend
+
+- **API Layer**: Node.js with Express.js
+- **Database**: MongoDB for primary data storage
+- **Authentication**: JWT-based authentication with OAuth support
+- **Caching**: Redis for performance optimization
+- **Testing**: Jest for unit and integration testing
+
+### Frontend
+
+- **Web Client**: React.js with TypeScript
+- **Mobile Apps**: React Native for iOS and Android
+- **State Management**: Redux for predictable state
+- **UI Framework**: Material-UI for consistent design
+
+## System Components (Example)
+
+1. **Authentication Service**: Handles user signup, login, and session management
+2. **Project Management Service**: Manages projects, teams, and permissions
+3. **Task Service**: Core task CRUD operations and business logic
+4. **Notification Service**: Manages user notifications and alerts
+5. **Analytics Service**: Provides usage statistics and reporting
+
+## Data Flow (Example)
+
+1. Clients authenticate through the Authentication Service
+2. Authenticated requests are routed to the appropriate service
+3. Services interact with the database and return responses
+4. Real-time updates are pushed to clients via WebSockets
+
+## Deployment Architecture (Example)
+
+The system is deployed using containerization with Docker and Kubernetes, providing:
+
+- Horizontal scalability for handling load spikes
+- High availability through multiple replicas
+- Zero-downtime deployments
+- Environment isolation (development, staging, production)
+
+## Security Considerations (Example)
+
+- All API endpoints are protected with proper authentication
+- Sensitive data is encrypted at rest and in transit
+- Rate limiting is implemented to prevent abuse
+- Regular security audits and penetration testing

package/claude-code/simone/.simone/02_REQUIREMENTS/CLAUDE.md

@@ -0,0 +1,78 @@
+# CLAUDE.md - Requirements Folder Structure Guide
+
+## Overview
+This folder contains all project milestones and their associated requirements documentation. Each milestone represents a major project phase or feature set.
+
+## Milestone Naming Convention
+**CRITICAL**: Milestone folders MUST follow this exact pattern:
+```
+M##_Milestone_Name/
+```
+
+- `M##` - Two-digit milestone number (M01, M02, etc.)
+- `_` - Single underscore separator
+- `Milestone_Name` - Descriptive name using underscores for spaces
+
+### Examples:
+- ✅ `M01_Backend_Setup/`
+- ✅ `M02_Frontend_UI/`
+- ✅ `M03_Authentication_System/`
+- ❌ `M1_Backend/` (missing leading zero)
+- ❌ `M01-Backend-Setup/` (wrong separator)
+- ❌ `Backend_Setup/` (missing M## prefix)
+
+## Milestone Structure
+Each milestone folder MUST contain:
+
+### 1. Milestone Meta File (REQUIRED)
+- **Name**: `M##_milestone_meta.md`
+- **Purpose**: Contains milestone metadata and overview
+- **Location**: Root of milestone folder
+
+### 2. Product Requirements Documents (PRD)
+- **Pattern**: `PRD_*.md`
+- **Examples**: `PRD_Backend_Setup.md`, `PRD_User_Authentication.md`
+- **Purpose**: Define product requirements and user stories
+
+### 3. Technical Specifications
+- **Pattern**: `SPECS_*.md`
+- **Examples**: `SPECS_API_V1.md`, `SPECS_Database_Schema.md`
+- **Purpose**: Technical implementation details
+
+### 4. Amendments (as needed)
+- **Pattern**: `PRD_AMEND_##_*.md`
+- **Examples**: `PRD_AMEND_01_Additional_Endpoints.md`
+- **Purpose**: Document changes to original requirements
+
+## Example Structure
+```
+02_REQUIREMENTS/
+├── M01_Backend_Setup/
+│   ├── M01_milestone_meta.md
+│   ├── PRD_Backend_Setup.md
+│   ├── SPECS_API_V1.md
+│   └── PRD_AMEND_01_Cache_Layer.md
+├── M02_Frontend_UI/
+│   ├── M02_milestone_meta.md
+│   ├── PRD_User_Interface.md
+│   └── SPECS_Component_Library.md
+└── M03_Authentication_System/
+    ├── M03_milestone_meta.md
+    ├── PRD_Authentication.md
+    └── SPECS_OAuth_Integration.md
+```
+
+## Important Notes for Claude Code
+
+1. **Always use the M## prefix** when creating milestone folders
+2. **Use underscores** for spaces in milestone names
+3. **Create the milestone meta file first** using the template from `99_TEMPLATES/milestone_meta_template.md`
+4. **Update the project manifest** (`00_PROJECT_MANIFEST.md`) when creating new milestones
+5. **Maintain sequential numbering** - don't skip milestone numbers
+
+## Common Mistakes to Avoid
+- Creating milestones without the M## prefix
+- Using hyphens instead of underscores
+- Forgetting the milestone meta file
+- Not updating the project manifest
+- Creating milestones in the wrong location (must be in 02_REQUIREMENTS)

package/claude-code/simone/.simone/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md

@@ -0,0 +1,38 @@
+---
+milestone_id: M01
+title: Backend Setup
+status: active # pending | active | completed | blocked | on_hold
+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
+2. Defining the database schema and models
+3. Implementing basic API endpoints
+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
+- All core models are defined and can be created/updated/deleted via the API
+- Authentication is working with JWT tokens
+- Basic error handling is implemented
+- 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.
+
+## Related Sprints
+
+- [S01_M01_Initial_API](../../03_SPRINTS/S01_M01_Initial_API/S01_sprint_meta.md)
+- [S02_M01_Database_Integration](../../03_SPRINTS/S02_M01_Database_Integration/S02_sprint_meta.md)

package/claude-code/simone/.simone/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md

@@ -0,0 +1,69 @@
+# Amendment: Auth Flow Update (EXAMPLE)
+
+## Date: 2023-05-17
+
+## Overview
+
+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.**
+
+## Changes to Product Requirements
+
+### User Management (FR-1)
+
+**Added Requirements:**
+
+- FR-1.6: The system shall allow users to register and log in using Google OAuth
+- FR-1.7: The system shall allow users to register and log in using GitHub OAuth
+- FR-1.8: The system shall link social login accounts with existing email accounts when the email matches
+
+### Data Models (FR-2)
+
+**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)
+
+## 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
+
+- Required libraries: `passport`, `passport-google-oauth20`, `passport-github2`
+- Additional environment variables needed:
+  - `GOOGLE_CLIENT_ID`
+  - `GOOGLE_CLIENT_SECRET`
+  - `GITHUB_CLIENT_ID`
+  - `GITHUB_CLIENT_SECRET`
+  - `OAUTH_CALLBACK_URL`
+
+## Test Cases
+
+- TC-1: User can log in with Google account
+- TC-2: User can log in with GitHub account
+- TC-3: Social login with matching email links to existing account
+- TC-4: JWT token works correctly regardless of authentication method
+
+## Timeline Impact
+
+Implementation of these changes is expected to add 3 days to the original timeline.
+
+## Approvals
+
+- Requested by: Sarah Chen (Product Manager)
+- Approved by: Mike Johnson (Technical Lead)
+- Approved by: David Lee (Project Manager)