@leejungkiin/awkit 1.0.0

package/templates/specs/design-template.md

@@ -0,0 +1,166 @@
+# [Feature Name] Design Document
+
+## Overview
+
+[High-level description of the feature architecture - describe the overall approach, key design decisions, and how it fits into the larger system]
+
+## Architecture
+
+[Description of architectural approach and patterns used]
+
+### Component Hierarchy
+
+```
+[FeatureName]View (Root)
+├── [HeaderComponent] (Navigation and context)
+├── [MainContainer] (Primary content)
+│   ├── [ContentSection1]
+│   │   ├── [SubComponent1]
+│   │   └── [SubComponent2]
+│   ├── [ContentSection2]
+│   │   └── [SubComponent3]
+│   └── [ActionSection]
+│       └── [ActionButtons]
+├── [FloatingElements] (Overlays, FABs)
+└── [ModalComponents] (Sheets, Dialogs)
+```
+
+## Components and Interfaces
+
+### [MainComponent]
+- **Purpose**: [What this component does and why]
+- **Platform-Specific Design**:
+  - iOS: [Apple HIG considerations, SF Symbols, native patterns]
+  - Android: [Material Design 3 components, patterns]
+- **Key Features**:
+  - [Feature 1 with implementation detail]
+  - [Feature 2 with implementation detail]
+  - [Animations and transitions]
+
+### [SubComponent1]
+- **Purpose**: [Component purpose]
+- **Visual Design**:
+  - [Layout specifications]
+  - [Color and typography]
+  - [Spacing and sizing]
+- **Interaction Design**:
+  - [Touch/click behavior]
+  - [Hover states (if applicable)]
+  - [Animation specs]
+
+## Data Models
+
+### [PrimaryModel]
+```swift
+// iOS
+struct [ModelName]: Codable, Identifiable {
+    let id: UUID
+    let property1: String
+    let property2: Int
+    let optionalProperty: String?
+    let nestedObject: [NestedType]
+    let createdAt: Date
+    let updatedAt: Date
+    
+    enum CodingKeys: String, CodingKey {
+        case id
+        case property1 = "property_1"
+        // ... mapping for API compatibility
+    }
+}
+```
+
+```kotlin
+// Android
+data class [ModelName](
+    val id: String,
+    val property1: String,
+    val property2: Int,
+    val optionalProperty: String?,
+    val nestedObject: List<NestedType>,
+    val createdAt: Instant,
+    val updatedAt: Instant
+)
+```
+
+### [StateModel]
+```swift
+// iOS - ViewModel State
+enum [Feature]ViewState {
+    case idle
+    case loading
+    case loaded([DataModel])
+    case error(Error)
+    case empty
+}
+```
+
+```kotlin
+// Android - UI State
+sealed interface [Feature]UiState {
+    data object Loading : [Feature]UiState
+    data class Success(val data: List<DataModel>) : [Feature]UiState
+    data class Error(val message: String) : [Feature]UiState
+    data object Empty : [Feature]UiState
+}
+```
+
+## Correctness Properties
+
+*Properties serve as the bridge between requirements and verifiable correctness guarantees.*
+
+**Property 1: [Property Name]**
+*For any* [scenario/input], the system should [expected behavior across all conditions]
+**Validates: Requirements 1.1, 1.2, 1.3**
+
+**Property 2: [Property Name]**
+*For any* [scenario/input], the system should [expected behavior]
+**Validates: Requirements 2.1, 2.2**
+
+**Property 3: Error Handling Correctness**
+*For any* error condition, the system should [graceful handling, user feedback, recovery options]
+**Validates: Requirements 3.1, 3.2, 3.3**
+
+## UI/UX Design Specifications
+
+### Visual Design System
+
+**Colors:**
+| Token | Light Mode | Dark Mode | Usage |
+|-------|------------|-----------|-------|
+| Primary | #[hex] | #[hex] | [usage] |
+| Secondary | #[hex] | #[hex] | [usage] |
+| Background | #[hex] | #[hex] | [usage] |
+
+**Typography:**
+| Style | Font | Size | Weight | Usage |
+|-------|------|------|--------|-------|
+| Title | [font] | 24pt | Bold | [usage] |
+| Body | [font] | 16pt | Regular | [usage] |
+
+**Spacing:**
+| Token | Value | Usage |
+|-------|-------|-------|
+| xs | 4pt | [usage] |
+| sm | 8pt | [usage] |
+| md | 16pt | [usage] |
+
+### Animation Specifications
+
+| Animation | Duration | Easing | Description |
+|-----------|----------|--------|-------------|
+| Appear | 300ms | easeOut | [description] |
+| Disappear | 200ms | easeIn | [description] |
+| Spring | 0.5s/0.7 | spring | [response/damping] |
+
+## Performance Considerations
+
+- **Lazy Loading**: [What should be lazy loaded]
+- **Caching Strategy**: [How data should be cached]
+- **Memory Management**: [Memory considerations]
+
+## Security Considerations
+
+- **Data Encryption**: [What needs encryption]
+- **Input Validation**: [Validation requirements]
+- **Authentication**: [Auth requirements]

