atris 1.8.2 → 1.8.4

package/GETTING_STARTED.md

@@ -1,6 +1,6 @@
-# Getting Started with ATRIS
+# Getting Started with atrisDev
 
-Welcome! ATRIS transforms your system (codebase, product, sales process, etc.) into an AI-navigable workspace in under 10 minutes.
+Welcome! atrisDev gives you a high-quality AI development workflow that works with any coding agent.
 
 ## What Just Happened?
 
@@ -9,44 +9,46 @@ You ran `atris init` and got this folder structure:
 ```
 atris/
 ├── GETTING_STARTED.md (you are here!)
-├── PERSONA.md (agent communication style)
-├── atris.md (instructions for your AI agent)
-├── MAP.md (AI generates from your codebase)
-├── TASK_CONTEXTS.md (AI generates from MAP)
-└── agent_team/
-    ├── navigator.md (pre-built template, ready to use)
-    ├── executor.md (pre-built template, ready to use)
-    └── validator.md (pre-built template, ready to use)
+├── atris.md (atrisDev protocol + specs)
+├── CLAUDE.md (tells agents to follow atrisDev)
+├── MAP.md (navigation - AI will generate)
+└── agent_team/ (agent specs)
 ```
 
-## Quick Start (3 Steps)
+## Quick Start (2 Steps)
 
-### Step 1: Open atris.md
-Open `atris/atris.md` in your editor. This file contains detailed instructions for your AI agent.
+### Step 1: Run atris
 
-### Step 2: Paste to Your AI Agent
-Copy the entire contents of `atris.md` and paste it to Claude Code, Cursor, Windsurf, or your favorite AI coding assistant with this prompt:
+```bash
+atris
+```
+
+This loads your workspace context and activates the atrisDev protocol.
+
+### Step 2: Describe what you want
+
+In your coding agent (Claude Code, Cursor, Windsurf, etc.), just describe what you want to build:
 
 ```
-Read atris.md. Generate MAP.md and TASK_CONTEXTS.md for this project.
+"I want to add dark mode to the settings page"
+"Build a CSV export feature for the dashboard"
+"Refactor the auth system to use OAuth"
 ```
 
-### Step 3: Watch the Magic
-Your AI agent will:
-- Scan your project and generate `MAP.md` (a navigation guide with file:line references)
-- Generate `TASK_CONTEXTS.md` with actionable tasks extracted from your system
-- Optionally inject project-specific context into the pre-built agent templates
+The agent will automatically:
+1. Show you an **atris visualization** (diagram of the plan)
+2. Wait for your approval
+3. Create `docs/features/[name]/idea.md` + `build.md`
+4. Execute step by step
+5. Review and update docs
 
-**Agent templates ship ready to use:**
-- **navigator.md** - Answers "where is X?" questions
-- **executor.md** - Executes tasks with full context
-- **validator.md** - Validates changes and updates docs
+**Total time: Start building immediately**
 
-**Total time: ~5 minutes**
+## The atrisDev Protocol
 
-## Load the context (no login required)
+When agents see `atris/CLAUDE.md`, they automatically follow the atrisDev workflow. No manual setup needed.
 
-At any point—before or after your AI agent runs—you can load the local context with:
+You can also run:
 
 ```bash
 atris activate

package/README.md

@@ -1,25 +1,34 @@
 # atrisDev
 
-A new way to build and manage agents.
+High-quality AI development workflow. Works with any coding agent.
 
 ## Install
 
 ```bash
-npm install -g atrisdev
+npm install -g atris
 ```
 
-## Usage
+## Quick Start
 
 ```bash
 cd your-project
-atris init
+atris init    # Creates atris/ folder
+atris         # Loads context, ready to build
 ```
 
-See `atris/GETTING_STARTED.md` for full instructions.
+Then describe what you want to build. The agent will:
+1. Show you a visualization
+2. Wait for approval
+3. Create `docs/features/[name]/idea.md` + `build.md`
+4. Execute step by step
+5. Review and update docs
+
+Works with: Claude Code, Cursor, Windsurf, GitHub Copilot, any agent.
 
 ## Update
 
 ```bash
