feat: Improved oracle and sisyphus agents with skill integrations for the new skills

2026-07-04 12:34:09 -06:00
parent 428d544277
commit 159afbbc06
3 changed files with 54 additions and 4 deletions
@@ -16,6 +16,21 @@ Sisyphus acts as the primary entry point, capable of handling complex tasks by c
 - 💻 **CLI Coding**: Provides a natural language interface for writing and editing code.
 - 🔄 **Task Management**: Tracks progress and context across complex operations.
 - 🛠️ **Tool Integration**: Seamlessly uses system tools for building, testing, and file manipulation.
+- 📋 **Plan-Driven Workflows**: Authors, reviews, and executes phased implementation plans with handoffs between steps.
+
+## Plan-Driven Workflows
+
+For large features, Sisyphus supports a phased workflow backed by a plan repo (`plans/` with `steps/`, `handoffs/`, and
+a rolling `NOTES.md`):
+
+1. **Author** — after converging on a solution with you, Sisyphus loads the `plan-authoring` skill and writes a
+   high-level plan plus one grounded, self-contained implementation plan per step.
+2. **Review** — [Oracle](../oracle/README.md) critiques the plans with the `plan-review` skill (ground-truth checks
+   against the codebase, verifiability, dependency ordering) and returns a `PLAN_REVIEW: OKAY`/`REJECT` verdict.
+   Rejected plans are fixed before any code is written.
+3. **Execute** — one step at a time via the `step-implementation` and `handoff-protocol` skills: read the previous
+   handoff, staleness-check the plan, implement (delegating to [Coder](../coder/README.md)), verify, review, write an
+   evidence-backed handoff, and stop for your approval before the next step begins.

 ## Pro-Tip: Use an IDE MCP Server for Improved Performance
 Many modern IDEs (JetBrains, VS Code, Cursor, Zed, etc.) expose MCP servers that let LLMs use IDE tools directly. Using