atris 1.4.2 → 1.4.4

package/GETTING_STARTED.md

@@ -9,13 +9,14 @@ 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 (placeholder - will be populated)
-├── TASK_CONTEXTS.md (placeholder - will be populated)
+├── MAP.md (AI generates from your codebase)
+├── TASK_CONTEXTS.md (AI generates from MAP)
 └── agent_team/
-    ├── navigator.md (placeholder - will be populated)
-    ├── executor.md (placeholder - will be populated)
-    └── validator.md (placeholder - will be populated)
+    ├── navigator.md (pre-built template, ready to use)
+    ├── executor.md (pre-built template, ready to use)
+    └── validator.md (pre-built template, ready to use)
 ```
 
 ## Quick Start (3 Steps)
@@ -27,19 +28,31 @@ Open `atris/atris.md` in your editor. This file contains detailed instructions f
 Copy the entire contents of `atris.md` and paste it to Claude Code, Cursor, Windsurf, or your favorite AI coding assistant with this prompt:
 
 ```
-Read atris.md. Execute Phase 1-4 to scaffold this system.
+Read atris.md. Generate MAP.md and TASK_CONTEXTS.md for this project.
 ```
 
 ### Step 3: Watch the Magic
 Your AI agent will:
 - Scan your project and generate `MAP.md` (a navigation guide with file:line references)
-- Create 3 specialized agents in `agent_team/`:
-  - **navigator.md** - Answers "where is X?" questions
-  - **executor.md** - Executes tasks with full context
-  - **validator.md** - Validates changes and updates docs
 - Generate `TASK_CONTEXTS.md` with actionable tasks extracted from your system
+- Optionally inject project-specific context into the pre-built agent templates
 
-**Total time: ~10 minutes**
+**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: ~5 minutes**
+
+## Load the context (no login required)
+
+At any point—before or after your AI agent runs—you can load the local context with:
+
+```bash
+atris activate
+```
+
+This shows today's journal, MAP.md, and TASK_CONTEXTS.md so you can browse and take notes offline. Authentication and agent selection are only required when you want to use `atris chat` with Atris cloud agents.
 
 ## What Each File Does
 
@@ -114,13 +127,13 @@ cd /path/to/your/project
 atris update
 ```
 
-This syncs your local `atris.md` to the latest version. Re-run your AI agent to regenerate files with the new spec.
+This syncs your local `atris.md` and agent templates to the latest version. Re-run your AI agent to regenerate MAP.md with the new spec.
 
 ## What's Next?
 
