@relipa/ai-flow-kit 0.0.4-beta.0 → 0.0.4-beta.2

package/QUICK_START.md

@@ -7,8 +7,17 @@
 ## Installation
 
 ```bash
+# Stable version
 npm install -g @relipa/ai-flow-kit
+
+# Beta version (recommend for newest features)
+npm install -g @relipa/ai-flow-kit@beta
+
+# Verification
 aiflow --version
+
+# Uninstall
+npm uninstall -g @relipa/ai-flow-kit
 ```
 
 ---
@@ -323,8 +332,9 @@ aiflow guide --commands               # command reference
 
 # Maintenance
 aiflow remove                         # remove from project
-aiflow remove --global                # uninstall globally
-aiflow remove --version 1.0.0         # remove cached version
+aiflow remove --global                # uninstall globally (npm uninstall -g)
+aiflow remove --version 1.0.0         # remove cached version from .aiflow/
+npm uninstall -g @relipa/ai-flow-kit  # standard npm uninstall
 ```
 
 ---

package/README.md

@@ -18,6 +18,18 @@ Developers only need a single command to load ticket context → AI automaticall
 | Missing impact analysis flow | Skill `impact-analysis` |
 | Hard to resume tasks | **State Resumption**: Unified `plan/` docs and context across tools |
 
+## Documentation & Guides
+
+> [!TIP]
+> After running `aiflow init`, all documentation files are automatically copied to your project root and `.aiflow/docs/` for easy access.
+
+- **[Quick Start Guide](./QUICK_START.md)** — Step-by-step instructions for developers.
+- **[Full Workflow (5 Gates)](./AIFLOW.md)** — In-depth look at the Gate process.
+- **[Developer Onboarding](./docs/developer-overview.md)** — Presentation-ready guide for new team members.
+- **[Contributing Guide](./CONTRIBUTING.md)** — How to extend with new skills/templates.
+- **[Troubleshooting](./docs/troubleshooting.md)** — Common issues and fixes.
+- **[Integration Guide](./docs/ai-integration.md)** — Advanced tool setup (Claude, Cursor, Gemini).
+
 ---
 
 ## Overview Flow
@@ -92,7 +104,14 @@ Developers only need a single command to load ticket context → AI automaticall
 ## Installation
 
 ```bash
+# Stable version
 npm install -g @relipa/ai-flow-kit
+
+# Beta version (recommend for newest features)
+npm install -g @relipa/ai-flow-kit@beta
+
+# Uninstall
+npm uninstall -g @relipa/ai-flow-kit
 ```
 
 ---

package/bin/aiflow.js

@@ -25,6 +25,7 @@ program
     .description('Initialize AI Flow Kit in your project')
     .option('-f, --framework <types>', 'framework(s), comma-separated (e.g. spring-boot,reactjs)')
     .option('-a, --adapter <types>', 'adapter(s), comma-separated (e.g. backlog,jira)')
+    .option('-e, --env <types>', 'AI environment(s)/tool(s), comma-separated (e.g. cursor,gemini,copilot)')
     .action((options) => {
         options.frameworks = options.framework
             ? options.framework.split(',').map(s => s.trim()).filter(Boolean)
@@ -32,6 +33,10 @@ program
         options.adapters = options.adapter
             ? options.adapter.split(',').map(s => s.trim()).filter(Boolean)
             : [];
+        options.aiTools = options.env
+            ? options.env.split(',').map(s => s.trim()).filter(Boolean)
+            : Object.keys(require('../scripts/init').AI_TOOL_FILES || {});
+
         initCommand(options);
     });
 

package/custom/templates/shared/gate-workflow.md

@@ -23,6 +23,9 @@ AI actively reads ticket + source code to understand the requirement:
    - Impact analysis, effort estimate, testing plan
 5. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
 
+> [!TIP]
+> If auto-start doesn't trigger, the developer can start this gate by typing: **"start"**, **"Gate 1"** or **"Analyze ticket"**.
+
 DO NOT just check format — **understand the content and propose solutions**.
 
 ---

package/custom/templates/tools/copilot.md

@@ -4,3 +4,5 @@ You are an expert AI assistant specialized in this project's stack. Follow the G
 
 > [!IMPORTANT]
 > Always check for context in `.claude/context/current.json` and progress in the `plan/` folder before suggesting changes.
+
+If the Gate Workflow hasn't started, wait for the developer to type **"start"** or **"Gate 1"**.

package/custom/templates/tools/cursor.md

@@ -4,3 +4,5 @@ You are an expert AI assistant specialized in this project's stack. Follow the G
 
 > [!IMPORTANT]
 > Always check `.claude/context/current.json` and the `plan/` directory before starting any task to understand current context and progress.
+
+If Gate 1 doesn't auto-start, wait for the developer to type **"start"**, **"Gate 1"** or **"Analyze ticket"**.

package/custom/templates/tools/gemini.md

@@ -4,3 +4,5 @@ You are an expert AI assistant specialized in this project's stack. Follow the G
 
 > [!IMPORTANT]
 > When starting a session, always read `.claude/context/current.json` to load ticket context and check the `plan/` directory for existing progress.
+
+If no instructions are automatically followed, wait for the developer to type **"start"** or **"Gate 1"** to start the analysis.

package/custom/templates/tools/generic.md

@@ -8,3 +8,5 @@ You are an expert AI assistant. Follow the project's Gate Workflow and Team Rule
 - **Rules**: `.rules/`
 
 Follow the gated workflow and rules defined below.
+
+If Gate 1 does not start automatically, please start it when the developer types **"Gate 1"**.

package/docs/developer-overview.md

@@ -28,13 +28,17 @@ Before starting, ensure you have:
 Run this command to install the CLI tool globally:
 
 ```bash
+# Stable version
 npm install -g @relipa/ai-flow-kit
-```
 
-Verify installation:
-```bash
+# Beta version (recommend for newest features)
+npm install -g @relipa/ai-flow-kit@beta
+
+# Verification
 aiflow --version
-```
+
+# Uninstall
+npm uninstall -g @relipa/ai-flow-kit
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.0.4-beta.0",
+  "version": "0.0.4-beta.2",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Relipa AI Team",
   "publishConfig": {

package/scripts/hooks/session-start.js

@@ -134,7 +134,8 @@ function buildContextPrompt(ctx) {
     lines.push('6. Display GATE 1 prompt and wait for APPROVED');
     lines.push('');
     lines.push('DO NOT wait for the developer to ask. START NOW.');
+    lines.push('If you have not started automatically, begin as soon as the developer types **"start"**.');
     lines.push('</ACTIVE_TASK>');
 
     return lines.join('\n');
-}
+}