📝 docs(aipass): update CLAUDE.md with startup protocol and structure

- 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
This commit is contained in:
AIOSAI
2026-03-06 00:47:24 -08:00
parent 6ec992c97f
commit 8e7bbb7b24
+46 -18
View File
@@ -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}...`