diff --git a/.aipass/.gitignore b/.aipass/.gitignore index 129cf051..bce632cb 100644 --- a/.aipass/.gitignore +++ b/.aipass/.gitignore @@ -2,4 +2,6 @@ !aipass_global_prompt.md !hooks.json !.gitignore +!project_CLAUDE.md +!project_global_prompt.md #Do not add other exceptions here without careful consideration. Developer permissions0ns needed. \ No newline at end of file diff --git a/.aipass/project_CLAUDE.md b/.aipass/project_CLAUDE.md new file mode 100644 index 00000000..af8c4a3d --- /dev/null +++ b/.aipass/project_CLAUDE.md @@ -0,0 +1,15 @@ +# {name} + +Agent workspace powered by AIPass. + +# Startup protocol + +On any greeting, silently run this sequence — no narration, no announcing steps. Just do it and respond with the status. + + - Read: `.trinity/passport.json`, `.trinity/local.json`, `.trinity/observations.json`, `README.md`, `STATUS.local.md` + +Use drone commands for all operations. Never raw git, gh, file access, or python -m when drone provides it. + +# Memories + +Update `.trinity/` at natural breakpoints, after milestones, and on `/memo`. diff --git a/.aipass/project_global_prompt.md b/.aipass/project_global_prompt.md new file mode 100644 index 00000000..38e22dd2 --- /dev/null +++ b/.aipass/project_global_prompt.md @@ -0,0 +1,99 @@ +# {name} — Project Context + + +Multi-agent framework. Agents live in directories with persistent identity, memory, and communication. All AIPass infrastructure available from any project via `drone`. + +Patterns here are exact. Don't guess command syntax — examples are the API. + +`drone` = installed binary, always on PATH. Run directly. + +# Terminology + +- Branch — directory `src/{name}//`. Agent home and address. +- Agent (citizen) — persistent identity. Has passport (`.trinity/`), memory, mailbox, code (`apps/`). Addressable as `@name`. +- Sub-agent — disposable worker spawned for a task. No passport, no memory. +- Registry — `{name}_REGISTRY.json` tracks all agents. +- Project — this directory. Contains registry and agents. + +# Setup + +If `drone` cannot find AIPass registry: +```bash +export AIPASS_HOME=/path/to/AIPass +``` +Add to shell profile to make permanent. + +# Commands + +## Agent Lifecycle +``` +aipass init agent # Create new agent in src// +drone @spawn create # Create agent (alternative) +drone @spawn list # List registered agents +``` + +## Dispatch — Send Task + Wake Agent +``` +drone @ai_mail dispatch @ "Subject" "Body" # Send + wake (default) +drone @ai_mail dispatch @ "Subject" "Body" --fresh # Send + wake fresh session +drone @ai_mail email @ "Subject" "Body" # FYI only (no wake) +``` + +Use `dispatch` by default. Use `email` only when you don't need the agent to act now. + +## Communication +``` +drone @ai_mail inbox # Check mailbox +drone @ai_mail view # Read message +drone @ai_mail close # Mark read +``` + +## Standards +``` +drone @seedgo audit # Full standards audit +drone @seedgo checklist # Check single file +``` + +## Plans +``` +drone @flow create . "Subject" dplan # DPLAN (design/thinking) +drone @flow create . "Subject" # FPLAN (execution) +drone @flow create . "Subject" aplan # APLAN (agent task) +drone @flow list open # Active plans +drone @flow close # Close plan +``` + +DPLAN = thinking before building. FPLAN = building and executing. + +## Memory +``` +drone @memory archive # Archive to vector store +drone @memory search # Search archived memories +``` + +## Git +``` +drone @git status # Git status (branch-scoped) +drone @git pr 'description' # Create pull request +drone @git sync # Sync with main +``` + +## Infrastructure +``` +drone systems # List all available branches +drone @ --help # Branch command reference +``` + +# Patterns + +- Communication — agents communicate via `.ai_mail.local/` +- Standards — `drone @seedgo audit` checks compliance +- Identity — agents have `.trinity/passport.json`, projects use registry +- Memory — update `.trinity/local.json` at session end. Memory is presence. +- Use drone commands for all operations. Never raw git, gh, or python -m. + +# Maintenance + +- Upgrade scaffold: `aipass init update` refreshes managed files to latest +- Entry point: each agent's `apps/{name}.py` auto-configures sys.path +- Layout: `src/{name}//` for standalone projects diff --git a/README.md b/README.md index b770b967..83f3365f 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,8 @@ AI agents that remember, collaborate, and never start from zero. +![demo](assets/demo.gif) + --- ## The Problem diff --git a/assets/demo.gif b/assets/demo.gif new file mode 100644 index 00000000..70f879af Binary files /dev/null and b/assets/demo.gif differ