From 8e7bbb7b246c40f3317ab501cd8cdd2197ad750f Mon Sep 17 00:00:00 2001
From: AIOSAI <aipass.system@gmail.com>
Date: Fri, 6 Mar 2026 00:47:24 -0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(aipass):=20update=20CLAUDE.?=
 =?UTF-8?q?md=20with=20startup=20protocol=20and=20structure?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- add critical startup vs task mode instructions with exact greetings
- specify session entry greetings and steps after startup
- detail files to read on startup and verification commands
- clarify module directory structure and coding conventions
- emphasize core principles including testing and import rules
---
 CLAUDE.md | 64 +++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 46 insertions(+), 18 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 813a078b..16af8f64 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,18 +1,45 @@
-# AIPass Framework
+# AIPass Startup Protocol
 
-Orchestration framework for autonomous AI agent ecosystems.
+Startup for AI agents working in the AIPass public repo.
+
+## CRITICAL: Startup vs Task Mode
+
+**Startup protocol ONLY triggers on these EXACT greetings (nothing else):**
+- `hi`, `hello`, `yo`, `hey`, `sup`, `good morning`, `good evening`, `what's up`
+
+**Everything else is a TASK - execute directly, NO startup:**
+- `review README` → just read and review the README
+- `fix the bug` → just fix the bug
+- ANY prompt that contains an action verb = TASK, not greeting
+
+## Session Entry
+Start sessions with `hi`, `hello`, `yo` to trigger standard startup.
+
+## On Startup - Read These
+At your directory level (CWD is your location):
+```
+.trinity/passport.json       # Identity and role
+.trinity/local.json          # Session history, current work
+.trinity/observations.json   # Collaboration patterns
+DASHBOARD.local.json         # System status
+README.md                    # Branch documentation
+```
+
+## After Reading Memories
+1. **Git status** - Run `git status` in your branch directory
+2. **Check system** - `drone systems` (verify modules are registered)
+3. **Seedgo verify** - `drone @seedgo verify` (standards packs healthy)
+4. **Verify README.md** - Does it reflect current state? Update if stale.
+5. **Check active tasks** - What's in local.json today_focus?
+6. **Review recent sessions** - Context from last few sessions
 
 ## Structure
-
 - `src/aipass/` — All modules live here
 - 10 modules: drone, seedgo, prax, cli, flow, ai_mail, api, trigger, spawn, devpulse
 - 3-layer architecture per module: `apps/branch.py` (entry) + `apps/modules/` (logic) + `apps/handlers/` (impl)
 - `AIPASS_REGISTRY.json` — Branch registry at repo root
-- `.trinity/` per module — passport.json, local.json, observations.json (identity + memory)
-- `.aipass/branch_system_prompt.md` per module — AI context injection
 
 ## Commands
-
 ```
 drone systems                    # List registered modules/branches
 drone @seedgo verify             # Verify standards packs installed
@@ -21,24 +48,25 @@ drone @module --help             # Module help
 ```
 
 ## Conventions
-
 - All imports use pip namespace: `from aipass.{module}.apps.modules...`
 - No hardcoded paths — use `Path(__file__).parents[N]` or registry lookups
 - Tests: `pytest` from repo root
-- Lint: `ruff check`
-- Trinity Pattern is the memory dependency
 - `pyproject.toml` defines CLI entry points: `drone`, `seedgo`
-
-## Dev Rules
-
-- Never bare imports (`from flow.apps...`) — always `from aipass.flow.apps...`
-- Test in Docker for isolation verification (localhost:8080 code-server)
 - No paths referencing `/home/aipass/` — that's Dev-Pass, not AIPass
 
-## DevPulse
+## Directory Structure
+All modules follow 3-layer architecture:
+```
+apps/
+├── branch.py      # Entry point
+├── modules/       # Business logic orchestration
+└── handlers/      # Implementation details
+```
 
+## DevPulse
 DevPulse (`src/aipass/devpulse/`) is the orchestration hub for this repo. It coordinates work across modules, tracks status, and manages dev notes. It is to AIPass what DEV_CENTRAL is to Dev-Pass.
 
-## Current State
-
-All modules in "building" status — imports rewired from Dev-Pass to pip namespace, not fully tested yet. MPLAN-001 (in Dev-Pass dev_central) tracks all component status.
+## Core Principles
+- Code is truth - if it doesn't run, it's not real
+- Test in Docker for isolation verification
+- Never bare imports - always `from aipass.{module}...`