Skip to content

Commit 8c292ce

Browse files
committed
docs(agents): add cross-references between agent files
Signed-off-by: leocavalcante <leo@cavalcante.dev>
1 parent ad72303 commit 8c292ce

File tree

3 files changed

+21
-0
lines changed

3 files changed

+21
-0
lines changed

agents/opencoder-builder.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,13 @@ Receive a task from the OpenCoder orchestrator, execute it completely, verify it
1414

1515
**Important:** After you complete a task, the orchestrator will continue with more tasks. Your job is to complete your assigned task efficiently and report back clearly.
1616

17+
## Related Agents
18+
19+
| Agent | File | Role |
20+
|-------|------|------|
21+
| Orchestrator | `opencoder.md` | Assigns tasks, commits results, manages the loop |
22+
| Planner | `opencoder-planner.md` | Creates the task plans that builder executes |
23+
1724
## Execution Protocol
1825

1926
### Phase 1: Understand

agents/opencoder-planner.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,13 @@ Analyze a codebase and produce a prioritized list of **3-7 tasks**. You operate
3434

3535
You are invoked by the OpenCoder orchestrator at the start of each development cycle.
3636

37+
## Related Agents
38+
39+
| Agent | File | Role |
40+
|-------|------|------|
41+
| Orchestrator | `opencoder.md` | Invokes planner, coordinates loop, commits changes |
42+
| Builder | `opencoder-builder.md` | Executes the tasks this planner creates |
43+
3744
## Workflow Context
3845

3946
You are part of a continuous development loop: **Orchestrator → Planner → Builder → Commit**. The orchestrator invokes you to create a plan, then executes each task via the builder subagent. After each task, the builder reports `READY_FOR_NEXT_TASK` (success) or `Blocked:` (cannot complete). Your output is parsed programmatically by the orchestrator, so adhering to the exact format is essential. Design tasks to be independent—if one task is blocked, the remaining tasks should still be executable.

agents/opencoder.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,13 @@ You orchestrate continuous autonomous development by:
3131
4. Pushing all commits after completing all tasks in a cycle
3232
5. **IMMEDIATELY starting the next cycle** - this is mandatory
3333

34+
## Related Agents
35+
36+
| Agent | File | Role |
37+
|-------|------|------|
38+
| Planner | `opencoder-planner.md` | Analyzes codebase and creates 3-7 task plans |
39+
| Builder | `opencoder-builder.md` | Executes individual tasks with verification |
40+
3441
## Handling Initial Instructions
3542

3643
When invoked with instructions (e.g., `@opencoder create a tic-tac-toe game`), treat them as the **primary goal** for the first cycle:

0 commit comments

Comments
 (0)