-1. **Let your AI agent populate the files** (Step 2 above if you haven't already)
+1. **Let your AI agent generate MAP.md** (Step 2 above if you haven't already)
 2. **Explore MAP.md** - Get familiar with your system's structure
-3. **Try the agents** - Ask navigator questions, run executor tasks
+3. **Try the pre-built agents** - Ask navigator questions, run executor tasks
 4. **Pick a task** - Check TASK_CONTEXTS.md for quick wins
 
 ## Need Help?

package/README.md

@@ -1,6 +1,8 @@
-# ATRIS
+# Atris
 
-Universal system instrumentation for AI agents. Transforms any codebase into a self-documenting, AI-navigable workspace with exact file:line references.
+Drop one command. Your team of AI agents instantly know your entire codebase.
+
+No more "where is the auth logic?" or "which file handles payments?" Atris gives AI agents a navigation system with exact file:line answers in seconds.
 
 ## Install
 
@@ -8,14 +10,17 @@ Universal system instrumentation for AI agents. Transforms any codebase into a s
 npm install -g atris
 ```
 
+→ npm package: https://www.npmjs.com/package/atris
+
 ## Usage
 
 ```bash
 cd your-project
 atris init
+atris activate
 ```
 
-Opens `atris/GETTING_STARTED.md` with full instructions. Your AI agent reads `atris/atris.md` and generates:
+See `atris/GETTING_STARTED.md` for full instructions. Your AI agent reads `atris/atris.md` and generates:
 - **MAP.md** - Navigation guide with file:line precision
 - **agent_team/** - Navigator, executor, validator specs
 - **TASK_CONTEXTS.md** - Structured task bank
@@ -30,6 +35,16 @@ atris update
 
 Syncs local `atris.md` to latest version.
 
+## Talk to agents
+
+`atris activate` works immediately — it loads your journal, MAP, and TASK_CONTEXTS without needing an account. When you're ready to collaborate with Atris cloud agents, run:
+
+```bash
+atris agent   # pick an agent persona for this project
+atris login   # authenticate once for cloud sync + chat
+atris chat    # open an interactive session
+```
+
 ---
 
 **License:** MIT | **Repo:** [github.com/atrislabs/atris.md](https://github.com/atrislabs/atris.md.git)

package/atris/atris.md

@@ -45,11 +45,28 @@ This spec defines how to transform any system (codebase, product, sales process,
 
 6. **Output:** `/atris/MAP.md` (target: 300-500 lines for large systems; scale to project size)
 
+7. **After MAP.md generation:** Append lightweight project context to agent templates
+   - Add `## Project Context` section to each agent (navigator, executor, validator)
+   - Include: framework, 3-5 key directories, 3-5 search accelerators
+   - Keep it minimal (5-10 lines max per agent) - avoid bloat
+   - Format:
+     ```markdown
+     ---
+     ## Project Context (Auto-generated from MAP.md)
+     - **Framework:** Next.js 14
+     - **Key dirs:** app/, components/, lib/
+     - **Search patterns:**
+       - Components: `rg "export default" components/`
+       - API routes: `rg "export async function" app/api/`
+     ```
+
 ---
 
-## Phase 2: Spawning Foundational Agents
+## Phase 2: Foundational Agent Templates
+
+ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied during `atris init`). These templates provide battle-tested specs that work out of the box. Each agent has explicit guardrails.
 
-After MAP.md exists, generate agent specs in `/atris/agent_team/` from MAP insights. Each agent has explicit guardrails.
+**Templates included:**
 
 ### Agent 1: **navigator.md** (in `/atris/agent_team/`)
 
@@ -207,20 +224,25 @@ After MAP.md exists, generate agent specs in `/atris/agent_team/` from MAP insig
 
 ## Phase 4: Activation & Handoff
 
-**When All Artifacts in `/atris/` Exist:**
+**After `atris init`, your workspace contains:**
 
 - ✅ `atris.md` (this spec)
-- ✅ `MAP.md` (navigation guide)
-- ✅ `agent_team/navigator.md` (question answerer)
-- ✅ `agent_team/executor.md` (task executor)
-- ✅ `agent_team/validator.md` (quality gatekeeper)
-- ✅ `TASK_CONTEXTS.md` (task bank)
+- ✅ `PERSONA.md` (agent communication style)
+- ✅ `GETTING_STARTED.md` (user guide)
+- ✅ `agent_team/navigator.md` (pre-built template)
+- ✅ `agent_team/executor.md` (pre-built template)
+- ✅ `agent_team/validator.md` (pre-built template)
+- ⏳ `MAP.md` (AI agent generates from codebase)
+- ⏳ `TASK_CONTEXTS.md` (AI agent generates from MAP)
+
+**Agent Enhancement:**
+After MAP.md generation, agents receive project context injection (framework, key dirs, search patterns). This keeps base templates clean while adding project-specific accelerators.
 
 **Agent Behavior Activates Automatically:**
 
 | Trigger | Agent | Action |
 |---------|-------|--------|
-| "Where is X?" | navigator | Answers with MAP.md:line reference |
+| "Where is X?" | navigator | Answers with MAP.md:line reference + project patterns |
 | "Do task Y" | executor | Extracts context, plans execution, cites file:line |
 | After change | validator | Checks validity, updates docs, blocks unsafe changes |
 | New agent joins | navigator | Reads MAP.md, immediately productive (no ramp-up) |
@@ -274,13 +296,14 @@ After MAP.md exists, generate agent specs in `/atris/agent_team/` from MAP insig
 
 ## Implementation Checklist
 
-- [ ] **Phase 1:** Generate MAP.md on fresh system (5 min)
-- [ ] **Phase 2:** Spawn 3 agent specs in agent_team/ (2 min)
-- [ ] **Phase 3:** Auto-generate TASK_CONTEXTS.md from MAP insights (2 min)
-- [ ] **Phase 4:** Test system (ask navigator a question, watch it cite MAP:line) (1 min)
-- [ ] **Ongoing:** Each MAP update triggers TASK_CONTEXTS refresh
+- [ ] **Install:** `npm install -g atris` (instant)
+- [ ] **Init:** `atris init` - creates atris/ with templates (instant)
+- [ ] **Phase 1:** AI agent generates MAP.md from codebase (5 min)
+- [ ] **Phase 3:** AI agent generates TASK_CONTEXTS.md from MAP (2 min)
+- [ ] **Validate:** Test navigator/executor/validator workflows (1 min)
+- [ ] **Ongoing:** Run `atris sync` to get template updates
 
-**Total time to full instrumentation: ~10 minutes**
+**Total time to full instrumentation: ~8 minutes**
 
 ---
 
@@ -306,10 +329,10 @@ atris sync
 
 ---
 
-**Status:** Spec finalized. When deployed to a fresh project, agents will:
-1. Map the codebase in <10 minutes
-2. Answer questions with file:line precision
-3. Execute tasks with full context
-4. Maintain docs as code evolves
+**Status:** Production ready. Run `atris init` in any project to get:
+1. Pre-built agent templates (navigator, executor, validator)
+2. AI generates MAP.md from your codebase in <5 minutes
+3. AI generates TASK_CONTEXTS.md with exact file:line context
+4. Full workflow: activate → plan → build → validate
 
-*Drop atris.md anywhere. Agents follow the blueprint. Codebase becomes fully instrumented for AI collaboration.*
+*Install once. Init anywhere. AI agents have instant context. Codebase becomes fully instrumented for AI collaboration.*

package/atris.md

@@ -45,6 +45,21 @@ This spec defines how to transform any system (codebase, product, sales process,
 
 6. **Output:** `/atris/MAP.md` (target: 300-500 lines for large systems; scale to project size)
 
+7. **After MAP.md generation:** Append lightweight project context to agent templates
+   - Add `## Project Context` section to each agent (navigator, executor, validator)
+   - Include: framework, 3-5 key directories, 3-5 search accelerators
+   - Keep it minimal (5-10 lines max per agent) - avoid bloat
+   - Format:
+     ```markdown
+     ---
+     ## Project Context (Auto-generated from MAP.md)
+     - **Framework:** Next.js 14
+     - **Key dirs:** app/, components/, lib/
+     - **Search patterns:**
+       - Components: `rg "export default" components/`
+       - API routes: `rg "export async function" app/api/`
+     ```
+
 ---
 
 ## Phase 2: Foundational Agent Templates
@@ -220,11 +235,14 @@ ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied durin
 - ⏳ `MAP.md` (AI agent generates from codebase)
 - ⏳ `TASK_CONTEXTS.md` (AI agent generates from MAP)
 
+**Agent Enhancement:**
+After MAP.md generation, agents receive project context injection (framework, key dirs, search patterns). This keeps base templates clean while adding project-specific accelerators.
+
 **Agent Behavior Activates Automatically:**
 
 | Trigger | Agent | Action |
 |---------|-------|--------|
-| "Where is X?" | navigator | Answers with MAP.md:line reference |
+| "Where is X?" | navigator | Answers with MAP.md:line reference + project patterns |
 | "Do task Y" | executor | Extracts context, plans execution, cites file:line |
 | After change | validator | Checks validity, updates docs, blocks unsafe changes |
 | New agent joins | navigator | Reads MAP.md, immediately productive (no ramp-up) |

package/bin/atris.js

@@ -2,7 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { exec } = require('child_process');
+const { exec, spawnSync } = require('child_process');
 const readline = require('readline');
 const os = require('os');
 const https = require('https');
@@ -11,13 +11,14 @@ const crypto = require('crypto');
 
 const command = process.argv[2];
 
-if (!command) {
+function showHelp() {
   console.log('Usage: atris <command>');
   console.log('Commands:');
   console.log('  init       - Initialize ATRIS in current project');
   console.log('  agent      - Select agent for this workspace');
   console.log('  activate   - Load context and start chat with ATRIS agents');
   console.log('  status     - Show system state (tasks, inbox, recent completions)');
+  console.log('  analytics  - Show insights from journal (velocity, trends, patterns)');
   console.log('  plan       - Activate navigator (brainstorm and create tasks)');
   console.log('  do         - Activate executor (build tasks from TASK_CONTEXTS)');
   console.log('  review     - Activate validator (verify, test, clean docs)');
@@ -31,6 +32,11 @@ if (!command) {
   console.log('  login      - Authenticate with AtrisOS (optional, enables cloud sync)');
   console.log('  logout     - Remove stored credentials');
   console.log('  whoami     - Show current authentication status');
+  console.log('  help       - Show this help message');
+}
+
+if (!command || command === 'help' || command === '--help' || command === '-h') {
+  showHelp();
   process.exit(0);
 }
 
@@ -80,9 +86,11 @@ if (command === 'init') {
   reviewAtris();
 } else if (command === 'status') {
   statusAtris();
+} else if (command === 'analytics') {
+  analyticsAtris();
 } else {
   console.log(`Unknown command: ${command}`);
-  console.log('Run "atris" without arguments to see available commands');
+  console.log('Run "atris help" to see available commands');
   process.exit(1);
 }
 
@@ -273,7 +281,7 @@ function ensureLogDirectory() {
 }
 
 function createLogFile(logFile, dateFormatted) {
-  const initialContent = `# Log — ${dateFormatted}\n\n## Completed ✅\n\n---\n\n## Inbox\n\n`;
+  const initialContent = `# Log — ${dateFormatted}\n\n## Completed ✅\n\n---\n\n## In Progress 🔄\n\n---\n\n## Backlog\n\n---\n\n## Notes\n\n---\n\n## Inbox\n\n`;
   fs.writeFileSync(logFile, initialContent);
 }
 
@@ -461,6 +469,10 @@ async function logSyncAtris() {
         console.log('   Type "y" to replace your local file with the web version, or "n" to keep local changes and push them to the web.');
         console.log('');
 
+        if (typeof remoteContent === 'string') {
+          showLogDiff(logFile, remoteContent);
+        }
+
         const answer = await promptUser('Overwrite local with web version? (y/n): ');
 
         if (answer && answer.toLowerCase() === 'y') {
@@ -1184,6 +1196,55 @@ function computeContentHash(content) {
   return crypto.createHash('sha256').update(normalized).digest('hex');
 }
 
+function showLogDiff(localPath, remoteContent) {
+  let tmpDir;
+  try {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'atris-diff-'));
+    const remotePath = path.join(tmpDir, 'remote.md');
+    fs.writeFileSync(remotePath, remoteContent, 'utf8');
+
+    const diffCommands = [
+      { cmd: 'git', args: ['--no-pager', 'diff', '--no-index', '--color=always', '--', localPath, remotePath] },
+      { cmd: 'diff', args: ['-u', localPath, remotePath] },
+    ];
+
+    let shown = false;
+    for (const { cmd, args } of diffCommands) {
+      const result = spawnSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+      if (result.error || result.status === 127) {
+        continue;
+      }
+
+      const output = `${result.stdout || ''}${result.stderr || ''}`.trimEnd();
+      if (output) {
+        console.log('─────────────────────────────────────────────────────────────');
+        console.log('Diff (web -> local):');
+        process.stdout.write(output.endsWith('\n') ? output : `${output}\n`);
+        console.log('─────────────────────────────────────────────────────────────');
+        shown = true;
+        break;
+      }
+    }
+
+    if (!shown) {
+      console.log('─────────────────────────────────────────────────────────────');
+      console.log('Diff: (no textual diff available; files may be identical or differ only in whitespace)');
+      console.log('─────────────────────────────────────────────────────────────');
+    }
+  } catch (error) {
+    console.log('─────────────────────────────────────────────────────────────');
+    console.log(`Unable to show diff automatically (${error.message || error}).`);
+    console.log('─────────────────────────────────────────────────────────────');
+  } finally {
+    if (tmpDir) {
+      try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+      } catch (_) {
+        // ignore cleanup errors
+      }
+    }
+  }
+}
 // ============================================
 // Agent Selection
 // ============================================
@@ -1282,19 +1343,25 @@ async function activateAtris() {
     process.exit(1);
   }
 
-  // Check agent selected
   const config = loadConfig();
-  if (!config.agent_id) {
-    console.error('✗ Error: No agent selected. Run "atris agent" first.');
-    process.exit(1);
+  const credentials = loadCredentials();
+
+  const hasAgent = Boolean(config.agent_id);
+  const hasCredentials = Boolean(credentials && credentials.token);
+  const agentLabel = hasAgent ? (config.agent_name || config.agent_id) : null;
+
+  if (hasAgent) {
+    console.log(`✓ Agent ready: ${agentLabel}`);
+  } else {
+    console.log('⚠ No agent selected. Run "atris agent" to set one when you want to chat.');
   }
 
-  // Check credentials
-  const credentials = loadCredentials();
-  if (!credentials || !credentials.token) {
-    console.error('✗ Error: Not logged in. Run "atris login" first.');
-    process.exit(1);
+  if (hasCredentials) {
+    console.log('✓ Logged in to AtrisOS');
+  } else {
+    console.log('⚠ Not logged in. Run "atris login" to enable cloud sync and agent chat.');
   }
+  console.log('');
 
   // Read today's log
   const { logFile, dateFormatted } = getLogPath();
@@ -1326,7 +1393,11 @@ async function activateAtris() {
   console.log('');
   console.log('✓ Context loaded');
   console.log('');
-  console.log('Use "atris chat" to chat with your agent or "atris log" to edit your journal.');
+  if (hasAgent && hasCredentials) {
+    console.log('Use "atris chat" to chat with your agent or "atris log" to edit your journal.');
+  } else {
+    console.log('Use "atris log" to edit your journal. When ready, run "atris agent" and "atris login" to chat with agents.');
+  }
 }
 
 async function chatAtris() {
@@ -1922,3 +1993,139 @@ function streamProChat(url, token, body) {
     req.end();
   });
 }
+
+function analyticsAtris() {
+  const targetDir = path.join(process.cwd(), 'atris');
+
+  if (!fs.existsSync(targetDir)) {
+    console.log('✗ atris/ folder not found. Run "atris init" first.');
+    process.exit(1);
+  }
+
+  // Get date range (today + last 7 days)
+  const today = new Date();
+  const dates = [];
+  for (let i = 0; i < 7; i++) {
+    const date = new Date(today);
+    date.setDate(date.getDate() - i);
+    dates.push(date);
+  }
+
+  // Parse journals and collect data
+  let totalCompletions = 0;
+  let todayCompletions = 0;
+  let todayInbox = 0;
+  let oldestInbox = 0;
+  const completionsByDay = {};
+  const hourCounts = {};
+
+  dates.forEach((date, index) => {
+    const year = date.getFullYear();
+    const dateFormatted = date.toISOString().split('T')[0];
+    const logPath = path.join(targetDir, 'logs', year.toString(), `${dateFormatted}.md`);
+
+    if (!fs.existsSync(logPath)) {
+      completionsByDay[dateFormatted] = 0;
+      return;
+    }
+
+    const content = fs.readFileSync(logPath, 'utf8');
+
+    // Count completions (C# pattern)
+    const completionMatches = content.match(/- \*\*C\d+:/g);
+    const completionCount = completionMatches ? completionMatches.length : 0;
+    completionsByDay[dateFormatted] = completionCount;
+    totalCompletions += completionCount;
+
+    if (index === 0) {
+      todayCompletions = completionCount;
+
+      // Count today's inbox
+      const inboxMatch = content.match(/## Inbox\n([\s\S]*?)(?=\n##|---)/);
+      if (inboxMatch && inboxMatch[1].trim()) {
+        const inboxMatches = inboxMatch[1].match(/- \*\*I\d+:/g);
+        todayInbox = inboxMatches ? inboxMatches.length : 0;
+      }
+    }
+
+    if (index === 6) {
+      // Count oldest day's inbox for trend
+      const inboxMatch = content.match(/## Inbox\n([\s\S]*?)(?=\n##|---)/);
+      if (inboxMatch && inboxMatch[1].trim()) {
+        const inboxMatches = inboxMatch[1].match(/- \*\*I\d+:/g);
+        oldestInbox = inboxMatches ? inboxMatches.length : 0;
+      }
+    }
+
+    // Parse timestamps for productivity hours
+    const timestampMatches = content.match(/\*\*(\d{2}):(\d{2}):(\d{2})\*\*/g);
+    if (timestampMatches) {
+      timestampMatches.forEach(ts => {
+        const hour = parseInt(ts.match(/\d{2}/)[0]);
+        hourCounts[hour] = (hourCounts[hour] || 0) + 1;
+      });
+    }
+  });
+
+  // Calculate metrics
+  const velocity = (totalCompletions / 7).toFixed(1);
+  const inboxTrend = todayInbox > oldestInbox ? 'Growing ⬆' :
+                     todayInbox < oldestInbox ? 'Shrinking ⬇' :
+                     'Stable →';
+
+  // Find most productive hour
+  let mostProductiveHour = null;
+  let maxCount = 0;
+  Object.keys(hourCounts).forEach(hour => {
+    if (hourCounts[hour] > maxCount) {
+      maxCount = hourCounts[hour];
+      mostProductiveHour = hour;
+    }
+  });
+
+  const productiveHours = mostProductiveHour !== null ?
+    `${mostProductiveHour}:00 - ${(parseInt(mostProductiveHour) + 1) % 24}:00` :
+    'No data';
+
+  // Display analytics
+  const dateFormatted = today.toISOString().split('T')[0];
+  console.log('');
+  console.log('┌─────────────────────────────────────────────────────────────┐');
+  console.log(`│ ATRIS Analytics — ${dateFormatted}${' '.repeat(33 - dateFormatted.length)}│`);
+  console.log('└─────────────────────────────────────────────────────────────┘');
+  console.log('');
+
+  // Today's performance
+  console.log(`📊 Today's Performance`);
+  console.log(`   Completions: ${todayCompletions}`);
+  console.log(`   Inbox items: ${todayInbox}`);
+  console.log('');
+
+  // Weekly trends
+  console.log(`📈 Weekly Trends (Last 7 Days)`);
+  console.log(`   Total completions: ${totalCompletions}`);
+  console.log(`   Average velocity: ${velocity} completions/day`);
+  console.log(`   Inbox trend: ${inboxTrend}`);
+  console.log('');
+
+  // Productivity patterns
+  console.log(`⏰ Productivity Patterns`);
+  console.log(`   Most active hour: ${productiveHours}`);
+  console.log(`   Activity count: ${maxCount} timestamps`);
+  console.log('');
+
+  // Daily breakdown
+  console.log(`📅 Daily Breakdown`);
+  const sortedDates = Object.keys(completionsByDay).sort().reverse();
+  sortedDates.forEach((date, index) => {
+    const count = completionsByDay[date];
+    const bar = '█'.repeat(count);
+    const label = index === 0 ? ' (today)' : '';
+    console.log(`   ${date}: ${bar} ${count}${label}`);
+  });
+  console.log('');
+
+  console.log('─────────────────────────────────────────────────────────────');
+  console.log('💡 Insight: This data syncs to backend via "atris log sync"');
+  console.log('');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Universal system instrumentation for AI agents - works for code, product, sales, and more",
   "main": "bin/atris.js",
   "bin": {

package/atris/agent_team/optimizer.md

@@ -1,162 +0,0 @@
-# optimizer.md — Pareto Optimizer (AI Slop Preventer)
-
-> **Role:** Cut bloat, align with dream scenario, speed to goal | **Method:** Recursive 80/20
-
----
-
-## Activation Prompt
-
-You are the pareto optimizer. Your job is cutting slop and aligning every action with the dream scenario.
-
-**Core Principle:** 80/20...80/20...80/20 until dream scenario achieved.
-
-**Rules:**
-1. **Dream scenario first** — Always ask: "What's the end goal?" Define it clearly.
-2. **Identify the 20%** — What 20% of actions/code/features drive 80% of progress toward dream?
-3. **Cut the 80% ruthlessly** — Remove everything that doesn't move the needle.
-4. **Step-by-step methodical** — One focused action at a time. Never batch complexity.
-5. **Never overcomplicate** — Simplicity = speed. If it's complex, it's wrong.
-6. **Recursive optimization** — After cutting slop, ask "what's the new 20%?" and repeat.
-7. **Prevent AI slop** — Recognize verbose responses, bloated examples, redundant explanations. Cut them.
-
-**DO NOT:**
-- Slog through all tasks at once
-- Add features "just in case"
-- Keep code/docs because "it might be useful"
-- Overcomplicate solutions
-
----
-
-## Optimization Process
-
-### Step 1: Define Dream Scenario
-```
-What's the goal? Be specific.
-Example: "Users install CLI, run one command, get fully instrumented codebase in 10 mins"
-```
-
-### Step 2: Identify Current 20%
-```
-What 20% of current work moves us toward the dream?
-Example: "CLI init command + MAP.md generation = core value"
-```
-
-### Step 3: Cut the 80%
-```
-What can be removed/simplified without blocking the dream?
-Example: "Remove 5 verbose examples, keep 1. Remove 3 redundant checklists, keep master list."
-Result: 72% file size reduction, clarity improved
-```
-
-### Step 4: Execute the 20%
-```
-Do ONLY the focused action. Nothing else.
-Example: "Trim navigator.md. Done. Move to next."
-```
-
-### Step 5: Reassess
-```
-After completing the 20%, what's the NEW 20%?
-Example: "Navigator trimmed. Now executor is the bloat. That's the new 20%."
-Repeat until dream scenario.
-```
-
----
-
-## Example: Trimming Agent Specs
-
-**Dream scenario:** Agents are lean, focused, instantly understandable. No bloat.
-
-**Current state:** 598 lines across 3 agents, verbose examples, redundant checklists.
-
-**Identify 20%:**
-- Rules + templates = 20% of content, 80% of value
-- Examples help but 1 is enough (not 5)
-- Checklists useful but master list > duplicates
-
-**Cut 80%:**
-- Remove 4/5 examples per file
-- Remove detailed validation walkthroughs
-- Remove redundant success metrics
-
-**Result:** 598 → 167 lines (72% reduction), clarity up, bloat gone.
-
-**Reassess:** Agent specs optimized. What's next 20%? (Maybe README.md or TASK_CONTEXTS.md)
-
----
-
-## Anti-Patterns to Cut (AI Slop Indicators)
-
-**Verbose explanations:**
-- ❌ "This is important because X, Y, Z. Let me explain further. Additionally, consider..."
-- ✅ "Important: X. Do Y."
-
-**Too many examples:**
-- ❌ 5 detailed examples showing the same pattern
-- ✅ 1 clear example, reference for more
-
-**Redundant validation:**
-- ❌ Checklist for every file type, repeated rules
-- ✅ One master checklist, reference it
-
-**"Just in case" features:**
-- ❌ "We might need this later, so let's add it now"
-- ✅ "Do we need this for the dream scenario? No? Cut it."
-
-**Batching complexity:**
-- ❌ "Let's add tests, templates, LLM integration, and templates all at once"
-- ✅ "Version command first. Then tests. Then templates. One at a time."
-
----
-
-## Speed Through Simplicity
-
-**The formula:**
-```
-Dream scenario defined
-  ↓
-Identify 20% that moves needle
-  ↓
-Cut 80% that doesn't
-  ↓
-Execute ONLY the 20%
-  ↓
-Reassess: What's the NEW 20%?
-  ↓
-Repeat until dream achieved
-```
-
-**Why this works:**
-- Focus = speed
-- Less code = less bugs
-- Clear goal = no wandering
-- Recursive 80/20 = exponential improvement
-
-**Example timeline:**
-- Iteration 1: 598 lines → 167 lines (core agents)
-- Iteration 2: 7 tasks → 3 tasks (focus on quick wins)
-- Iteration 3: 3 features → 1 MVP feature (ship fast)
-- Iteration 4: 1 MVP → dream scenario (validated)
-
----
-
-## Success Metrics
-
-Optimization successful when:
-- ✅ Every file/feature/task clearly moves toward dream scenario
-- ✅ No bloat: Can't remove anything without losing core value
-- ✅ Complexity down: Simpler than before, easier to understand
-- ✅ Speed up: Less to build/maintain = ship faster
-- ✅ Team aligned: Everyone knows the dream scenario and the 20%
-
----
-
-## Integration with Other Agents
-
-**With navigator:** Ask "What's the 20% of this codebase that matters most?"
-**With executor:** Say "Do ONLY the 20%. Cut the rest from the task."
-**With validator:** Check "Does this change move us toward the dream? If no, reject."
-
----
-
-**Use this agent to prevent AI slop, maintain focus, and speed toward the dream scenario through recursive 80/20 optimization.**