aiwf 0.1.0 → 0.3.1

package/claude-code/aiwf/ko/.claude/settings.json

@@ -0,0 +1,102 @@
+{
+    "permissions": {
+        "allow": [
+            "Bash(deno task *)",
+            "Bash(npm run *)",
+            "Bash(cargo *)",
+            "Bash(go *)",
+            "Bash(git *)",
+            "Bash(git worktree *)",
+            "Bash(gh *)",
+            "Bash(docker *)",
+            "Bash(kubectl *)",
+            "Bash(terraform *)",
+            "Bash(rg *)",
+            "Bash(ripgrep *)",
+            "Bash(fd *)",
+            "Bash(fzf *)",
+            "Bash(bat *)",
+            "Bash(exa *)",
+            "Bash(eza *)",
+            "Bash(delta *)",
+            "Bash(zoxide *)",
+            "Bash(duf *)",
+            "Bash(htop *)",
+            "Bash(btop *)",
+            "Bash(jq *)",
+            "Bash(yq *)",
+            "Bash(hexyl *)",
+            "Bash(prettier *)",
+            "Bash(eslint *)",
+            "Bash(tsc *)",
+            "Bash(pnpm *)",
+            "Bash(yarn *)",
+            "Bash(mkdir -p /tmp/claude-scratch*)",
+            "Bash(touch /tmp/claude-*)",
+            "Bash(echo * > /tmp/claude-*)",
+            "Bash(cat /tmp/claude-*)"
+        ],
+        "deny": [
+            "Bash(rm -rf /)",
+            "Bash(:(){ :|:& };:)",
+            "Bash(dd if=/dev/zero of=/dev/*)",
+            "Bash(mkfs.*)",
+            "Bash(> /dev/sda*)"
+        ]
+    },
+    "env": {
+        "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
+        "EDITOR": "zed",
+        "GIT_EDITOR": "zed --wait"
+    },
+    "preferredNotifChannel": "terminal_bell",
+    "verbose": true,
+    "cleanupPeriodDays": 90,
+    "includeCoAuthoredBy": false,
+    "hooks": {
+        "beforeFileEdit": [
+            {
+                "command": "npm run lint:fix --silent || true",
+                "description": "파일 수정 전 자동 린트 수정 실행"
+            }
+        ],
+        "afterFileEdit": [
+            {
+                "command": "prettier --write {file} || true",
+                "description": "파일 수정 후 자동 포맷팅 실행"
+            }
+        ],
+        "beforeCommit": [
+            {
+                "command": "npm run lint || echo '린트 검사 실패'",
+                "description": "커밋 전 린트 검사"
+            },
+            {
+                "command": "npm run test || echo '테스트 실패'",
+                "description": "커밋 전 테스트 실행"
+            }
+        ],
+        "Stop": [
+            {
+                "matcher": "",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "afplay /System/Library/Sounds/Glass.aiff"
+                    }
+                ]
+            }
+        ],
+        "PostToolUse": [
+            {
+                "matcher": "Write|Edit|MultiEdit",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "aiwf_test"
+                    }
+                ]
+            }
+        ]
+    }
+}

package/{AI-WORKFLOW.md → docs/AI-WORKFLOW.ko.md}

@@ -1,38 +1,46 @@
-# Claude Code를 위한 Moonklabs
+# Claude Code를 위한 AIWF
 
 ## 이것은 무엇인가요?
 
-Moonklabs은 Claude Code, Gemini-CLI 와 더 효과적으로 작업하기 위해 만든 디렉토리 기반 프로젝트 관리 시스템입니다. 기본적으로 폴더, 마크다운 파일 및 AI가 효과적으로 처리할 수 있는 관리 가능한 단위로 소프트웨어 프로젝트를 분할하는 데 도움이 되는 사용자 정의 명령의 집합입니다.
+AIWF은 Claude Code, Gemini-CLI 와 더 효과적으로 작업하기 위해 만든 디렉토리 기반 프로젝트 관리 시스템입니다. 기본적으로 폴더, 마크다운 파일 및 AI가 효과적으로 처리할 수 있는 관리 가능한 단위로 소프트웨어 프로젝트를 분할하는 데 도움이 되는 사용자 정의 명령의 집합입니다.
 
 **🚀 NEW**: 강화된 YOLO 모드로 전체 스프린트나 마일스톤을 한 번에 자동 완료할 수 있습니다!
 