+npm update -g atris
 atris update
 ```
 

package/atris/agent_team/navigator.md

@@ -1,4 +1,4 @@
-# navigator.md — Planner (The Crosshair)
+# navigator.md — Planner
 
 > **Role:** Transform messy human intent into precise execution plans | **Source:** idea.md, MAP.md
 
@@ -9,7 +9,7 @@
 When the human gives you an idea (messy, conversational, exploratory):
 
 1. **Extract intent** — What are they trying to build? Why?
-2. **Generate ASCII crosshair** — Show them exactly what will happen (frontend boxes / backend flow / database tables)
+2. **Generate atris visualization** — Show them exactly what will happen (frontend boxes / backend flow / database tables)
 3. **Confirm** — "Is THIS what you meant?" (y/n)
 4. **Create idea.md** — Save their messy intent to `docs/features/[name]/idea.md`
 5. **Generate build.md** — Create technical spec in `docs/features/[name]/build.md`
@@ -18,7 +18,7 @@ When the human gives you an idea (messy, conversational, exploratory):
 
 ---
 
-## ASCII Crosshair Patterns
+## atris Visualization Patterns
 
 Use these for 99% of dev work:
 
@@ -51,7 +51,7 @@ Files: route.ts:45, middleware.ts (new)
 Migration: add column
 ```
 
-**Show the crosshair. Get confirmation. Build the spec.**
+**Show the visualization. Get confirmation. Build the spec.**
 
 ---
 
@@ -95,7 +95,7 @@ tests:
 
 1. **Check docs/features/README.md first** — See what features exist, avoid duplication
 2. **Check MAP.md** — Find exact file:line references for code
-3. **ASCII before build.md** — Human confirms visual before technical spec
+3. **Visualization before build.md** — Human confirms visual before technical spec
 4. **Be precise** — Exact files, exact lines, exact changes
 5. **Covers 3 types** — Frontend (boxes), Backend (flows), Database (tables)
 6. **Free-flow works** — Even exploratory conversations go through this flow
@@ -104,8 +104,8 @@ tests:
 - Read docs/features/README.md
 - Search keywords for similar features
 - If exists: extend it, don't duplicate
-- Show ASCII: "Builds on X, new file Y"
+- Show visualization: "Builds on X, new file Y"
 
 ---
 
-**Navigator = The Crosshair. Precision before execution.**
+**Navigator = Precision before execution.**

package/atris/atris.md

@@ -466,6 +466,124 @@ Enhanced sync logic with auto-pull and conflict resolution.
 
 ---
 
+## Phase 5.2: atrisDev Protocol (Universal Workflow)
+
+**The atrisDev Protocol** is a universal workflow that any coding agent can follow to produce high-quality output. When agents follow this protocol, they build features systematically with human approval gates and proper documentation.
+
+**This protocol works with ANY agent:** Claude Code, Cursor, Windsurf, GitHub Copilot, or any LLM-based coding assistant.
+
+---
+
+### How to Use atrisDev
+
+**Step 1: Load Context**
+
+Run `atris` in your terminal. It outputs a prompt containing:
+- Active work in progress
+- Inbox ideas waiting to be built
+- Recent completions
+- The atrisDev workflow steps
+
+**Step 2: Copy the Prompt**
+
+Copy the entire output and paste it to your coding agent along with your task description.
+
+**Step 3: Agent Follows the Protocol**
+
+The agent executes this workflow:
+
+---
+
+### atrisDev Workflow Steps
+
+**1. Show atris Visualization**
+
+Before writing any code, the agent creates a visual diagram showing:
+- Architecture/data flow
+- Key components and their interactions
+- Database schema (if applicable)
+- User experience flow (if applicable)
+
+**Example:**
+```
+┌─────────────┐
+│   Browser   │
+└──────┬──────┘
+       │ POST /api/features
+       ▼
+┌─────────────────┐      ┌──────────────┐
+│  API Handler    │─────▶│  Database    │
+│  - Validate     │      │  - features  │
+│  - Transform    │◀─────│  - users     │
+└─────────────────┘      └──────────────┘
+       │
+       ▼
+┌─────────────────┐
+│  Response JSON  │
+└─────────────────┘
+```
+
+**2. Wait for Approval**
+
+Agent **MUST NOT** proceed until the human confirms the plan is correct.
+
+**3. Create idea.md**
+
+Path: `docs/features/[feature-name]/idea.md`
+
+Contents:
+- **Problem Statement** — What are we solving?
+- **Solution Design** — How will we solve it?
+- **ASCII Diagrams** — Visual representation
+- **Success Criteria** — How do we know it works?
+
+**4. Create build.md**
+
+Path: `docs/features/[feature-name]/build.md`
+
+Contents:
+- **Step-by-step Implementation Plan** — Ordered list of tasks
+- **Files to Change** — Exact file paths and what changes
+- **Testing Strategy** — How to verify each step
+
+**5. Execute Step by Step**
+
+- Build one step at a time
+- After each step, check alignment with the plan
+- If something doesn't match, stop and adjust
+- Never batch multiple steps without validation
+
+**6. Review & Validate**
+
+- Run all tests
+- Verify success criteria from idea.md
+- Update `docs/features/README.md` with new feature entry
+- Add completion to journal: `## Completed ✅`
+
+---
+
+### Why This Works
+
+**Benefits of atrisDev Protocol:**
+- **Approval gates prevent wasted work** — Human confirms plan before execution
+- **Documentation is automatic** — idea.md and build.md created as byproducts
+- **Visual thinking reduces miscommunication** — ASCII diagrams force clarity
+- **Step-by-step execution prevents sprawl** — Each step validated before next
+- **Works with any agent** — Protocol is agent-agnostic
+- **Spreads naturally** — Once installed, `atris` becomes the entry point for all dev work
+
+**Adoption path:**
+1. Dev installs `atris`: `npm install -g atris`
+2. Initializes project: `atris init`
+3. Runs `atris` to get the protocol prompt
+4. Copies prompt to their preferred agent
+5. Agent follows atrisDev workflow → high-quality output
+6. Dev shares results → others adopt atris
+
+**The vision:** Every developer running `atris` gets a structured, high-quality workflow regardless of which coding agent they use. The protocol becomes the standard.
+
+---
+
 ## Phase 6: Future Roadmap (Vision)
 
 **See [`ATRIS_NOTES.md`](./ATRIS_NOTES.md) for full roadmap. Preview:**

