aiwf 0.1.0 → 0.3.1

package/claude-code/aiwf/ko/.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/claude-code/aiwf/ko/.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/claude-code/aiwf/ko/.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}}

package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/milestone_meta_template.md

@@ -0,0 +1,25 @@
+---
+milestone_id: M<ID>
+title: Milestone Title
+status: pending # pending | active | completed | blocked | on_hold
+last_updated: YYYY-MM-DD HH:MM
+---
+
+## Milestone: {{ title }}
+
+### Goals
+- Clearly define the primary objectives of this milestone.
+- What should be achieved by the end of this milestone?
+
+### Key Documents
+
+List the main requirement documents associated with this milestone (e.g., PRD, Technical Specifications).
+
+- `PRD_<Milestone_Name>.md`
+- `SPECS_<Milestone_Name>.md`
+
+### Definition of Done (DoD)
+- Specific, measurable criteria that must be met for this milestone to be considered complete.
+
+### Notes / Context (Optional)
+- Any additional context, high-level strategy, or important notes related to this milestone for Claude.

package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/project_manifest_template.md

@@ -0,0 +1,39 @@
+---
+project_name: {{project_name}}
+current_milestone_id: {{current_milestone_id}}
+highest_sprint_in_milestone: {{highest_sprint_in_milestone}}
+current_sprint_id: {{current_sprint_id}}
+status: active
+last_updated: {{timestamp}}
+---
+
+# Project Manifest: {{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
+
+{{project_vision}}
+
+This project follows a milestone-based development approach.
+
+## 2. Current Focus
+
+- **Milestone:** {{current_milestone_id}} - {{current_milestone_name}}
+- **Sprint:** {{current_sprint_id}} - {{current_sprint_name}}
+
+## 3. Sprints in Current Milestone
+
+{{sprint_list}}
+
+## 4. Key Documentation
+
+- [Architecture Documentation](./01_PROJECT_DOCS/ARCHITECTURE.md)
+- [Current Milestone Requirements](./02_REQUIREMENTS/{{current_milestone_id}}_{{current_milestone_slug}}/)
+- [General Tasks](./04_GENERAL_TASKS/)
+
+## 5. Quick Links
+
+- **Current Sprint:** [{{current_sprint_id}} Sprint Folder](./03_SPRINTS/{{current_sprint_id}}_{{current_milestone_id}}_{{current_sprint_slug}}/)
+- **Active Tasks:** Check sprint folder for T##_{{current_sprint_id}}_*.md files
+- **Project Reviews:** [Latest Review](./10_STATE_OF_PROJECT/)

package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/sprint_meta_template.md

@@ -0,0 +1,23 @@
+---
+sprint_folder_name: S<SprintSequenceID>_M<MilestoneID>_<Short_Name>
+sprint_sequence_id: S<ID>
+milestone_id: M<ID>
+title: Sprint Title - Focus of this Sprint
+status: pending # pending | active | completed | aborted
+goal: Clearly state the primary objective of this sprint.
+last_updated: YYYY-MM-DDTHH:MM:SSZ
+---
+
+# Sprint: {{ title }} ({{ sprint_sequence_id }})
+
+## Sprint Goal
+{{ goal }}
+
+## Scope & Key Deliverables (Optional)
+- What specific features, fixes, or outcomes are targeted in this sprint for Claude to work on?
+
+## Definition of Done (for the Sprint) (Optional)
+- What conditions must be met for the sprint itself to be considered successfully completed?
+
+## Notes / Retrospective Points (Optional)
+- Any specific notes for this sprint.

package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/task_template.md

@@ -0,0 +1,36 @@
+---
+task_id: T<TaskNN>_S<SprintSequenceID> # For Sprint Tasks (e.g., T01_S01) OR T<NNN> for General Tasks (e.g., T501)
+sprint_sequence_id: S<ID> # e.g., S01 (If part of a sprint, otherwise null or absent)
+status: open # open | in_progress | pending_review | done | failed | blocked
+complexity: Medium # Low | Medium | High
+last_updated: YYYY-MM-DDTHH:MM:SSZ
+github_issue: # Optional: GitHub issue number (e.g., #123)
+---
+
+# Task: (Filename serves as the descriptive title)
+
+## Description
+Briefly explain what this task is about. Provide necessary context to understand the 'why' behind the task.
+
+## Goal / Objectives
+Clearly state what needs to be achieved by completing this task. What does success look like?
+- Objective 1
+- Objective 2
+
+## Acceptance Criteria
+Specific, measurable conditions that must be met for this task to be considered 'done'.
+- [ ] Criterion 1 is met.
+- [ ] Criterion 2 is verified.
+
+## Subtasks
+A checklist of smaller steps to complete this task.
+- [ ] Subtask 1
+- [ ] Subtask 2
+
+## Output Log
+*(This section is populated as work progresses on the task)*
+
+[YYYY-MM-DD HH:MM:SS] Started task
+[YYYY-MM-DD HH:MM:SS] Modified files: file1.js, file2.js
+[YYYY-MM-DD HH:MM:SS] Completed subtask: Implemented feature X
+[YYYY-MM-DD HH:MM:SS] Task completed

