npm - aiwf - Versions diffs - 0.1.0 → 0.3.1 - Mend

aiwf 0.1.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (163) hide show

package/COMMANDS_GUIDE.md DELETED Viewed

@@ -1,462 +0,0 @@
-# Moonklabs 명령어 가이드
-이 가이드는 사용 가능한 Moonklabs 명령어와 이를 프로젝트에서 효과적으로 사용하는 방법을 설명합니다.
-## 명령어 개요
-Moonklabs 명령어는 `/project:moonklabs:<command_name> [arguments]` 형식을 따릅니다.
-## 설정 및 컨텍스트 명령어
-### 🚀 `/project:moonklabs:initialize`
-**목적**: 새 프로젝트 또는 기존 프로젝트에서 Moonklabs 초기화
-**사용법**:
-```
-/project:moonklabs:initialize
-```
-**동작**:
-1. Scans and analyzes your project
-2. Asks for confirmation about project type
-3. Checks for existing Moonklabs documents
-4. Guides you through document creation (imports existing docs or creates new ones)
-5. Creates your first milestone
-6. Generates project manifest
-**사용 시기**: 프로젝트에서 Moonklabs를 처음 설정할 때(현재 ForeLoop에는 이미 설정되어 있습니다!)
----
-### 🧠 `/project:moonklabs:prime`
-**목적**: 코딩 세션 시작 시 프로젝트 컨텍스트를 로드합니다
-**사용법**:
-```
-/project:moonklabs:prime
-```
-**동작**:
-- 프로젝트 매니페스트를 읽음
-- 현재 마일스톤 및 스프린트 정보를 로드
-- 활성 작업을 식별
-- 빠른 상태 개요를 제공
-**사용 시기**: 코딩 세션을 시작할 때 전체 상황을 빠르게 파악할 때
-## 계획 명령어
-### 📅 `/project:moonklabs:create_sprints_from_milestone`
-**목적**: 마일스톤을 관리 가능한 스프린트로 분해
-**사용법**:
-```
-/project:moonklabs:create_sprints_from_milestone 001_MVP_FOUNDATION
-```
-**동작**:
-1. 마일스톤 요구사항을 분석
-2. 관련 요구사항을 약 1주 길이의 스프린트로 그룹화
-3. 스프린트 폴더 및 META 파일 생성
-4. 스프린트 정보를 매니페스트에 업데이트
-**사용 시기**: 새로운 마일스톤을 생성한 후
----
-### 📋 `/project:moonklabs:create_sprint_tasks`
-**목적**: 스프린트를 위한 상세 작업 분해 생성
-**사용법**:
-```
-/project:moonklabs:create_sprint_tasks S01
-# or for specific sprint:
-/project:moonklabs:create_sprint_tasks S02_001_MVP_FOUNDATION
-```
-**동작**:
-1. 스프린트 요구사항을 분석
-2. 이를 구체적이고 실행 가능한 작업으로 분해
-3. 목표가 명확한 작업 파일을 생성
-4. 작업 간 종속성을 처리
-**사용 시기**: 각 스프린트 시작 시
----
-### ✏️ `/project:moonklabs:create_general_task`
-**목적**: 스프린트와 연결되지 않은 독립형 작업 생성
-**사용법**:
-```
-/project:moonklabs:create_general_task
-# Then describe your task when prompted
-```
-**예시 작업**:
-- "Fix memory leak in physics engine"
-- "Update documentation for API changes"
-- "Refactor database connection pooling"
-**사용 시기**: 유지보수, 버그 수정 또는 스프린트 범위를 벗어난 작업에 사용
-## Development Commands
-### 💻 `/project:moonklabs:do_task`
-**목적**: 특정 작업을 실행
-**사용법**:
-```
-/project:moonklabs:do_task
-# 사용 가능한 작업을 나열하고 선택을 요청
-# 또는 작업을 직접 지정:
-/project:moonklabs:do_task T001_S01_setup_tauri
-```
-**동작**:
-1. Reads task requirements
-2. Implements the solution
-3. Runs tests if applicable
-4. Updates task status
-5. Creates necessary files/changes
-**사용 시기**: Ready to work on a specific task
----
-### 📝 `/project:moonklabs:commit`
-**목적**: Create well-structured git commits
-**사용법**:
-```
-/project:moonklabs:commit
-# 변경 사항을 검토하고 커밋을 생성
-# 또는 특정 작업에 대해:
-/project:moonklabs:commit T001_S01_setup_tauri
-# 리뷰와 함께:
-/project:moonklabs:commit --review
-```
-**동작**:
-1. Analyzes changes made
-2. Groups related changes
-3. Creates meaningful commit messages
-4. Links commits to tasks/requirements
-5. Optionally runs code review first
-**사용 시기**: After completing work you want to save
----
-### 🧪 `/project:moonklabs:test`
-**목적**: Run tests and fix common issues
-**사용법**:
-```
-/project:moonklabs:test
-# 모든 테스트 실행
-/project:moonklabs:test unit
-# 특정 테스트 스위트 실행
-```
-**동작**:
-1. Identifies test commands from package.json
-2. Runs appropriate tests
-3. Fixes common issues (missing deps, configs)
-4. Reports results clearly
-**사용 시기**: Before committing or when tests fail
-## 코드 리뷰 명령어
-### 🔍 `/project:moonklabs:code_review`
-**목적**: Review code against specifications
-**사용법**:
-```
-/project:moonklabs:code_review
-# 커밋되지 않은 변경 사항 검토
-/project:moonklabs:code_review src/app/components/GameCanvas.tsx
-# Reviews specific file
-```
-**동작**:
-1. Checks code against requirements
-2. Verifies patterns and conventions
-3. Identifies bugs and issues
-4. Suggests improvements
-5. Ensures spec compliance
-**사용 시기**: Before committing important changes
----
-### 📊 `/project:moonklabs:project_review`
-**목적**: Comprehensive project health check
-**사용법**:
-```
-/project:moonklabs:project_review
-```
-**동작**:
-1. Reviews overall architecture
-2. Checks technical debt
-3. Analyzes progress vs. timeline
-4. Identifies risks and blockers
-5. Suggests improvements
-**사용 시기**: Weekly or at sprint boundaries
----
-### 🧪 `/project:moonklabs:testing_review`
-**목적**: Analyze test coverage and quality
-**사용법**:
-```
-/project:moonklabs:testing_review
-```
-**동작**:
-1. Reviews test coverage
-2. Identifies missing test cases
-3. Checks test quality
-4. Suggests improvements
-**사용 시기**: After implementing features
----
-### 💬 `/project:moonklabs:discuss_review`
-**목적**: Technical discussion about review findings
-**사용법**:
-```
-/project:moonklabs:discuss_review
-# After running another review command
-```
-**동작**:
-- Provides detailed explanations
-- Discusses trade-offs
-- Suggests solutions
-- Answers questions
-**사용 시기**: To understand review feedback better
-## 자동화 명령어
-### 🚀 `/project:moonklabs:yolo`
-**목적**: Autonomous task execution
-**사용법**:
-```
-/project:moonklabs:yolo
-# 모든 열린 작업을 순차 실행
-/project:moonklabs:yolo S02
-# 특정 스프린트를 순차 실행
-```
-**동작**:
-1. Identifies open tasks
-2. Executes them in order
-3. Handles dependencies
-4. Commits completed work
-5. Updates progress
-**Safety features**:
-- Won't modify schemas without confirmation
-- Skips dangerous operations
-- Maintains code quality
-- Creates logical commits
-**사용 시기**: When you want autonomous progress
-## 추가/고급 명령어
-### 📌 `/project:moonklabs:pr_create`
-**목적**: Pull Request를 생성하고 템플릿을 적용하여 변경 사항을 정리합니다.
-**사용법**:
-```
-/project:moonklabs:pr_create "Add authentication to API"
-```
----
-### 🗂️ `/project:moonklabs:issue_create`
-**목적**: GitHub Issue를 생성하여 버그 리포트·기능 요청을 기록합니다.
-**사용법**:
-```
-/project:moonklabs:issue_create "Bug: login fails on Safari"
-```
----
-### 🛠️ `/project:moonklabs:plan_milestone`
-**목적**: 대화형 프로세스로 신규 마일스톤을 계획하고 `.moonklabs/02_REQUIREMENTS/` 구조를 자동 생성합니다.
----
-### 📈 `/project:moonklabs:mermaid`
-**목적**: 코드베이스를 분석하여 Mermaid 다이어그램(UML/시퀀스 등)을 생성합니다.
----
-### ♾️ `/project:moonklabs:infinite`
-**목적**: 명세에 따라 무한(또는 지정 횟수) 반복 결과물을 생성하는 고급 반복 생성 루프를 실행합니다.
----
-### 🤖 `/project:moonklabs:tm-run-all-subtask`
-**목적**: Task Master의 모든 서브태스크를 한 번에 실행하여 진행 상황을 자동화합니다.
----
-### 🧠 `/project:moonklabs:ultrathink_general`
-**목적**: 폭넓은 문제를 심층 분석하기 위한 울트라 씽킹(General) 세션을 시작합니다.
----
-### 🧠 `/project:moonklabs:ultrathink_code_basic`
-**목적**: 코드 기반 문제를 기본 수준에서 심층 분석하는 울트라 씽킹 세션을 시작합니다.
----
-### 🧠 `/project:moonklabs:ultrathink_code_advanced`
-**목적**: 복잡한 코드·아키텍처 문제를 고급 수준에서 심층 분석하는 울트라 씽킹 세션을 시작합니다.
----
-### ⚙️ `/project:moonklabs:prime_context`
-**목적**: 프로젝트 컨텍스트(파일 목록·주요 문서)를 빠르게 불러와 프라임합니다.
-## 모범 사례
-### 일일 워크플로
-```bash
-# Start of day
-/project:moonklabs:prime
-# Work on tasks
-/project:moonklabs:do_task
-/project:moonklabs:test
-/project:moonklabs:commit
-# End of day
-/project:moonklabs:project_review
-```
-### 스프린트 워크플로
-```bash
-# Sprint planning
-/project:moonklabs:create_sprint_tasks S02
-# Sprint execution
-/project:moonklabs:do_task T001_S02_first_task
-/project:moonklabs:do_task T002_S02_second_task
-/project:moonklabs:commit --review
-# Sprint review
-/project:moonklabs:project_review
-```
-### 빠른 수정
-```bash
-# Bug fix workflow
-/project:moonklabs:create_general_task
-# Describe: "Fix memory leak in /src/foo.bar"
-/project:moonklabs:do_task T003
-/project:moonklabs:test
-/project:moonklabs:commit T003
-```
-## 팁 & 트릭
-1. **Use YOLO for routine tasks**: Great for implementing straightforward features
-2. **Always prime first**: Ensures commands have proper context
-3. **Review before major commits**: Catch issues early
-4. **Create general tasks for bugs**: Keeps them trackable
-5. **Use task-specific commits**: Better traceability
-## 명령어 안전 장치
-Moonklabs commands include safety features:
-- Won't delete critical files
-- Asks before schema changes
-- Validates changes against specs
-- Maintains code quality standards
-- Creates incremental commits
-## 도움 받기
-If you need help with a command:
-1. Run the command without arguments for usage info
-2. Check this guide
-3. Look at task examples in `.moonklabs/`
-4. Review the command source in `.claude/commands/`