package/atris.md

@@ -496,9 +496,9 @@ The agent executes this workflow:
 
 ### atrisDev Workflow Steps
 
-**1. Show the Crosshair (ASCII Visualization)**
+**1. Show atris Visualization**
 
-Before writing any code, the agent creates an ASCII diagram showing:
+Before writing any code, the agent creates a visual diagram showing:
 - Architecture/data flow
 - Key components and their interactions
 - Database schema (if applicable)

package/bin/atris.js

@@ -91,28 +91,43 @@ function shouldRefreshToken(token, bufferSeconds = TOKEN_REFRESH_BUFFER_SECONDS)
 }
 
 function showHelp() {
-  console.log('Usage: atris <command>');
   console.log('');
-  console.log('Commands:');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('atrisDev — The new way to build with AI');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+  console.log('Quick Start:');
+  console.log('');
+  console.log('  1. atris                  Load context, start building');
+  console.log('  2. Describe what you want (in your editor or terminal)');
+  console.log('  3. Agent shows visualization, you approve, it builds');
+  console.log('');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+  console.log('Setup:');
   console.log('  init       - Initialize ATRIS in current project');
-  console.log('  log        - View or append to today\'s log');
-  console.log('  status     - Show system state (inbox, backlog, completions)');
-  console.log('  analytics  - Show insights from journal (velocity, trends, patterns)');
+  console.log('  update     - Update local files to latest version');
   console.log('');
-  console.log('  visualize  - Break down ideas with ASCII visualization');
-  console.log('  plan       - Create idea.md for a new feature');
-  console.log('  do         - Generate build.md and execute feature');
-  console.log('  review     - Validate execution and update docs');
+  console.log('Daily workflow:');
+  console.log('  atris      - Load context and start (recommended)');
+  console.log('  log        - Add ideas to inbox');
+  console.log('  status     - See active work and completions');
+  console.log('  analytics  - View productivity insights');
   console.log('');
-  console.log('  agent      - Select agent for this workspace');
-  console.log('  chat       - Interactive chat with ATRIS agents');
-  console.log('  login      - Authenticate with Atris cloud (optional)');
-  console.log('  logout     - Remove stored credentials');
-  console.log('  whoami     - Show current authentication status');
+  console.log('Legacy commands (still work, but "atris" is easier):');
+  console.log('  plan       - Manual planning mode');
+  console.log('  do         - Execute tasks');
+  console.log('  review     - Validate work');
   console.log('');
-  console.log('  update     - Update local files from package to latest version');
+  console.log('Other:');
+  console.log('  login      - Authenticate with Atris cloud (optional)');
+  console.log('  logout     - Remove credentials');
+  console.log('  whoami     - Show auth status');
   console.log('  version    - Show ATRIS version');
-  console.log('  help       - Show this help message');
+  console.log('  help       - Show this help');
+  console.log('');
+  console.log('💡 Tip: Just run "atris" to get started');
+  console.log('');
 }
 
 // Smart default: if no command, load context and enter brainstorm/planning mode
@@ -3221,7 +3236,7 @@ async function atrisDevEntry() {
   console.log('─────────────────────────────────────────────────────────────');
   console.log('');
   console.log('The atrisDev workflow will automatically:');
-  console.log('  1. Show ASCII visualization (the crosshair)');
+  console.log('  1. Show atris visualization');
   console.log('  2. Wait for your approval');
   console.log('  3. Create docs/features/[name]/idea.md + build.md');
   console.log('  4. Execute step by step');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "atrisDev - A new way to build and manage agents",
   "main": "bin/atris.js",
   "bin": {