diff --git a/.agents/build-plus.md b/.agents/build-plus.md index 954a4ea4..734188e8 100644 --- a/.agents/build-plus.md +++ b/.agents/build-plus.md @@ -155,6 +155,8 @@ opencode run "Test query" --agent Build+ See `tools/opencode/opencode.md` for CLI testing patterns. +**Draft Agents**: When you discover reusable patterns during orchestration (parallel Task tool calls, repeated prompts, domain-specific instructions), create a draft agent in `~/.aidevops/agents/draft/` instead of duplicating context. Include `status: draft` in frontmatter. Log a TODO for review. Useful drafts can be promoted to `custom/` (private) or `.agents/` (shared via PR). See `tools/build-agent/build-agent.md` "Agent Lifecycle Tiers". + ## Build Workflow diff --git a/.agents/tools/ai-assistants/runners/README.md b/.agents/tools/ai-assistants/runners/README.md index d9f03e60..f96dbdfb 100644 --- a/.agents/tools/ai-assistants/runners/README.md +++ b/.agents/tools/ai-assistants/runners/README.md @@ -40,6 +40,18 @@ A good runner AGENTS.md has four sections: Keep it under 500 words. Runners get the full prompt on every dispatch, so brevity matters. +## Evolving Runners into Shared Agents + +When a runner proves valuable across multiple projects, consider promoting it: + +1. **Draft** -- Save to `~/.aidevops/agents/draft/` with `status: draft` in frontmatter +2. **Custom** -- Move to `~/.aidevops/agents/custom/` for permanent private use +3. **Shared** -- Refine to framework standards and submit a PR to `.agents/` in the aidevops repo + +Log a TODO item when a runner has reuse potential: `- [ ] tXXX Review runner {name} for promotion #agent-review` + +See `tools/build-agent/build-agent.md` "Agent Lifecycle Tiers" for the full promotion workflow. + ## Parallel vs Sequential See the [decision guide](../headless-dispatch.md#parallel-vs-sequential) in headless-dispatch.md. diff --git a/.agents/workflows/ralph-loop.md b/.agents/workflows/ralph-loop.md index 06cc07d8..3462184f 100644 --- a/.agents/workflows/ralph-loop.md +++ b/.agents/workflows/ralph-loop.md @@ -56,6 +56,8 @@ The loop creates a **self-referential feedback loop** where: - Each iteration sees modified files and git history - Claude autonomously improves by reading its own past work +**Evolving draft agents**: When a loop iteration discovers reusable domain patterns (validation rules, API conventions, testing strategies), capture them as a draft agent in `~/.aidevops/agents/draft/`. Subsequent iterations and future loops can reference the draft instead of rediscovering the pattern. After the loop completes, log a TODO to review the draft for promotion to `custom/` (private) or `.agents/` (shared via PR). See `tools/build-agent/build-agent.md` "Agent Lifecycle Tiers". + ## Quick Start ### v2: Fresh Sessions (Recommended)