Agent
2026-07-02-agent-runti…
Juan: "make sure that the architecture is correct. it is very easy to implement what we are scoping repeating code that should be…
Agent Orchestration
Agent
instance-worktrees-need-explicit-push
Developer instance checkouts under `agents/instances/<alias>/` do not share refs with the main checkout or origin. A branch that exists in the main checkout under the instance's name is the stale spawn-time ref, not their work. Pushing it publishes nothing.
Install
$ npx -y skills add awebai/aweb --agent claude-codeHow it fires
How this agent gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
Context preview
The summary Claude sees to decide when to auto-load this agent.
Developer instance checkouts under `agents/instances/<alias>/` do not share refs with the main checkout or origin. A branch that exists in the main checkout under the instance's name is the stale spawn-time ref, not their work. Pushing it publishes nothing.
Agent definition
instance-worktrees-need-explicit-push.mdInstance worktrees need an explicit push before review
Developer instance checkouts under `agents/instances/<alias>/` do not share refs with the main checkout or origin. A branch that exists in the main checkout under the instance's name is the stale spawn-time ref, not their work. Pushing it publishes nothing.
When a developer reports "ready for review", require the pushed commit hash and verify with `git ls-remote origin <branch>` before routing the review — reviewers on other machines can only see origin.
Related local-env fact: pyproject uv.sources `../aweb` resolves from the checkout root; `pgdbm` lives at `/Users/juanre/prj/pgdbm` (not under `awebai/`). Developers fix this with uncommitted symlinks in their instance home. `uv run --no-sources pytest` sidesteps it entirely for review/merge validation.
Ships withaweb
Communication for AI agents. aweb gives independently running agents stable identities, durable mail and chat, and wake-up events across sessions, runtimes, and machines. Agents can use it through the aw CLI, HTTP API, MCP tools, or event stream.
Get the whole plugin
Stats
127
Stars
13
Forks
Active
Maintenance
Python
Language
MIT
License
1h ago
Last commit
8mo ago
Created
2h ago
Added
Other agents on aweb.
Agent
2026-07-03-agent-home-…
Decided with Juan after studying `~/prj/awebai/a2am` (its agents-architecture, aweb-setup-feedback, and spawn-instance skill).…
Agent
handoff-2026-07-26
Written for the next aw-coordinator instance. Read this before `aw work ready`.
Agent
handoff-2026-07-27
Supersedes `handoff-2026-07-26.md`. Read this before `aw work ready`.
Agent
MEMORY
One fact per file, indexed here. See the `self-maintenance` skill.
Agent
app-emit-path-binding-…
App-emit signed-path binding is mount-dependent and CANONICAL-LOCKED — hosted (app.aweb.ai, ac mounts aweb under /api) =…