feat(ui): refresh onboarding with refined ProductOS UX

.gitignore

@@ -36,7 +36,7 @@ test-artifacts/
 
 # Ignore local Skills
 .agents/skills/*
-.claude/skills/*
+.claude/
 skills-lock.json
 
 # Encrypted secrets file

docs/README.md

@@ -5,25 +5,32 @@
 Welcome to the productOS user documentation! This guide will help you get started and make the most of your AI-powered research workspace.
 
 ## 📚 Documentation Guide
+
 ### Getting Started
+
 1. **[Why productOS?](01-why-productOS.md)** - Understand the problems productOS solves and how it can save you hours of work
 2. **[Main Components](02-main-components.md)** - Overview of projects, skills, workflows, and other key features
 3. **[Installation Guide](03-installation.md)** - Step-by-step instructions to install and configure productOS
 
 ### Core Features
+
 4. **[Projects Guide](04-projects-guide.md)** - Create and manage research projects, organize files, and use AI Chat
 5. **[Skills Guide](05-skills-guide.md)** - Create reusable AI agent templates with custom environment variables for specialized tasks
 6. **[Workflows Guide](06-workflows-guide.md)** - Automate complex multi-step processes with visual workflow builder
 7. **[Artifacts Guide](10-artifacts-guide.md)** - Understand persistent AI outputs and structured documentation
 8. **Project Log Timeline** - Full audit trail of AI research steps, interactions, and results
 
 ### Configuration & Advanced
+
 9. **[Settings Guide](07-settings-guide.md)** - Configure AI providers, manage API keys, and customize your experience
 10. **[Usage & Cost Tracking](09-usage-cost-tracking.md)** - Optimize your AI spending with Token Saver and usage monitoring
 11. **[Integrations Guide](12-integrations-guide.md)** - Connect productOS to external services like Telegram and WhatsApp
 12. **[Data Portability Guide](08-data-portability.md)** - Migrate data, share with your team, and understand file structure
+13. **[UX Flow Map & Ambiguity Audit](ux-flow-map.md)** - Source-based map of current UI/UX flows, ambiguity hotspots, and redesign priorities
+14. **[UX Change Map](ux-change-map.md)** - Proposed flow changes, implementation surfaces, priorities, and staged redesign sequence
 
 ### Real-World Examples
+
 - **[Cookbook: Practical Use Cases & Demo Playbook](11-cookbook-use-cases.md)** - End-to-end recipes with example prompts, outputs, and leverage model
 - **[Demo Pack](demo-pack/README.md)** - Ready-to-run PM demo scenarios, workflow JSON, simulation outputs, and Remotion caption assets
 - **[Use Case 1: Simple Research](use-cases/Use-Case1-Simple_research.md)** - Save 2-3 hours on feature research and documentation
@@ -33,6 +40,7 @@ Welcome to the productOS user documentation! This guide will help you get starte
 ## 🚀 Quick Start
 
 **New to productOS?** Follow this path:
+
 1. Read [Why productOS?](01-why-productOS.md) (2 minutes)
 2. Follow the [Installation Guide](03-installation.md) (10 minutes)
 3. Create your first project with the [Projects Guide](04-projects-guide.md) (5 minutes)
@@ -58,15 +66,16 @@ The Project Log provides a comprehensive, chronological audit trail of all AI re
 
 - **Access It**: Click the **"Project log"** button in the top toolbar while in a project.
 - **Capabilities**:
-    - **Timeline View**: See every command and response in order.
-    - **Filter & Search**: Quickly find specific interactions or outputs.
-    - **Details**: Expand entries to see complete multi-step logs.
-    - **Export**: Save the entire research history as a portable Markdown file.
-    - **Clear Log**: Reset the timeline to start a fresh research session.
+  - **Timeline View**: See every command and response in order.
+  - **Filter & Search**: Quickly find specific interactions or outputs.
+  - **Details**: Expand entries to see complete multi-step logs.
+  - **Export**: Save the entire research history as a portable Markdown file.
+  - **Clear Log**: Reset the timeline to start a fresh research session.
 
 ## 🔒 Security & Privacy
 
 Your data is yours. productOS stores everything locally as Markdown files with:
+
 - **Encrypted API keys** using AES-256-GCM encryption
 - **No external databases** - you control where your data lives
 - **Password protection** - your password unlocks encrypted secrets on each launch