package/PRD.ko.md DELETED Viewed

@@ -1,96 +0,0 @@
-# HelloMoonklabs - Moonklabs 프레임워크 설치 프로그램
-_버전: 0.1.0_
-## 개요
-모든 프로젝트에 Moonklabs 프로젝트 관리 프레임워크를 설치하기 위한 최소한의 `npx` 실행 가능 커맨드 라인 도구입니다. 구조화된 디렉토리 레이아웃과 효율적인 프로젝트 관리를 위한 커맨드 라인 도구를 제공하며, 사용자 인터페이스는 한국어로 현지화되어 있습니다.
-## 핵심 기능
-### 설치 명령어
-이 도구는 `npx`를 통해 실행됩니다:
-```bash
-npx hello-moonklabs
-```
-### 주요 특징
-1.  **디렉토리 구조 생성**:
-    - 문서, 요구사항, 스프린트 등을 위한 표준화된 하위 디렉토리를 포함하는 `.moonklabs/` 디렉토리를 초기화합니다.
-    - 사용자 지정 Claude 명령어를 위한 `.claude/commands/moonklabs/` 디렉토리를 설정합니다.
-2.  **GitHub에서 파일 가져오기**:
-    - GitHub의 `moonklabs/aiwf` 리포지토리에서 최신 프레임워크 파일을 다운로드합니다.
-    - 특히 `claude-code/moonklabs/` 하위 디렉토리에서 파일을 가져옵니다.
-    - 명령어, 문서 템플릿, 프로젝트 매니페스트를 설치합니다.
-3.  **기존 설치 처리**:
-    - Moonklabs 프레임워크가 이미 존재하는지 감지합니다.
-    - 사용자에게 **업데이트**, **건너뛰기**, 또는 **취소**를 요청합니다.
-    - 업데이트 프로세스는 사용자가 생성한 파일(작업, 스프린트)을 보존하면서 명령어 스크립트와 `CLAUDE.md` 문서를 업데이트합니다.
-    - 덮어쓴 파일은 `.bak` 확장자로 자동 백업합니다.
-4.  **대화형 및 현지화된 CLI**:
-    - 원활한 사용자 경험을 위해 명확하고 대화형인 프롬프트를 제공합니다.
-    - 모든 사용자 대상 커뮤니케이션은 한국어로 제공됩니다.
-## 기술적 접근 방식
-- **Node.js 스크립트**: Node.js로 구축된 단일 실행 스크립트입니다.
-- **의존성**: 커맨드 라인 인터페이스를 향상시키기 위해 외부 라이브러리를 사용합니다:
-  - `commander`: 커맨드 라인 인수 구문 분석용.
-  - `ora`: 로딩 스피너 표시용.
-  - `prompts`: 대화형 사용자 프롬프트용.
-  - `chalk`: 콘솔 출력에 색상 추가용.
-- **GitHub Fetching**: GitHub API를 사용하여 디렉토리 내용을 나열하고, `raw.githubusercontent.com` 소스에서 직접 파일을 다운로드합니다.
-## 설치 흐름
-1.  환영 메시지가 (한국어로) 표시됩니다.
-2.  스크립트가 기존 설치를 확인합니다.
-3.  설치가 존재하면 사용자에게 작업(업데이트, 건너뛰기, 취소)을 선택하라는 메시지를 표시합니다.
-4.  진행 시, 스피너가 GitHub에서 파일을 가져오는 중임을 나타냅니다.
-5.  필요한 디렉토리 구조가 생성됩니다.
-6.  프레임워크 파일(매니페스트, 템플릿, 문서, 명령어)이 다운로드되어 올바른 위치에 배치됩니다.
-7.  시작을 위한 다음 단계와 함께 성공 메시지가 표시됩니다.
-8.  단계가 실패하면 오류 메시지가 표시되고 가능한 경우 백업에서 기존 파일이 복원됩니다.
-## 생성되는 파일 구조
-```
-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
-```