package/templates/specs/requirements-template.md

@@ -0,0 +1,65 @@
+# [Feature Name] Requirements Document
+
+## Introduction
+
+[Brief description of the feature and its purpose - 2-3 sentences explaining what problem it solves and why it's important to users]
+
+## Glossary
+
+- **[Term_1]**: [Clear definition of domain-specific term]
+- **[Term_2]**: [Clear definition of domain-specific term]
+- **[System_Component]**: [Description of system component mentioned in requirements]
+
+## Requirements
+
+### Requirement 1
+
+**User Story:** As a [user type], I want to [action/capability], so that [benefit/value].
+
+#### Acceptance Criteria
+
+1. WHEN [triggering condition], THE [System_Component] SHALL [expected behavior]
+2. WHEN [triggering condition], THE [System_Component] SHALL [expected behavior]
+3. WHILE [ongoing context], THE [System_Component] SHALL [maintained behavior]
+4. IF [condition], THE [System_Component] SHALL [conditional behavior]
+5. WHEN [edge case], THE [System_Component] SHALL [edge case handling]
+
+### Requirement 2
+
+**User Story:** As a [user type], I want to [action/capability], so that [benefit/value].
+
+#### Acceptance Criteria
+
+1. WHEN [condition], THE [System_Component] SHALL [behavior]
+2. WHEN [condition], THE [System_Component] SHALL [behavior]
+3. WHILE [context], THE [System_Component] SHALL [behavior]
+
+### Requirement 3 (Error Handling)
+
+**User Story:** As a [user type], I want [error recovery capability], so that [resilience benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [error condition], THE [System_Component] SHALL [error handling]
+2. WHEN [network failure], THE [System_Component] SHALL [offline handling]
+3. WHEN [invalid input], THE [System_Component] SHALL [validation feedback]
+
+### Requirement 4 (Security)
+
+**User Story:** As a [user type], I want [security feature], so that [security benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [sensitive data access], THE [System_Component] SHALL [security measure]
+2. WHEN [authentication required], THE [System_Component] SHALL [auth flow]
+3. WHILE [session active], THE [System_Component] SHALL [session management]
+
+### Requirement 5 (Accessibility)
+
+**User Story:** As a [user with accessibility needs], I want [accessibility feature], so that [inclusive benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [using screen reader], THE [System_Component] SHALL [accessibility support]
+2. WHEN [using keyboard only], THE [System_Component] SHALL [keyboard navigation]
+3. WHILE [displaying content], THE [System_Component] SHALL [contrast/sizing support]

package/templates/specs/tasks-template.md

@@ -0,0 +1,132 @@
+# [Feature Name] Implementation Plan
+
+## Overview
+This implementation plan converts the [Feature Name] design into incremental coding tasks. Each task builds upon previous work and focuses on delivering functional code that meets all requirements.
+
+## Meta
+- **Design:** ./design.md
+- **Requirements:** ./requirements.md
+- **Platform:** [iOS/Android/Expo/Web]
+
+## Implementation Tasks
+
+### Phase A: Foundation
+
+- [ ] **A1: Set up core data models**
+  - Create [Model1], [Model2] data models
+  - Implement repository interfaces in Domain layer
+  - Set up dependency injection for feature
+  - _Requirements: 1.1, 1.2_
+
+- [ ] **A1.1: Write property test for [Property 1]**
+  - **Property 1: [Property Name]**
+  - **Validates: Requirements 1.1, 1.2, 1.3**
+
+- [ ] **A2: Implement data layer**
+  - Create local data source
+  - Create remote data source with API integration
+  - Implement repository with proper caching
+  - Add error handling and offline support
+  - _Requirements: 3.1, 3.2_
+
+### Phase B: Core UI
+
+- [ ] **B1: Create main feature view**
+  - Build [FeatureName]View with component hierarchy
+  - Implement [HeaderComponent] with navigation
+  - Apply design system tokens (colors, typography, spacing)
+  - Ensure responsive layout for all screen sizes
+  - _Requirements: 1.1, 5.3_
+
+- [ ] **B2: Implement primary content section**
+  - Build [ContentSection1] with sub-components
+  - Add loading states with skeleton views
+  - Implement empty states with helpful messaging
+  - Add pull-to-refresh functionality
+  - _Requirements: 1.3, 1.4_
+
+### Phase C: Interactions & Logic
+
+- [ ] **C1: Implement ViewModel/State management**
+  - Create [Feature]ViewModel with state handling
+  - Connect to repository layer
+  - Implement data loading and error states
+  - Add business logic validation
+  - _Requirements: 1.2, 2.1_
+
+- [ ] **C2: Build action components**
+  - Create [ActionButtons] with proper styling
+  - Implement touch feedback and animations
+  - Add haptic feedback for key actions
+  - Handle navigation flows
+  - _Requirements: 2.2, 2.3_
+
+### Phase D: Advanced Features
+
+- [ ] **D1: Implement security measures**
+  - Add input validation for all user inputs
+  - Implement secure data handling
+  - Add authentication checks where required
+  - Apply proper access control
+  - _Requirements: 4.1, 4.2, 4.3_
+
+- [ ] **D2: Add accessibility features**
+  - Implement VoiceOver/TalkBack labels
+  - Add keyboard navigation support
+  - Ensure proper color contrast
+  - Add Dynamic Type/Font scaling support
+  - _Requirements: 5.1, 5.2, 5.3_
+
+### Phase E: Polish & Optimization
+
+- [ ] **E1: Add animations and micro-interactions**
+  - Implement appear/disappear animations
+  - Add spring effects for interactive elements
+  - Create smooth transitions between states
+  - Ensure 60fps performance
+
+- [ ] **E2: Implement localization**
+  - Extract all user-facing strings
+  - Create localization keys
+  - Add default English translations
+  - Verify no hardcoded strings remain
+
+- [ ] **E3: Performance optimization**
+  - Implement lazy loading for lists
+  - Add proper caching
+  - Optimize memory usage
+  - Profile and fix performance issues
+
+### Phase F: Testing & Validation
+
+- [ ] **F1: Unit Tests**
+  - Write unit tests for ViewModel
+  - Write unit tests for Repository
+  - Write unit tests for Use Cases
+  - Ensure >80% code coverage
+
+- [ ] **F2: Integration Tests**
+  - Test data flow from API to UI
+  - Test offline functionality
+  - Test error recovery scenarios
+  - Validate all user flows work correctly
+
+- [ ] **F3: Final Checkpoint**
+  - Ensure all tests pass
+  - Verify all requirements are met
+  - Validate accessibility compliance
+  - Confirm security measures are working
+  - Test on multiple device sizes
+
+## Progress Tracking
+
+| Phase | Status | Completion |
+|-------|--------|------------|
+| A: Foundation | ⬜ Not Started | 0% |
+| B: Core UI | ⬜ Not Started | 0% |
+| C: Interactions | ⬜ Not Started | 0% |
+| D: Advanced | ⬜ Not Started | 0% |
+| E: Polish | ⬜ Not Started | 0% |
+| F: Testing | ⬜ Not Started | 0% |
+
+**Status Legend:** ⬜ Not Started | 🔄 In Progress | ✅ Complete | ⚠️ Blocked

package/templates/structures/android.txt

@@ -0,0 +1,10 @@
+app/
+├── src/main/
+│   ├── features/
+│   ├── shared/
+│   │   ├── ui/
+│   │   ├── services/
+│   │   ├── models/
+├── tests/
+├── docs/
+├── .project-identity

package/templates/structures/backend-nestjs.txt

@@ -0,0 +1,6 @@
+src/
+├── modules/
+├── shared/
+├── tests/
+├── docs/
+├── .project-identity

package/templates/structures/expo.txt

@@ -0,0 +1,9 @@
+app/
+├── (tabs)/
+├── features/
+├── components/
+├── services/
+├── hooks/
+├── constants/
+├── docs/
+├── .project-identity

package/templates/structures/ios.txt

@@ -0,0 +1,9 @@
+App/
+├── Features/
+├── Shared/
+│   ├── UI/
+│   ├── Services/
+│   ├── Models/
+├── Tests/
+├── docs/
+├── .project-identity

package/templates/structures/web-nextjs.txt

@@ -0,0 +1,6 @@
+app/
+├── components/
+├── lib/
+├── services/
+├── docs/
+├── .project-identity

package/templates/workflow_dual_mode_template.md

@@ -0,0 +1,87 @@
+---
+description: [Short description of the workflow]
+---
+
+# WORKFLOW: /[command] - Dual-Mode (v5.0)
+
+> **Mode A (Expert):** `/[command] [args] [flags]` -> Execute immediately.
+> **Mode B (Guided):** `/[command]` -> Interactive step-by-step wizard.
+
+---
+
+## 🅰️ Expert Mode (Direct Execution)
+
+**Flags:**
+- `--auto`: Auto-confirm all prompts.
+- `--fast`: Skip detailed improvements/reviews.
+- `--verbose`: Show detailed logs.
+
+**Usage:**
+```bash
+/[command] "Title" --auto
+```
+
+**Logic:**
+1. Parse arguments.
+2. If critical info missing -> Error.
+3. If valid -> Execute core logic silently.
+4. Report final result.
+
+---
+
+## 🅱️ Guided Mode (Interactive Wizard)
+
+### Phase 1: Context & Setup
+1. **Understand Intent:**
+   - "Bạn muốn làm gì với [Command]?"
+   - (AI analyzes context from `.project-identity` & `.beads`)
+
+2. **Configuration:**
+   - [Question 1]
+   - [Question 2]
+
+3. **Menu:**
+   ```markdown
+   1️⃣ Tiếp tục (Start Phase 2)
+   2️⃣ Thay đổi cấu hình
+   3️⃣ Hủy bỏ
+   ```
+
+### Phase 2: Execution & Analysis
+1. **Core Action:**
+   - performing_step_1...
+   - performing_step_2...
+
+2. **Progress Update:**
+   - "Đang thực hiện..."
+
+3. **Menu:**
+   ```markdown
+   1️⃣ Xem kết quả chi tiết
+   2️⃣ Tiếp tục sang Phase 3
+   3️⃣ Retry (Thử lại)
+   ```
+
+### Phase 3: Completion & Handoff
+1. **Final Report:**
+   - Summary of changes.
+   - Locations of artifacts.
+
+2. **Memory Sync:**
+   - Auto-sync with Beads (Task) & Brain (Knowledge).
+
+3. **Next Steps Menu:**
+   ```markdown
+   1️⃣ ✅ Hoàn tất & Lưu (`/done`)
+   2️⃣ 🚀 Tiếp tục task khác (`/next`)
+   3️⃣ 🔄 Chạy lại (`/redo`)
+   ```
+
+---
+
+## 🧠 Brain & Beads Integration
+
+- **Input:** Check `bd list --status in_progress` to resume context.
+- **Output:**
+  - Create/Update Beads task.
+  - Create Brain memory file if knowledge is valuable.