Core
core is the fleet's autonomous agent-orchestration system for the @marksverdhai AI account. Monitors notifications (GitHub, HuggingFace) and spawns snail agents to handle actionable items.
Stack: Python. Private repo. Legacy repo: marksverdhai/core.
HAI family
| Repo | Role |
|---|---|
| snail | Docker agent environment with Claude Code CLI. |
| core (this) | Agent orchestration + notification handling. |
| core-frontend | SvelteKit monitoring dashboard. |
Slash commands
Invoke workflows by mentioning @marksverdhai with a slash command in issue / PR comments:
| Command | Workflow |
|---|---|
/w:feature-implementation |
Feature implementation from issue to merge, with automatic CI handling + review cycles. |
/w:mention-response |
Unified @mention handling — routes to simple response or full implementation. |
/w:pr-review-loop |
Collaborative review cycle with feedback loops + iteration tracking. |
/w:pr-janitor |
Manages stale PRs (update or close). |
/w:three-wise-men |
Three specialized reviewers per PR. |
/descend |
Creates descendant issue for remaining tasks when main objective is complete. |
Architecture
A Notification Listener polls sources, a Context Loader assembles workspace state, and either fans out to a Snail Agent container or an Workflow Engine (label-based state machine). Semantic router picks the right snail image per task; see docs/ROUTER.md.
Sources
- README
docs/ARCHITECTURE.md,docs/WORKFLOWS.md,docs/WORKFLOW_AUTHORING.md.