package/PRD.md DELETED Viewed

@@ -1,98 +0,0 @@
-[Read in Korean (한국어로 보기)](PRD.ko.md)
-# HelloMoonklabs - Installer for Moonklabs Framework
-_Version: 0.1.0_
-## Overview
-A minimal, `npx`-executable command-line tool to install the Moonklabs project management framework into any project. It provides a structured directory layout and command-line tools for streamlined project management, with a user interface localized in Korean.
-## Core Functionality
-### Installation Command
-The tool is executed via `npx`:
-```bash
-npx hello-moonklabs
-```
-### Key Features
-1.  **Creates Directory Structure**:
-    - Initializes the `.moonklabs/` directory with standardized subdirectories for documents, requirements, sprints, and more.
-    - Sets up the `.claude/commands/moonklabs/` directory for custom Claude commands.
-2.  **Fetches from GitHub**:
-    - Downloads the latest framework files from the `moonklabs/aiwf` repository on GitHub.
-    - Specifically, it sources files from the `claude-code/moonklabs/` subdirectory.
-    - Installs commands, documentation templates, and the project manifest.
-3.  **Handles Existing Installations**:
-    - Detects if a Moonklabs framework is already present.
-    - Prompts the user to **Update**, **Skip**, or **Cancel**.
-    - The update process preserves user-created files (tasks, sprints) while updating command scripts and `CLAUDE.md` documents.
-    - Automatically backs up overwritten files with a `.bak` extension.
-4.  **Interactive & Localized CLI**:
-    - Provides clear, interactive prompts for a smooth user experience.
-    - All user-facing communication is in Korean.
-## Technical Approach
-- **Node.js Script**: A single executable script built with Node.js.
-- **Dependencies**: Uses external libraries to enhance the command-line interface:
-  - `commander`: For command-line argument parsing.
-  - `ora`: To display loading spinners.
-  - `prompts`: For interactive user prompts.
-  - `chalk`: To add color to console output.
-- **GitHub Fetching**: Downloads files directly from the `raw.githubusercontent.com` source, using the GitHub API to list directory contents.
-## Installation Flow
-1.  A welcome message is displayed (in Korean).
-2.  The script checks for an existing installation.
-3.  If one exists, it prompts the user to choose an action (Update, Skip, Cancel).
-4.  If proceeding, a spinner indicates that files are being fetched from GitHub.
-5.  The required directory structure is created.
-6.  Framework files (manifest, templates, docs, commands) are downloaded and placed in the correct locations.
-7.  A success message is shown with next steps for getting started.
-8.  If any step fails, an error message is displayed and existing files are restored from backups if available.
-## File Structure Created
-```
-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
-```