package/claude-code/aiwf/ko/.aiwf/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md - AIWF Framework Structure Guide
+
+Always communicate in Korean
+
+## Overview
+
+This is the root directory of the AIWF framework structure. It contains all project documentation, requirements, sprints, and organizational files.
+
+## Critical Files
+
+### Project Manifest
+
+**IMPORTANT**: The project manifest file MUST be named:
+
+```
+00_PROJECT_MANIFEST.md
+```
+
+**NOT**:
+
+- ❌ `MANIFEST.md`
+- ❌ `PROJECT_MANIFEST.md`
+- ❌ `project_manifest.md`
+
+The manifest is the central reference file that tracks:
+
+- Project name and status
+- Current milestone and sprint
+- Project metadata
+- Last updated timestamp
+
+## Directory Structure
+
+```
+.AIWF/
+├── 00_PROJECT_MANIFEST.md          # Central project reference (CORRECT NAME)
+├── 01_PROJECT_DOCS/                # General project documentation
+├── 02_REQUIREMENTS/                # Milestone-based requirements
+├── 03_SPRINTS/                     # Sprint execution folders
+├── 04_GENERAL_TASKS/               # Non-sprint tasks
+├── 05_ARCHITECTURAL_DECISIONS/     # ADR documentation
+├── 10_STATE_OF_PROJECT/            # Project review snapshots
+└── 99_TEMPLATES/                   # Document templates
+```
+
+## Naming Conventions Summary
+
+### Files
+
+- **Project Manifest**: `00_PROJECT_MANIFEST.md`
+- **Milestone Meta**: `M##_milestone_meta.md`
+- **Sprint Meta**: `S##_M##_sprint_meta.md`
+- **Task Files**: `TASK_##_*.md`
+- **ADR Files**: `ADR_###_*.md`
+
+### Folders
+
+- **Milestones**: `M##_Milestone_Name/`
+- **Sprints**: `S##_M##_Sprint_Name/`
+- **State Snapshots**: `YYYY-MM-DD_HH-MM_snapshot/`
+
+## Important Notes for Claude Code
+
+1. **Always create `00_PROJECT_MANIFEST.md`** when initializing a project
+2. **Use the templates** from `99_TEMPLATES/` for consistency
+3. **Follow the naming conventions exactly** - they enable proper sorting and navigation
+4. **Update the manifest** when creating milestones or sprints
+5. **Use underscores** for spaces in folder and file names
+
+## Common Initialization Mistakes
+
+- Creating `MANIFEST.md` instead of `00_PROJECT_MANIFEST.md`
+- Missing the leading zeros in numbered prefixes
+- Using hyphens instead of underscores
+- Creating files without using templates
+- Not updating the manifest after structural changes

package/claude-code/aiwf/ko/.aiwf/README.md

@@ -0,0 +1,97 @@
+# AIWF Framework
+
+AIWF is a project management system designed to work with Claude Code's strengths and limitations. It provides structure for breaking down software projects into manageable, context-aware tasks.
+
+## Core Concept
+
+The fundamental challenge: AI context windows are limited and we can't control what information stays or leaves during long sessions. AIWF solves this by starting fresh for each task while providing rich, relevant context.
+
+## How AIWF Works
+
+### 1. Requirements First
+
+Projects begin with well-documented requirements and specifications:
+
+**In `01_PROJECT_DOCS/`:**
+
+- Architecture specifications (ARCHITECTURE.md is required)
+- Technical design documents
+- API specifications
+- Database schemas
+- Integration guides
+
+**In `02_REQUIREMENTS/`:**
+
+- Product Requirements Documents (PRDs) organized by milestone
+- Feature specifications
+- User stories and acceptance criteria
+
+Both directories work together to define what gets built and how.
+
+### 2. Structured Breakdown
+
+Work is organized hierarchically:
+
+- **Milestones** (M01, M02...) - Major project phases
+- **Sprints** (S01, S02...) - Focused work periods within milestones
+- **Tasks** (T01, T02...) - Atomic units of work
+
+### 3. Task Execution Flow
+
+Each task follows a strict workflow:
+
+1. Task selected from sprint or general tasks
+2. Status updated to `in_progress`
+3. Work performed following acceptance criteria
+4. Automatic code review against requirements
+5. Task marked `done` only after review passes
+6. File renamed with `TX` prefix to indicate completion
+
+### 4. Context Management
+
+For each task, AIWF provides:
+
+- The specific task description and criteria
+- Relevant sprint and milestone context
+- Architecture and requirements documentation
+- Project manifest for current state awareness
+
+This ensures Claude has exactly what's needed without information overload.
+
+### 5. Quality Control
+
+Built-in review processes maintain standards:
+
+- **Code Review**: Every task completion triggers requirement validation
+- **Project Review**: Regular health checks create timestamped snapshots
+- **Zero Tolerance**: Any deviation from specifications fails review
+
+## Directory Purpose
+
+- `00_PROJECT_MANIFEST.md` - Current project state and focus
+- `01_PROJECT_DOCS/` - Technical foundation (architecture, APIs, schemas)
+- `02_REQUIREMENTS/` - Business requirements organized by milestone
+- `03_SPRINTS/` - Sprint organization and task definitions
+- `04_GENERAL_TASKS/` - Non-sprint specific tasks
+- `05_ARCHITECTURE_DECISIONS/` - ADRs for key decisions
+- `10_STATE_OF_PROJECT/` - Project review history
+- `99_TEMPLATES/` - Standardized file templates
+
+## Commands Overview
+
+AIWF commands (`/project:AIWF:command`) automate the workflow:
+
+- Planning: `plan_milestone`, `create_sprint`
+- Execution: `create_task`, `do_task`, `code_review`
+- Maintenance: `commit`, `project_review`, `discuss_review`
+- Utilities: `initialize`
+
+## Key Principles
+
+1. **Fresh Context**: Each task starts with a clean slate
+2. **Focused Scope**: Tasks are sized for single-session completion
+3. **Rich Context**: Surrounding documentation guides development
+4. **Strict Validation**: Requirements are enforced, not suggested
+5. **Progressive Documentation**: Knowledge accumulates in structured form
+
+The result: Claude can always work confidently with full project awareness, regardless of session history.