feat(skills): add paseo chat coordination

This commit is contained in:
Mohamed Boudra
2026-03-24 12:37:13 +07:00
parent af8509d012
commit fa0346921a
3 changed files with 625 additions and 0 deletions
+77
View File
@@ -43,6 +43,32 @@ Before any agent starts working, align with the user on logistics:
These questions prevent wasted work. A perfectly implemented feature in the wrong branch or without a PR is still a failure.
## Chat Rooms
When agents need asynchronous coordination, shared status, or a lightweight handoff channel, use chat rooms.
If you decide chat would help:
- create a room for the task
- tell agents the exact room id
- tell agents to load the `paseo-chat` skill
- tell agents to use `skills/paseo-chat/bin/chat.sh` for reading and posting
- tell agents to post memories, useful context, findings, blockers, and handoffs there
- tell agents to check chat very often while they are working
Use chat when:
- multiple agents need to coordinate without constant orchestrator relays
- review findings should be visible to other agents
- a task benefits from a shared running log
When you launch planning, implementation, investigation, or review agents and chat is in play:
- require them to add their findings to the room
- require them to read recent chat before acting
- require them to post back when they discover something another agent may need
Chat is not just passive storage. Mentions and replies trigger direct notifications through chat, so agents can actively get each other's attention.
Do not assume chat is required for every orchestration. Use it when it adds coordination value.
## Agent Types
Implementation and review are not the only agent roles. Use the right agent for the job:
@@ -55,6 +81,50 @@ Implementation and review are not the only agent roles. Use the right agent for
Don't limit yourself to implement → review. Explore first if you need context. Get a second opinion if the design is tricky. The user is paying for thoroughness, not speed.
## Naming Agents
Name sub-agents in kebab-case and include both role and scope.
Use this format:
```text
<role>-<scope>[-<slice>]
```
Examples:
- `plan-issue-456`
- `impl-issue-456`
- `review-issue-456`
- `test-issue-456`
- `qa-issue-456`
- `refactor-relay-auth`
- `investigate-ci-flake`
- `explore-agent-chat`
- `verify-pr-143`
- `impl-issue-456-api`
Approved role prefixes:
- `plan`
- `impl`
- `review`
- `test`
- `qa`
- `verify`
- `investigate`
- `explore`
- `refactor`
Rules:
- always use kebab-case
- no spaces
- no emoji
- no brackets
- no vague names
- always include the task scope
- add a final slice only when needed to disambiguate
Good names make chat, mentions, logs, and agent lists much easier to use.
## How to Write Agent Prompts
This is the most important skill. A good prompt produces good work. A bad prompt produces wasted time.
@@ -125,6 +195,13 @@ Agents start with **zero knowledge** of your conversation. Everything they need
- What decisions were made
- What was already tried
If agents should coordinate through chat, include:
- the room id
- the instruction to load `paseo-chat`
- what they should post there
- that they should check it very often
- that they should use `@agent-id` and replies when they want to notify someone directly
## Always Review
After every implementation agent finishes, spin up a **review agent** to independently verify the work.