package/claude-code/simone/.simone/04_GENERAL_TASKS/CLAUDE.MD DELETED Viewed

@@ -1,51 +0,0 @@
-# General Tasks Instructions
-## General Task Structure
-General tasks are standalone work items not tied to sprints:
-- Files follow pattern: `T<NNN>_<Description>.md`
-- Completed tasks: `TX<NNN>_<Description>.md`
-Always use the template at `.simone/99_TEMPLATES/task_template.md` when creating new general tasks.
-## Task Formatting
-General tasks use standardized YAML frontmatter and sections:
-```yaml
----
-task_id: T001
-status: open # open | in_progress | pending_review | done | failed | blocked
-complexity: Medium # Low | Medium | High
-last_updated: YYYY-MM-DD HH:MM
----
-```
-The full task structure with all sections is defined in the task template. Always maintain this structure.
-## Working with General Tasks
-When handling general tasks:
-1. Update the status field as you progress
-2. Record timestamps in this format (YYYY-MM-DD HH:MM)
-3. Log all significant actions in the Output Log section:
-   ```plaintext
-   [YYYY-MM-DD HH:MM] Started task
-   [YYYY-MM-DD HH:MM] Modified files: file1.js, file2.js
-   ```
-4. Mark subtasks as they're completed: `- [x] Completed subtask`
-5. Use the Acceptance Criteria as your primary completion checklist
-6. Ensure all sections from the task template are preserved
-## Task Completion Process
-When a task is complete:
-1. Update status to "done"
-2. Update all Acceptance Criteria with [x]
-3. Add final Output Log entry
-4. Rename file from T... to TX... (e.g., `TX001_Task_Name.md`)