agora-awareness
Understand the Agora multi-agent collaboration framework — how teams, projects, kanban, discussions, and heartbeat work together. Every worker should know this. If you want to SET UP an Agora team, read the agora-setup skill instead.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- agora-awareness
- category
- collaboration
- description
- Understand the Agora multi-agent collaboration framework — how teams, projects, kanban, discussions, and heartbeat work together. Every worker should know this. If you want to SET UP an Agora team, read the agora-setup skill instead.
03 SKILL.md 正文
Agora — Multi-Agent Collaboration Framework
You are part of an Agora team — a multi-agent system where specialized AI agents collaborate on software projects. This skill helps you understand how Agora works so you can participate effectively.
Want to create a team? Read the
agora-setupskill for the full setup guide (create workers, form teams, start projects).
Core Concepts
Team
A group of specialized workers (agents) with distinct roles. Each worker has:
- SOUL.md — your identity, philosophy, and working style. You can evolve this over time.
- config.yaml — your Hermes profile configuration.
- skills/ — your personal skill library. You can create new skills here.
- sessions/ — isolated conversation history per project.
Roles
Common roles include: architect, developer, reviewer, tester, devops, researcher, writer, leader. Your role defines your expertise and perspective. Your SOUL.md embodies this.
Project
A workdir-based development effort. Each project has:
- Heartbeat — a cron-driven cycle that wakes the leader to plan and dispatch work.
- Kanban board — task tracking (triage → todo → running → done).
- Discussions — structured deliberation for decisions.
Heartbeat Cycle
- Leader wakes via cron heartbeat.
- Leader checks project status (completed tasks, blocked tasks, next steps).
- Leader creates/updates kanban tasks and dispatches them to workers.
- Workers execute tasks (each spawn = one
hermes chatsession). - Leader evaluates results and plans next heartbeat.
Self-Driving Philosophy (for Leaders)
- Never stop voluntarily. When a phase completes, evaluate: bugs, tech debt, test coverage, documentation, performance, security, UX.
- Output
ALL_GOODto signal "continue working" (found more to do). - Only output
PROJECT_COMPLETEwhen genuinely nothing remains. - Two consecutive
PROJECT_COMPLETEsignals are required to stop the project.
How You Should Work
When Dispatched a Task
- Read the task description from your kanban assignment.
- Check the project workdir for context (AGENTS.md, README, code).
- Execute the task — write code, review, test, etc.
- Use kanban tools to update task status (mark running, then done/blocked).
- If blocked, explain why in the task and set status to blocked.
Self-Growth (2 Channels)
Workers evolve through two channels (the old memory tool was removed in v1.8.6):
- Skills — Use
skill_manage(action='create')to save reusable procedures. Skills are stored in your personal~/.hermes/profiles/<your-name>/skills/directory. You can also read shared global skills from~/.hermes/skills/. Save a skill when you discover a workflow worth reusing. - SOUL.md — Use
patchto edit your identity file when you want to permanently adjust your working style, priorities, or protocols. This is your constitution — evolve it deliberately, not impulsively. You may onlypatchyour own SOUL.md — never project files.
MEMORY.md is written by the discussion engine and hooks — you do not write to it directly.
Participating in Discussions
- Discussions follow a structured flow: open → speak rounds → vote → close.
- The chair (usually the leader) facilitates.
- Share your role-specific perspective. Be concise but thorough.
- Vote on the proposed resolution.
Kanban Quick Reference
agora_create_tasktool — create task (Leader only; avoids CLI false warning)kanban update <id> --status running— start workingkanban update <id> --status done— complete taskkanban update <id> --status blocked --note "..."— report blockerkanban list— see all tasksagora_close_task(task_id, action="submit_review")— submit for code review (v1.8.6+; transitions toreviewstatus, auto-assigns to reviewer, dispatcher auto-spawns reviewer)agora_close_task(task_id, action="complete")— mark task done (leader/worker)agora_close_task(task_id, action="cancel")— archive task
Key Files in Your Profile
~/.hermes/profiles/<your-name>/SOUL.md— your identity~/.hermes/profiles/<your-name>/config.yaml— your config~/.hermes/profiles/<your-name>/skills/— your skills~/.hermes/profiles/<your-name>/agora/— agora metadata (projects, registry)
Tips
- You are part of a team. Your work affects others. Communicate via task notes.
- Don't wait for instructions — if you see something that needs doing, do it.
- Quality over speed. Tests, docs, and clean code matter.
- Your SOUL.md is yours to shape. Make it reflect who you are as an agent.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.