-**⚠️ 복잡성 경고**: Moonklabs은 제대로 이해하는 데 시간이 필요한 정교한 시스템입니다. 단순한 플러그 앤 플레이 솔루션이 아니라, 작동 방식을 배우고 워크플로에 적응하는 데 시간을 투자할 때 가장 잘 작동하는 프레임워크입니다.
+**⚠️ 복잡성 경고**: AIWF은 제대로 이해하는 데 시간이 필요한 정교한 시스템입니다. 단순한 플러그 앤 플레이 솔루션이 아니라, 작동 방식을 배우고 워크플로에 적응하는 데 시간을 투자할 때 가장 잘 작동하는 프레임워크입니다.
 
 **📋 최신 업데이트**: 최근 변경 사항 및 개선 사항은 [CHANGELOG.md](CHANGELOG.md)를 참조하세요.
 
 ## 시작하는 방법
 
-### 1. Moonklabs 설치하기
+### 1. AIWF 설치하기
 
 ```bash
 npx aiwf
 ```
 
+**다국어 지원**: AIWF는 지능형 감지 및 선호도 저장 기능을 갖춘 포괄적인 언어 관리 시스템을 제공합니다. 설치 시 영어와 한국어 중 선택할 수 있으며, 나중에 내장된 언어 관리 명령어를 사용하여 언어를 전환할 수 있습니다.
+
 이것은 폴더 구조를 설정하고 프로젝트에 명령 파일을 설치/업데이트합니다. 기존 설치를 업데이트하는 데도 사용할 수 있으며, 명령 파일은 자동으로 백업됩니다.
 
+**설치 옵션**:
+
+- 대화형 설치: 언어 선택 후 설치
+- 강제 설치: `npx aiwf --force` (자동 감지된 언어 사용)
+- 언어 관리: 설치 후 언어 전환을 위한 `aiwf-lang` 명령어 사용
+
 ### 2. 프로젝트 초기화하기
 
 Claude Code에서 프로젝트를 열고 다음을 실행하세요:
 
 ```
-/project:moonklabs:initialize
+/project:aiwf:initialize
 ```
 
 이것은 기본 설정 과정을 안내합니다. 새로운 코드베이스나 기존 코드베이스와 함께 작동하며, 프로젝트 문서(PRD, 아키텍처 문서)를 생성하거나 이미 가지고 있는 문서와 함께 작업하는 데 도움을 줍니다.
 
 ### 3. 첫 번째 마일스톤 설정하기
 
-`.moonklabs/02_REQUIREMENTS/`에 `M01_Your_Milestone_Name`(예: `M01_Basic_Application`)이라는 이름의 마일스톤 폴더를 생성하세요. 최소한 다음을 포함하세요:
+`.aiwf/02_REQUIREMENTS/`에 `M01_Your_Milestone_Name`(예: `M01_Basic_Application`)이라는 이름의 마일스톤 폴더를 생성하세요. 최소한 다음을 포함하세요:
 
 - `M01_PRD.md` - 제품 요구사항 문서
 - 필요에 따른 기타 사양: `M01_Database_Schema.md`, `M01_API_Specs.md` 등
@@ -42,7 +50,7 @@ _참고: 아직 이를 위한 명령어는 없습니다. 2단계의 기존 채
 ### 4. 스프린트로 분할하기
 
 ```
-/project:moonklabs:create_sprints_from_milestone
+/project:aiwf:create_sprints_from_milestone
 ```
 
 이것은 마일스톤을 분석하고 논리적인 스프린트로 분할합니다. 전체 범위를 살펴보고 아직 세부 작업 없이 의미 있는 스프린트 경계를 생성합니다.
