🌌 Journey: Unified Mastery Engine

Bridge the gap between your current baseline and the 2030 Engineering Frontier.

Journey is a high-fidelity, AI-orchestrated mastery engine. It is not a task manager; it is a Syllabus for Autonomous Transition. It unifies technical mastery (Distributed Systems, ZK-ML, Rust) with biological optimization (Nutrition, Physical Frame) into a single, cohesive progression tree.

(Placeholder for your actual preview image)

✨ Why Journey?

• Universal Goal Architecture: 16+ pre-configured layers covering the absolute metal of systems engineering to the peak of human performance.
• Liquid Glass UI: A calm, usability-first aesthetic built with Next.js 19, GSAP kinetic physics, and aurora-shift backgrounds.
• AI-Native (MCP): Built-in Model Context Protocol (MCP) server allows AI agents (Claude, Gemini, ChatGPT) to autonomously read your progress and update your roadmap as you build.
• Progress Spotlight: Smart recommendation engine that points you to your next logical "Boss Level" milestone.
• Zero-Loss Persistence: Your data lives in ~/.journey, keeping your progress safe across package updates and re-installs.

🚀 One-Command Installation

The fastest way to install Journey and link the global CLI commands:

git clone https://github.com/ziuus/journey.git && cd journey && ./install.sh

Or via NPM:

npm install -g @ziuus/journey

🛠 Command Center

Once installed, use these global commands from anywhere:

• start-roadmap: Launches the high-fidelity portal on http://localhost:6060.
• journey-mcp: Connects your roadmap to AI agents for autonomous management.

🧠 AI Agent Integration

Tell your AI Agent (using the Computer Use or MCP extensions) to read the skill instructions:

agent-skills/journey/SKILL.md

Your agent can then help you:

"Hey, I just finished the Rust Raft implementation. Mark it as done and show me the next milestone."

📂 Project Structure

• src/app: The cinematic Next.js 19 dashboard.
• mcp/: The Journey MCP Engine for cross-agent interaction.
• data/: Local templates for roadmaps and history.
• ~/.journey/data/: Your permanent, personal roadmap storage.

Built for those who want to work like it is 2030 while interviewing like it is 2013.