@relipa/ai-flow-kit 0.0.5 → 0.0.6-beta.0

package/docs/common/CHANGELOG.md

@@ -1,132 +1,162 @@
-# Changelog
-
-All notable changes to **@relipa/ai-flow-kit** will be documented in this file.
-
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
----
-
-## [0.0.4-beta.5] - 2026-04-21
-
-### Added
-- Created a dedicated `docs/` folder to house all developer-facing documentation.
-- Integrated AI Skill Registry into all tool templates (Claude, Cursor, Gemini, Copilot) for better skill discovery.
-
-### Changed
-- Moved `README.md`, `QUICK_START.md`, `AIFLOW.md`, `CHANGELOG.md`, and `IMPLEMENTATION_SUMMARY.md` into the `docs/` directory.
-- Updated `package.json` to exclude internal-only files (`CONTRIBUTING.md`, `plan.md`) from the NPM package distribution.
-- Updated `scripts/init.js` to source documentation from the new `docs/` location.
-- Updated all internal documentation links to reflect the new directory structure.
-
----
-
-## [0.0.5-beta.0] - 2026-04-23
-
-### Added
-- **`aiflow gate <n> <action>` command** — Called automatically by AI during gate transitions. Supports `start` and `approved` actions for gates 1-5. Options: `--ticket <id>`, `--ai-tool <tool>`.
-- **Telemetry gate logging** — Gate workflow templates now emit `aiflow gate N start/approved --ticket [id]` telemetry calls at each gate transition for usage metrics.
-- **`aiflow telemetry flush` command** — Force-sends buffered telemetry events immediately.
-
-### Changed
-- **`aiflow init` safe overwrite flow** — When a project already has `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, etc., `aiflow init` now prompts before overwriting:
-  - **No (default):** keeps existing file untouched; saves the aiflow template to `.aiflow/reference/<file>` for manual comparison/merge.
-  - **Yes:** backs up the existing file to `.aiflow/backup/<file>` before overwriting — nothing is permanently lost.
-- **`aiflow use --manual` pre-fill (Edit mode)** — Re-running `aiflow use --manual` when context already exists now pre-fills all fields (Ticket ID, Title, Description, Task type) with the current values; press Enter on any field to keep it unchanged.
-- **Fix TEAM_SECRET input** — Replaced `password()` prompt with `input()` using a masked hint `[Reli***!@#]`; pressing Enter retains the existing value.
-- **Fix Apps Script URL input** — Same pattern as TEAM_SECRET: masked hint `[https://script.google.com/macros/s/AKfy***xxxx/exec]`; pressing Enter retains the existing value.
-- **Downgrade dependencies for Node >=16 compatibility** — `@inquirer/prompts` downgraded from `^8.3.2` to `^3.0.0`; `commander` downgraded from `^14.0.3` to `^11.0.0`.
-- **`engines.node`** updated from `>=14.0.0` to `>=16.0.0`.
-
----
-
-## [0.0.5] - 2026-04-23
-
-### Added
-- **Telemetry System (MVP)**: Added anonymous usage tracking to measure command metrics and user adoption. 
-  - `aiflow telemetry enable/disable/status` commands to easily opt-in or opt-out.
-  - Automatically captures environment metadata and Git email via `git config --global user.email`.
-  - Secure payload signing natively using Node `crypto` HMAC-SHA256 to ensure data authenticity.
-  - Asynchronous payload flusher to ensure zero impact on command execution time (`< 5ms` overhead).
-- Support tracking for multiple AI platforms including Cursor and Gemini via Command Execution events and the new Telemetry SDK.
-
-### Security
-- **Strict Privacy**: Explicitly removed all prompt content and chat history tracking to ensure 100% confidentiality of company code and PII.
-
----
-
-## [Unreleased]
-
-## [0.0.3-beta.0] - 2026-04-13
-### Security
-- Removed internal GitLab repository links and tracking information.
-- Cleaned `.npmrc` configuration.
-- Added helper scripts for beta and stable releases.
-
-## [0.0.2] - 2026-04-13
-### Changed
-- Updated package to scoped name `@relipa/ai-flow-kit` in documentation and configuration.
-- Fixed installation guides in README and QUICK_START.
-
-## [0.0.1] - 2026-04-13 — Initial Release
-
-### Added
-
-#### CLI (`aiflow`)
-- `aiflow init` — scaffold AI workflow config into any project
-  (supports `--framework` spring-boot/reactjs, `--adapter` jira/backlog)
-- `aiflow use <skill>` — activate a custom skill in the current project
-- `aiflow remove` — cleanly remove `ai-flow-kit` scaffolding from a project
-- `aiflow guide` — interactive onboarding guide
-- `aiflow update` — sync upstream skill/hook updates
-- `aiflow doctor` — validate config, detect missing keys, report issues
-- `aiflow --version` — print installed version
-
-#### 5-Gate AI Workflow
-- **Gate 1 — AI Analyze Requirement**: Auto-starts when a ticket context exists
-  in `.aiflow/context/current.json`; outputs `plan/[ticket-id]/requirement.md`
-- **Gate 2 — Implementation Plan**: TDD plan generation, gated by `APPROVED`
-- **Gate 3 — Code Generation**: TDD-only, test-first discipline enforced
-- **Gate 4 — AI Self-Review**: Verification + impact analysis + checklist, gated by `APPROVED`
-- **Gate 5 — Peer Review & PR**: Guided PR creation via `requesting-code-review` skill
-
-#### Custom Skills (7 skills)
-- `read-study-requirement` — Gate 1 requirement analysis with clarifying Q&A loop
-- `generate-spec` — Gate 2 TDD implementation spec generator
-- `impact-analysis` — breaking-change and dependency impact assessment
-- `investigate-bug` — systematic bug investigation (reproduce → root cause → fix)
-- `report-customer` — customer-facing incident report generator
-- `review-plan` — Gate 4 self-review orchestrator
-- `figma-to-component` — Figma design → UI component code generator
-
-#### Multi-AI Support
-- **Claude Code** integration via `CLAUDE.md` + `.claude/` directory structure
-- **Gemini CLI** integration via `GEMINI.md`
-- **GitHub Copilot** integration via agents config
-- Superpowers skill library bundled as `upstream/` (pinned to v5.0.5)
-
-#### Project Templates
-- `AIFLOW.md` — team workflow reference document
-- `QUICK_START.md` — 5-minute setup guide
-- `.aiflowrc.json.example` — configuration file reference
-
-### Architecture Notes
-- Stateless per-ticket design — no persistent memory across sessions (planned: v0.1.x)
-- Manual skill sync model via `aiflow use` (managed `aiflow skill` CLI planned: v0.1.x)
-- Spring Boot (Java 17+) used as the reference framework in `CLAUDE.md` coding rules
-
----
-
-## How to upgrade
-
-```bash
-npm install -g @relipa/ai-flow-kit@latest
-aiflow --version
-```
-
-After upgrading, run `aiflow update` inside your project to sync the latest skills and hooks:
-
-```bash
-cd your-project
-aiflow update
-```
+# Changelog
+
+All notable changes to **@relipa/ai-flow-kit** will be documented in this file.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.0.6] - 2026-04-29
+
+### Added
+- **Global Fast Mode (Default)** — Optimize AI efficiency by prioritizing speed and minimizing token usage.
+  - Gate 1: Fast track scan with max 1 clarifying question.
+  - Gate 3: Disable subagents by default; implement all tasks in a single session.
+  - Gate 4: Quick scan impact analysis based on git diffs; simplified review checklist.
+- **Improved `--file` loader** — `aiflow use --file` now supports plain-text files (JSON no longer required).
+  - Auto-detects Ticket ID and Title from the text content.
+- **Gate-aware Injection** — Enhanced `session-start.js` hook to inject gate-appropriate "Fast Track" instructions during task resumption.
+- **Full Mode flag** — Added `--full` flag to bypass Fast mode optimizations for complex tasks.
+- **`aiflow task` command group** — Manage multiple tasks in the same repository without losing progress.
+  - `aiflow task status`, `list`, `pause`, `switch`, `resume`.
+- **RTK token compression integration** — `aiflow init` automatically configures the RTK hook for 60–90% token savings on shell commands.
+- **`aiflow use --fast` / `--full` flags** — Control Gate 1 analysis depth per ticket.
+- **Spring Boot code examples extracted** — Java code examples moved to separate files to reduce `CLAUDE.md` size.
+
+### Changed
+- **Default mode** for all new tasks is now `fast` instead of `auto`.
+- **`aiflow init` improvements** — Supports multi-select framework and protects existing instruction files from being overwritten.
+- **CLAUDE.md Optimization** — Reduced Spring Boot template size by ~70%, saving ~3-5k tokens per session.
+- **Documentation Synchronization** — Fixed all documentation links on npmjs.com and updated Overview Flow in README.
+- **Automatic Task Pausing** — When loading a new ticket, the current task is automatically paused and its state is saved.
+
+### Fixed
+- Broken 404 documentation links on the npmjs.com page.
+
+
+---
+
+## [0.0.4-beta.5] - 2026-04-21
+
+### Added
+- Created a dedicated `docs/` folder to house all developer-facing documentation.
+- Integrated AI Skill Registry into all tool templates (Claude, Cursor, Gemini, Copilot) for better skill discovery.
+
+### Changed
+- Moved `README.md`, `QUICK_START.md`, `AIFLOW.md`, `CHANGELOG.md`, and `IMPLEMENTATION_SUMMARY.md` into the `docs/` directory.
+- Updated `package.json` to exclude internal-only files (`CONTRIBUTING.md`, `plan.md`) from the NPM package distribution.
+- Updated `scripts/init.js` to source documentation from the new `docs/` location.
+- Updated all internal documentation links to reflect the new directory structure.
+
+---
+
+## [0.0.5-beta.0] - 2026-04-23
+
+### Added
+- **`aiflow gate <n> <action>` command** — Called automatically by AI during gate transitions. Supports `start` and `approved` actions for gates 1-5. Options: `--ticket <id>`, `--ai-tool <tool>`.
+- **Telemetry gate logging** — Gate workflow templates now emit `aiflow gate N start/approved --ticket [id]` telemetry calls at each gate transition for usage metrics.
+- **`aiflow telemetry flush` command** — Force-sends buffered telemetry events immediately.
+
+### Changed
+- **`aiflow init` safe overwrite flow** — When a project already has `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, etc., `aiflow init` now prompts before overwriting:
+  - **No (default):** keeps existing file untouched; saves the aiflow template to `.aiflow/reference/<file>` for manual comparison/merge.
+  - **Yes:** backs up the existing file to `.aiflow/backup/<file>` before overwriting — nothing is permanently lost.
+- **`aiflow use --manual` pre-fill (Edit mode)** — Re-running `aiflow use --manual` when context already exists now pre-fills all fields (Ticket ID, Title, Description, Task type) with the current values; press Enter on any field to keep it unchanged.
+- **Fix TEAM_SECRET input** — Replaced `password()` prompt with `input()` using a masked hint `[Reli***!@#]`; pressing Enter retains the existing value.
+- **Fix Apps Script URL input** — Same pattern as TEAM_SECRET: masked hint `[https://script.google.com/macros/s/AKfy***xxxx/exec]`; pressing Enter retains the existing value.
+- **Downgrade dependencies for Node >=16 compatibility** — `@inquirer/prompts` downgraded from `^8.3.2` to `^3.0.0`; `commander` downgraded from `^14.0.3` to `^11.0.0`.
+- **`engines.node`** updated from `>=14.0.0` to `>=16.0.0`.
+
+---
+
+## [0.0.5] - 2026-04-23
+
+### Added
+- **Telemetry System (MVP)**: Added anonymous usage tracking to measure command metrics and user adoption. 
+  - `aiflow telemetry enable/disable/status` commands to easily opt-in or opt-out.
+  - Automatically captures environment metadata and Git email via `git config --global user.email`.
+  - Secure payload signing natively using Node `crypto` HMAC-SHA256 to ensure data authenticity.
+  - Asynchronous payload flusher to ensure zero impact on command execution time (`< 5ms` overhead).
+- Support tracking for multiple AI platforms including Cursor and Gemini via Command Execution events and the new Telemetry SDK.
+
+### Security
+- **Strict Privacy**: Explicitly removed all prompt content and chat history tracking to ensure 100% confidentiality of company code and PII.
+
+---
+
+## [Unreleased]
+
+## [0.0.3-beta.0] - 2026-04-13
+### Security
+- Removed internal GitLab repository links and tracking information.
+- Cleaned `.npmrc` configuration.
+- Added helper scripts for beta and stable releases.
+
+## [0.0.2] - 2026-04-13
+### Changed
+- Updated package to scoped name `@relipa/ai-flow-kit` in documentation and configuration.
+- Fixed installation guides in README and QUICK_START.
+
+## [0.0.1] - 2026-04-13 — Initial Release
+
+### Added
+
+#### CLI (`aiflow`)
+- `aiflow init` — scaffold AI workflow config into any project
+  (supports `--framework` spring-boot/reactjs, `--adapter` jira/backlog)
+- `aiflow use <skill>` — activate a custom skill in the current project
+- `aiflow remove` — cleanly remove `ai-flow-kit` scaffolding from a project
+- `aiflow guide` — interactive onboarding guide
+- `aiflow update` — sync upstream skill/hook updates
+- `aiflow doctor` — validate config, detect missing keys, report issues
+- `aiflow --version` — print installed version
+
+#### 5-Gate AI Workflow
+- **Gate 1 — AI Analyze Requirement**: Auto-starts when a ticket context exists
+  in `.aiflow/context/current.json`; outputs `plan/[ticket-id]/requirement.md`
+- **Gate 2 — Implementation Plan**: TDD plan generation, gated by `APPROVED`
+- **Gate 3 — Code Generation**: TDD-only, test-first discipline enforced
+- **Gate 4 — AI Self-Review**: Verification + impact analysis + checklist, gated by `APPROVED`
+- **Gate 5 — Peer Review & PR**: Guided PR creation via `requesting-code-review` skill
+
+#### Custom Skills (7 skills)
+- `read-study-requirement` — Gate 1 requirement analysis with clarifying Q&A loop
+- `generate-spec` — Gate 2 TDD implementation spec generator
+- `impact-analysis` — breaking-change and dependency impact assessment
+- `investigate-bug` — systematic bug investigation (reproduce → root cause → fix)
+- `report-customer` — customer-facing incident report generator
+- `review-plan` — Gate 4 self-review orchestrator
+- `figma-to-component` — Figma design → UI component code generator
+
+#### Multi-AI Support
+- **Claude Code** integration via `CLAUDE.md` + `.claude/` directory structure
+- **Gemini CLI** integration via `GEMINI.md`
+- **GitHub Copilot** integration via agents config
+- Superpowers skill library bundled as `upstream/` (pinned to v5.0.5)
+
+#### Project Templates
+- `AIFLOW.md` — team workflow reference document
+- `QUICK_START.md` — 5-minute setup guide
+- `.aiflowrc.json.example` — configuration file reference
+
+### Architecture Notes
+- Stateless per-ticket design — no persistent memory across sessions (planned: v0.1.x)
+- Manual skill sync model via `aiflow use` (managed `aiflow skill` CLI planned: v0.1.x)
+- Spring Boot (Java 17+) used as the reference framework in `CLAUDE.md` coding rules
+
+---
+
+## How to upgrade
+
+```bash
+npm install -g @relipa/ai-flow-kit@latest
+aiflow --version
+```
+
+After upgrading, run `aiflow update` inside your project to sync the latest skills and hooks:
+
+```bash
+cd your-project
+aiflow update
+```

package/docs/common/QUICK_START.md

@@ -79,6 +79,9 @@ aiflow use PROJ-33 --comments-last 5
 
 # Manual input (no Backlog/Jira)
 aiflow use --manual
+
+# Load from local file (JSON or plain text)
+aiflow use --file task-description.txt
 ```
 
 Output:
@@ -109,6 +112,10 @@ claude                        # AI auto-starts Gate 1 immediately
 
 **What happens:** AI reads your ticket + source code + asks questions.
 
+> [!NOTE]
+> **Fast Mode** is now the default. AI aims for a quick scan and minimal Q&A to get you coding in < 5 mins.
+> Use `aiflow use TICKET --full` if you want the AI to perform a deep, exhaustive analysis (Gate 1 Full).
+
 When you open Claude, AI will **automatically** start analyzing:
 
 1. **Read ticket** from `.aiflow/context/current.json`
@@ -208,10 +215,23 @@ git push origin feature/PROJ-33-description
 
 Ask a teammate to review. They can use `superpowers:receiving-code-review` skill.
 
-### Step 8: Done!
-
 After peer reviewer approves → merge → task complete.
 
+### Step 9: Task Management (Context Switching)
+
+If you need to switch to another task mid-flow:
+
+```bash
+# Pause current task (saves gate progress)
+aiflow task pause --note "Waiting for PM clarification"
+
+# List all tasks
+aiflow task list
+
+# Resume a previously paused task
+aiflow task resume PROJ-33
+```
+
 ---
 
 ## Workflow Summary Diagram
@@ -297,18 +317,30 @@ claude                                # AI auto-starts: map dependencies → ass
 ```bash
 # Setup
 aiflow init --framework nestjs --adapter backlog
-aiflow init --framework spring-boot --env cursor   # optimize for Cursor
-aiflow doctor                         # health check
-aiflow guide                          # multi-tool guide
+aiflow init --framework spring-boot --with-rtk   # force enable RTK compression
+aiflow init --no-rtk                            # skip RTK setup
+aiflow doctor                                   # health check
+aiflow guide                                    # multi-tool guide
 
 # Per task
-aiflow use PROJ-33                    # load ticket context
-aiflow use PROJ-33 --with-comments    # load with comments
-aiflow use PROJ-33 --comments-last 5  # newest 5 comments
-aiflow use --manual                   # manual input
-aiflow prompt bug-fix                 # generate prompt
-aiflow prompt feature --output p.md   # save prompt to file
-aiflow prompt --list                  # list all prompt types
+aiflow use PROJ-33                              # load context (Fast Mode, default)
+aiflow use PROJ-33 --full                       # load context (Full Mode)
+aiflow use --file task.md                       # load from local text/json file
+aiflow use PROJ-33 --with-comments              # load with comments
+aiflow use PROJ-33 --comments-last 5            # newest 5 comments
+aiflow use --manual                             # manual input
+aiflow prompt bug-fix                           # generate prompt
+aiflow prompt feature --output p.md             # save prompt to file
+aiflow prompt --list                            # list all prompt types
+
+# Task management
+aiflow task status                              # show active and pending tasks
+aiflow task list                                # list all saved tasks
+aiflow task pause                               # pause current task
+aiflow task switch PROJ-99                      # switch to another task
+aiflow task resume PROJ-33                      # resume a paused task
+aiflow task reset  PROJ-33                      # reset to Gate 1 (keeps context)
+aiflow task remove PROJ-33                      # permanently delete all task data
 
 # Context management
 aiflow context show                   # view active context

package/docs/common/cli-reference.md

@@ -28,17 +28,23 @@ aiflow init --framework laravel --adapter jira
 ```
 
 **Options:**
-- `-f, --framework <type>` — Framework template (laravel, nextjs, vue-nuxt)
-- `-a, --adapter <type>` — MCP adapter (jira, backlog, google-sheets)
-- `-e, --env <types>` — AI tools to configure (cursor, gemini, copilot)
+- `-f, --framework <types>` — Framework templates, comma-separated (e.g. `spring-boot,reactjs`)
+- `-a, --adapter <types>` — MCP adapters (jira, backlog, google-sheets)
+- `-e, --env <types>` — AI tools to configure (cursor, gemini, copilot, generic). Default excludes `generic`.
+- `--with-rtk` — Force enable RTK token compression hook
+- `--no-rtk` — Skip RTK setup even if RTK is detected
 
 **What it does:**
 1. Creates `.claude/skills/` with all available skills
-2. Creates `.rules/` with team rules
+2. Creates `.rules/` with team rules (including `java/spring-boot-examples.md` for Spring Boot projects)
 3. Creates `.aiflow/` with version tracking
-4. Optionally sets up framework template (CLAUDE.md)
+4. Sets up framework instruction file (`CLAUDE.md`, `.cursorrules`, etc.):
+   - **File already exists** → saves aiflow template to `.aiflow/reference/<file>` for comparison. Your existing file is untouched — you own it.
+   - **File does not exist** → creates it in the project root.
 5. Optionally configures MCP adapter
 
+> **Note:** `CLAUDE.md` and other AI instruction files are project files — commit them to your repo. Run `aiflow init` once to generate them, then maintain them yourself. On subsequent `aiflow init` runs they will not be overwritten.
+
 **Example:**
 ```bash
 $ aiflow init --framework laravel --adapter jira
@@ -62,6 +68,12 @@ aiflow use JIRA-2024-123
 # Load from Backlog
 aiflow use BACKLOG-456
 
+# Fast mode — lite Gate 1 (< 5 min, no Q&A)
+aiflow use BACKLOG-456 --fast
+
+# Full mode — force complete analysis
+aiflow use BACKLOG-456 --full
+
 # Manual entry
 aiflow use --manual
 
@@ -80,11 +92,13 @@ aiflow use 1.0.0
 - `--with-comments` — Include all ticket comments
 - `--comments-last <n>` — Only fetch last N comments
 - `--comments-from <n>` — Fetch comments starting from comment N
+- `--fast` — Fast mode: AI skips Q&A, outputs lite 3-section requirement doc (< 5 min Gate 1). Best for clear tickets with ≥ 3 measurable AC.
+- `--full` — Full mode: force complete Gate 1 analysis with Q&A regardless of ticket clarity.
 
 **What it does:**
 1. Fetches context from MCP adapter (if applicable)
 2. Parses and validates context
-3. Saves to `.aiflow/context/current.json`
+3. Saves to `.aiflow/context/current.json` (including `mode` field for Gate 1 behaviour)
 4. Updates state tracking
 
 **Example:**
@@ -99,6 +113,101 @@ Fetching context from Jira...
 Ready to prompt! Run: aiflow prompt bug-fix
 ```
 
+## task
+
+Manage multiple tasks — pause, switch, and resume while preserving gate progress.
+
+```bash
+# Show active task + pending list
+aiflow task status
+
+# List all saved tasks
+aiflow task list
+
+# Pause current task (saves context + gate progress)
+aiflow task pause
+aiflow task pause --note "waiting for API spec from PM"
+
+# Pause current + switch to another task
+aiflow task switch PROJ-99
+
+# Resume a paused task
+aiflow task resume PROJ-33
+
+# Reset task to Gate 1 (keeps ticket context, clears gate progress)
+aiflow task reset PROJ-33
+
+# Permanently delete all saved data for a task
+aiflow task remove PROJ-33
+```
+
+**Sub-commands:**
+- `status` — Show active task and all pending tasks
+- `list` — List all saved tasks with gate state
+- `pause [--note <text>]` — Save current progress and clear active task
+- `switch <ticket-id>` — Pause current task + load/switch to another
+- `resume <ticket-id>` — Restore a paused task as active
+- `reset <ticket-id>` — Reset gate progress to Gate 1 (keeps ticket context); prompts to optionally delete `plan/<id>/` files
+- `remove <ticket-id>` — Permanently delete all saved data for the task (state, context snapshot, plan files)
+
+**What it does:**
+1. Saves a snapshot of the current context (`current.json`) to `.aiflow/tasks/<taskId>/context.json`
+2. Detects current gate from `plan/` artifacts (`requirement.md`, `plan.md`, `summary.md`)
+3. Writes `.aiflow/tasks/<taskId>/task-state.json` with status, gate, and approvals
+4. On resume: restores context as `current.json` and sets status back to `active`
+5. The **SessionStart hook** reads `task-state.json` on next `claude` launch and injects gate-aware instructions — Claude resumes from the correct gate instead of restarting Gate 1
+
+**Gate detection from `plan/` files:**
+| File present | Inferred gate |
+|---|---|
+| (none) | Gate 1 |
+| `plan/<id>/requirement.md` | Gate 2 |
+| `plan/<id>/plan.md` | Gate 3 |
+| `plan/<id>/summary.md` | Gate 5 |
+
+**Example workflow:**
+```bash
+# Mid-task on PROJ-33 (Gate 2 in progress)...
+aiflow task pause --note "waiting for DB schema confirmation"
+# ✓ Task PROJ-33 paused at Gate 2.
+
+aiflow use PROJ-99        # load urgent task
+claude                    # AI auto-starts Gate 1 for PROJ-99
+
+# Back to PROJ-33
+aiflow task resume PROJ-33
+# ✓ Resumed task: PROJ-33
+#   Gate:  2 (Implementation Plan)
+
+claude                    # AI resumes from Gate 2 — no restart
+```
+
+**Reset workflow** — run a task from scratch after deleting generated code:
+```bash
+aiflow task reset PROJ-33
+# Reset task: PROJ-33
+#   • .aiflow/tasks/PROJ-33/task-state.json  (Gate 3 → 1, approvals cleared)
+# ? Also delete 2 plan file(s) in plan/PROJ-33/? › No
+# ? Proceed with reset? › Yes
+# ✓ Task PROJ-33 reset to Gate 1.
+
+claude   # AI auto-starts Gate 1 as if the task is brand new
+```
+
+**Remove workflow** — permanently clean up a cancelled task:
+```bash
+aiflow task remove PROJ-33
+# Remove task: PROJ-33
+#   • .aiflow/tasks/PROJ-33/  (context snapshot + gate state)
+#   • .aiflow/context/current.json  (this is the active task)
+#   • plan/PROJ-33/  (2 files):
+#       - plan/PROJ-33/requirement.md
+#       - plan/PROJ-33/plan.md
+# ? This cannot be undone. Proceed? › No
+```
+
+---
+
 ## prompt
 
 Generate an AI prompt with context, rules, and template.

package/docs/common/getting-started.md

@@ -99,6 +99,9 @@ This pulls:
 - Acceptance criteria
 - Related files/links
 
+> [!TIP]
+> **Fast Mode** is now the default. AI Flow Kit will prioritize speed and minimal Q&A so you can start coding in < 5 mins. Use `--full` if you need deep analysis.
+
 **2. Generate a prompt:**
 ```bash
 aiflow prompt bug-fix

package/docs/project/ARCHITECTURE.md

@@ -1,28 +1,28 @@
-# Architecture Overview
-
-> **Template file** — Replace this with your project's actual architecture.
-
-## System Architecture
-
-```
-[Describe your system layers here]
-```
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|-----------|
-| Backend | |
-| Frontend | |
-| Database | |
-| Infrastructure | |
-
-## Key Components
-
-- 
-
-## Data Flow
-
-```
-[Describe main data flows]
-```
+# Architecture Overview
+
+> **Template file** — Replace this with your project's actual architecture.
+
+## System Architecture
+
+```
+[Describe your system layers here]
+```
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Backend | |
+| Frontend | |
+| Database | |
+| Infrastructure | |
+
+## Key Components
+
+- 
+
+## Data Flow
+
+```
+[Describe main data flows]
+```

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.0.5",
+  "version": "0.0.6-beta.0",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Relipa AI Team",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.relipa.vn/ai/ai-flow-kit.git"
+  },
+  "homepage": "https://gitlab.relipa.vn/ai/ai-flow-kit#readme",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.com/"