@@ -50,7 +58,7 @@ _참고: 아직 이를 위한 명령어는 없습니다. 2단계의 기존 채
 ### 5. 첫 번째 작업 생성하기
 
 ```
-/project:moonklabs:create_sprint_tasks
+/project:aiwf:create_sprint_tasks
 ```
 
 이것은 스프린트를 분석하고, 문서를 검토하며, 필요한 정보를 조사하고, 프로젝트에 대한 포괄적인 이해를 얻기 위한 지식 격차를 식별합니다. 현재 스프린트에 대한 상세하고 실행 가능한 작업을 생성합니다.
@@ -60,22 +68,22 @@ _중요: 모든 스프린트에 대한 작업을 미리 생성하지 말고 다
 ### 6. 작업 시작하기
 
 ```
-/project:moonklabs:do_task
+/project:aiwf:do_task
 ```
 
 이것은 일반 작업이나 스프린트에서 작업을 자동으로 선택합니다. 더 빠른 실행을 위해 작업 ID를 지정하세요:
 
 ```
-/project:moonklabs:do_task T01_S01
+/project:aiwf:do_task T01_S01
 ```
 
 그러면 Claude는 전체 프로젝트 컨텍스트와 함께 지정된 작업을 수행합니다.
 
 이것이 시작하기 위한 기본 워크플로입니다! 또한 다음과 같은 작업도 가능합니다:
 
-- `/project:moonklabs:create_general_task`로 일반 작업 생성
+- `/project:aiwf:create_general_task`로 일반 작업 생성
 - YOLO 모드를 사용하여 전체 스프린트 또는 마일스톤을 자율적으로 실행
-- `.claude/commands/moonklabs/`에서 다른 명령어 탐색
+- `.claude/commands/aiwf/`에서 다른 명령어 탐색
 
 ### 7. YOLO 모드 - 자율 실행
 
@@ -84,7 +92,7 @@ YOLO 모드는 사용자 개입 없이 연속적으로 작업을 실행하는
 **기본 YOLO 모드:**
 
 ```
-/project:moonklabs:yolo
+/project:aiwf:yolo
 ```
 
 일반 작업을 먼저 처리한 후 활성 스프린트 작업을 실행합니다.
@@ -92,7 +100,7 @@ YOLO 모드는 사용자 개입 없이 연속적으로 작업을 실행하는
 **스프린트별 실행:**
 
 ```
-/project:moonklabs:yolo S03
+/project:aiwf:yolo S03
 ```
 
 지정된 스프린트(S03)의 모든 작업을 완료할 때까지 실행합니다.
@@ -100,7 +108,7 @@ YOLO 모드는 사용자 개입 없이 연속적으로 작업을 실행하는
 **🚀 NEW: 전체 스프린트 실행:**
 
 ```
-/project:moonklabs:yolo sprint-all
+/project:aiwf:yolo sprint-all
 ```
 
 모든 스프린트를 순차적으로 완료할 때까지 멈추지 않고 실행합니다.
@@ -108,7 +116,7 @@ YOLO 모드는 사용자 개입 없이 연속적으로 작업을 실행하는
 **🚀 NEW: 전체 마일스톤 실행:**
 
 ```
-/project:moonklabs:yolo milestone-all
+/project:aiwf:yolo milestone-all
 ```
 
 모든 마일스톤과 관련된 스프린트, 작업을 완료할 때까지 실행합니다.
@@ -116,8 +124,8 @@ YOLO 모드는 사용자 개입 없이 연속적으로 작업을 실행하는
 **🔧 Worktree 모드:**
 
 ```
-/project:moonklabs:yolo S03 worktree
-/project:moonklabs:yolo sprint-all worktree
+/project:aiwf:yolo S03 worktree
+/project:aiwf:yolo sprint-all worktree
 ```
 
 Git worktree 환경에서 실행 시 브랜치 생성 없이 직접 푸시합니다.
@@ -136,11 +144,11 @@ Git worktree 환경에서 실행 시 브랜치 생성 없이 직접 푸시합니
 - 테스트가 10% 이상 실패하면 평가 후 진행 여부를 결정합니다
 - 데이터베이스 스키마 변경이 필요하면 중단됩니다
 
-**중요**: Moonklabs은 단순한 설정 후 잊어버리는 도구가 아닌 복잡한 시스템입니다. 작동 방식을 이해할 때 가장 효과적으로 작동합니다. 명령어를 읽어보고 워크플로에 맞게 조정하는 시간을 가지세요.
+**중요**: AIWF은 단순한 설정 후 잊어버리는 도구가 아닌 복잡한 시스템입니다. 작동 방식을 이해할 때 가장 효과적으로 작동합니다. 명령어를 읽어보고 워크플로에 맞게 조정하는 시간을 가지세요.
 
 ## 작동 방식
 
-Moonklabs은 프로젝트를 다음과 같이 구성합니다:
+AIWF은 프로젝트를 다음과 같이 구성합니다:
 
 - **마일스톤**: 주요 기능 또는 프로젝트 단계
 - **스프린트**: 마일스톤 내의 관련 작업 그룹
@@ -202,9 +210,9 @@ AI 코딩 도구는 믿을 수 없을 정도로 강력해졌지만, 모두 동
 - 아키텍처 결정을 문서화하기 위한 ADR 템플릿
 - 모든 템플릿은 단순화된 날짜 형식(YYYY-MM-DD HH:MM)을 사용합니다
 
-### .claude/commands/moonklabs/
+### .claude/commands/aiwf/
 
-Moonklabs 워크플로를 구동하는 맞춤형 Claude Code 명령어:
+AIWF 워크플로를 구동하는 맞춤형 Claude Code 명령어:
 
 - `initialize` - 프로젝트 구조와 문서를 설정
 - `create_sprints_from_milestone` - 마일스톤을 논리적 스프린트로 분할
@@ -216,12 +224,18 @@ Moonklabs 워크플로를 구동하는 맞춤형 Claude Code 명령어:
   - 모든 마일스톤 실행: `yolo milestone-all`
   - Worktree 지원: `yolo sprint-all worktree`
   - 연속 실행과 상세 진행률 리포트 제공
+- `language_manager` - 포괄적 언어 관리 시스템:
+  - 현재 언어 설정 및 상태 확인
+  - 대화형 언어 전환
+  - 시스템 언어 선호도 자동 감지
 - 그 외 테스트, 리뷰, 프로젝트 관리용 명령어 다수
 
+**언어 지원**: 모든 명령어는 완전한 기능적 동등성과 표준화된 품질을 갖춘 영어 및 한국어 버전으로 제공됩니다.
+
 ## 디렉토리 구조
 
 ```plaintext
-.moonklabs/
+.aiwf/
 ├── 00_PROJECT_MANIFEST.md
 ├── 01_PROJECT_DOCS/
 ├── 02_REQUIREMENTS/
@@ -250,7 +264,7 @@ Moonklabs 워크플로를 구동하는 맞춤형 Claude Code 명령어:
 
 ### 병렬 작업 실행 활성화
 
-`create_sprint_tasks`와 같은 Moonklabs 명령은 `useParallelSubagents` 지시어를 지원하지만, 실제로 작업을 병렬로 실행하려면 Claude Code 설정이 필요합니다. 기본적으로는 한 번에 하나의 작업만 실행됩니다.
+`create_sprint_tasks`와 같은 AIWF 명령은 `useParallelSubagents` 지시어를 지원하지만, 실제로 작업을 병렬로 실행하려면 Claude Code 설정이 필요합니다. 기본적으로는 한 번에 하나의 작업만 실행됩니다.
 
 병렬 실행을 활성화하려면:
 

package/docs/AI-WORKFLOW.md

@@ -0,0 +1,299 @@
+# AIWF for Claude Code
+
+## What is this?
+
+AIWF is a directory-based project management system I created to work more effectively with Claude Code and Gemini-CLI. It's essentially a collection of folders, markdown files, and custom commands that help break down software projects into manageable units that AI can effectively process.
+
+**🚀 NEW**: Enhanced YOLO mode can now automatically complete entire sprints or milestones at once!
+
+**⚠️ Complexity Warning**: AIWF is a sophisticated system that takes time to understand properly. It's not a simple plug-and-play solution, but a framework that works best when you invest time to learn how it works and adapt it to your workflow.
+
+**📋 Latest Updates**: See [CHANGELOG.md](CHANGELOG.md) for recent changes and improvements.
+
+## Getting Started
+
+### 1. Install AIWF
+
+```bash
+npx aiwf
+```
+
+**Multi-language Support**: AIWF features a comprehensive language management system with intelligent detection and preference storage. During installation, you can choose between English and Korean, and later switch languages using the built-in language management commands.
+
+This sets up the folder structure and installs/updates command files in your project. You can also use it to update existing installations - command files are automatically backed up.
+
+**Installation Options**:
+
+- Interactive installation: Select language then install
+- Force installation: `npx aiwf --force` (uses auto-detected language)
+- Language management: Use `aiwf-lang` commands for post-installation language switching
+
+### 2. Initialize Your Project
+
+Open your project in Claude Code and run:
+
+```
+/project:aiwf:initialize
+```
+
+This guides you through the basic setup process. It works with both new and existing codebases, helping you create project documentation (PRD, architecture docs) or work with documents you already have.
+
+### 3. Set Up Your First Milestone
+
+Create a milestone folder in `.aiwf/02_REQUIREMENTS/` named `M01_Your_Milestone_Name` (e.g., `M01_Basic_Application`). Include at minimum:
+
+- `M01_PRD.md` - Product Requirements Document
+- Other specifications as needed: `M01_Database_Schema.md`, `M01_API_Specs.md`, etc.
+
+_Note: There's no command for this yet. Use the existing chat from step 2 to guide Claude in creating the milestone, ensuring proper naming with the `M##_` prefix and underscores._
+
+### 4. Break Down Into Sprints
+
+```
+/project:aiwf:create_sprints_from_milestone
+```
+
+This analyzes your milestone and breaks it down into logical sprints. It looks at the entire scope and creates meaningful sprint boundaries without detailed tasks yet.
+
+### 5. Create Your First Tasks
+
+```
+/project:aiwf:create_sprint_tasks
+```
+
+This analyzes the sprint, reviews documentation, researches necessary information, and identifies knowledge gaps to gain comprehensive understanding of the project. It creates detailed, actionable tasks for the current sprint.
+
+_Important: Don't pre-create tasks for all sprints, only create tasks for the next sprint. After completing Sprint 1, create tasks for Sprint 2. This allows the system to reference the existing codebase and incorporate completed work into future task creation._
+
+### 6. Start Working on Tasks
+
+```
+/project:aiwf:do_task
+```
+
+This automatically selects a task from general tasks or sprints. For faster execution, specify the task ID:
+
+```
+/project:aiwf:do_task T01_S01
+```
+
+Claude will then perform the specified task with full project context.
+
+That's the basic workflow to get started! You can also:
+
+- Create general tasks with `/project:aiwf:create_general_task`
+- Use YOLO mode to autonomously execute entire sprints or milestones
+- Explore other commands in `.claude/commands/aiwf/`
+
+### 7. YOLO Mode - Autonomous Execution
+
+YOLO mode is a powerful feature that executes tasks continuously without user intervention:
+
+**Basic YOLO mode:**
+
+```
+/project:aiwf:yolo
+```
+
+Processes general tasks first, then executes active sprint tasks.
+
+**Sprint-specific execution:**
+
+```
+/project:aiwf:yolo S03
+```
+
+Runs until all tasks in the specified sprint (S03) are complete.
+
+**🚀 NEW: Full Sprint Execution:**
+
+```
+/project:aiwf:yolo sprint-all
+```
+
+Runs continuously without stopping until all sprints are completed sequentially.
+
+**🚀 NEW: Full Milestone Execution:**
+
+```
+/project:aiwf:yolo milestone-all
+```
+
+Runs until all milestones and their associated sprints and tasks are complete.
+
+**🔧 Worktree Mode:**
+
+```
+/project:aiwf:yolo S03 worktree
+/project:aiwf:yolo sprint-all worktree
+```
+
+When running in a Git worktree environment, pushes directly without creating branches.
+
+**YOLO Mode Features:**
+
+- ⚡ Continuous execution: Moves to next task immediately after each completion
+- 🎯 Fully autonomous: Proceeds without user input or confirmation
+- 📊 Progress tracking: Reports current progress in real-time
+- 🛡️ Safety guards: Stops on test failures or critical errors
+- 📈 Detailed reports: Provides comprehensive project status report on completion
+
+**⚠️ Cautions:**
+
+- Stops when modifying critical files (.env, migrations)
+- Evaluates whether to continue if tests fail by more than 10%
+- Stops if database schema changes are required
+
+**Important**: AIWF is a complex system, not a simple set-and-forget tool. It works most effectively when you understand how it operates. Take time to read through the commands and adjust them to your workflow.
+
+## How It Works
+
+AIWF organizes projects into:
+
+- **Milestones**: Major features or project phases
+- **Sprints**: Groups of related tasks within milestones
+- **Tasks**: Individual work items scoped to fit in a single Claude session
+
+Each task pulls in full project context so Claude knows exactly what to build and how it fits into the architecture.
+
+## Why I Made This
+
+AI coding tools have become incredibly powerful, but they all face the same fundamental challenge: context management. Context windows are limited in size, and we have little control over what stays in context and what doesn't.
+
+The problem with long-running sessions is context decay - as you work, important project knowledge quietly falls off the end of the context window. You don't know what's been forgotten until something goes wrong.
+
+My solution: Start fresh for each task but provide rich surrounding context. By keeping tasks focused and well-scoped, we can dedicate more of the context window to relevant project knowledge, requirements, and architectural decisions. This way:
+
+- Each task starts with exactly the project context it needs
+- Important knowledge doesn't get lost in long sessions
+- Claude can work confidently with full understanding of requirements
+- Surrounding context guides development beyond simple task descriptions
+
+The result is a task-based workflow where Claude always has the right context for the job at hand.
+
+## Key Components
+
+### 00_PROJECT_MANIFEST.md
+
+The core document containing your project's vision, goals, and high-level overview. Serves as Claude's starting point for understanding your project. **Important**: The manifest filename must be `00_PROJECT_MANIFEST.md`, not `MANIFEST.md`.
+
+### 01_PROJECT_DOCS/
+
+Contains general project documentation that Claude can reference - technical specifications, user guides, API documentation, etc.
+
+### 02_REQUIREMENTS/
+
+Organized by milestone, this directory holds Product Requirements Documents (PRDs) and amendments that clearly show what needs to be built. This is how Claude understands project requirements. Milestone folders should follow the format `M##_Milestone_Name/` (e.g., `M01_Backend_Setup/`).
+
+### 03_SPRINTS/
+
+Contains sprint plans and task definitions organized by milestone and sprint order. Each sprint folder contains individual task files with detailed information for Claude to work with.
+
+### 04_GENERAL_TASKS/
+
+Stores task definitions that don't belong to a specific sprint. Completed tasks use the `TX` prefix (e.g., `TX001_Completed_Task.md`)—this helps Claude easily identify completed work.
+
+### 05_ARCHITECTURAL_DECISIONS/
+
+Records important architectural decisions in ADR (Architecture Decision Record) format, documenting context, options considered, and rationale. This provides essential context for Claude when making technical decisions. Uses a structured ADR template for consistency.
+
+### 10_STATE_OF_PROJECT/
+
+Contains timestamped project review snapshots generated by the `project_review` command. This maintains a history of project state, technical decisions, and progress.
+
+### 99_TEMPLATES/
+
+Contains standardized templates for various document types to ensure consistency for both humans and Claude:
+
+- Task templates with structured goals and acceptance criteria
+- Sprint and milestone metadata templates
+- ADR templates for documenting architectural decisions
+- All templates use simplified date format (YYYY-MM-DD HH:MM)
+
+### .claude/commands/aiwf/
+
+Custom Claude Code commands that drive the AIWF workflow:
+
+- `initialize` - Set up project structure and documentation
+- `create_sprints_from_milestone` - Break milestones into logical sprints
+- `create_sprint_tasks` - Generate detailed tasks from sprint plans
+- `do_task` - Execute individual tasks with full context
+- `yolo` - Powerful autonomous execution system:
+  - Execute specific sprint: `yolo S03`
+  - Execute all sprints: `yolo sprint-all`
+  - Execute all milestones: `yolo milestone-all`
+  - Worktree support: `yolo sprint-all worktree`
+  - Provides continuous execution and detailed progress reports
+- `language_manager` - Comprehensive language management system:
+  - Check current language settings and status
+  - Switch between languages interactively
+  - Auto-detect system language preferences
+- Many more commands for testing, review, and project management
+
+**Language Support**: All commands are available in both English and Korean versions with complete functional equivalence and standardized quality.
+
+## Directory Structure
+
+```plaintext
+.aiwf/
+├── 00_PROJECT_MANIFEST.md
+├── 01_PROJECT_DOCS/
+├── 02_REQUIREMENTS/
+│   ├── M01_Backend_Setup/
+│   ├── M02_Frontend_Setup/
+│   └── ...
+├── 03_SPRINTS/
+│   ├── S01_M01_Initial_API/
+│   ├── S02_M01_Database_Schema/
+│   └── ...
+├── 04_GENERAL_TASKS/
+│   ├── TX001_Refactor_Logging_Module.md  # Completed task
+│   ├── T002_API_Rate_Limiting.md          # Open task
+│   └── ...
+├── 05_ARCHITECTURE_DECISIONS/
+│   ├── ADR001_Database_Selection.md
+│   └── ...
+├── 10_STATE_OF_PROJECT/         # Project review snapshots
+└── 99_TEMPLATES/
+    ├── task_template.md
+    ├── sprint_meta_template.md
+    └── milestone_meta_template.md
+```
+
+## Configuration Tips
+
+### Enable Parallel Task Execution
+
+AIWF commands like `create_sprint_tasks` support the `useParallelSubagents` directive, but to actually execute tasks in parallel requires Claude Code configuration. By default, only one task runs at a time.
+
+To enable parallel execution:
+
+```bash
+# Set the number of parallel tasks (example: 3)
+claude config set --global "parallelTasksCount" 3
+
+# Check your current configuration
+claude config list -g
+```
+
+**Important Considerations:**
+
+- Choose a number based on your system performance and rate limits
+- Parallel execution significantly increases API usage
+- Some tasks may conflict when run in parallel
+- Start with a small number (2-3) and adjust based on experience
+
+## Contributing and Feedback
+
+I'd love to hear from you! This is tailored to my workflow, so there's plenty of room for improvement.
+
+- **GitHub Issues**: Best place for bugs and feature requests
+- **Anthropic Discord**: Find me at @helmi if you want to chat
+- **Pull Requests**: Always welcome! Let's make this better together
+
+I'm particularly interested in:
+
+- How you're using it differently
+- What's missing from your workflow
+- Ideas for better Claude Code integration
+- Different ways to organize things