A skill that produces high-quality design documents through iterative refinement. Supports both Claude Code and Codex.
The boulder rolls back. That's the point.
Sisyphus wasn't punished for failing — he was punished for trying. Camus said imagine him happy. We say imagine him useful: each push leaves the boulder a little higher than before.
This plugin drafts a design and hands it to a reviewer who has never seen it and never will again. The reviewer finds what the author couldn't. The author fixes it. A new reviewer — equally blind, equally merciless — checks the fix. The boulder rolls back. It goes up again.
Your time enters where machines can't substitute. Everything else is the hill.
/sisyphus-design <requirement> runs a multi-phase process:
- Research & Diverge — investigates the codebase and domain, thinks from first principles, generates 2-3 fundamentally different approaches
- Interrogate — presents the critical path, approaches, and questions that reveal which approach fits your constraints
- Decisions — presents key decisions for approval with trade-offs and a concrete example trace
- Draft & Refine — drafts the design, then runs independent evaluators until the design stabilizes
- Review — you read and comment on the design file
- Refine & Deliver — addresses your comments through the same process, delivers the final design
Three human touchpoints. Everything else is automated.
/plugin marketplace add arkbriar/sisyphus-design
/plugin install sisyphus-design
Copy the skill into your Codex skills directory:
cp -r codex ~/.codex/skills/sisyphus-designEnable the request_user_input tool so the skill can pause for your input during human phases:
codex features enable default_mode_request_user_input/sisyphus-design Distributed task queue with at-least-once delivery, backed by PostgreSQL, implemented in Rust
In Codex, invoke with $sisyphus-design or let it trigger automatically from the description.
The design is written to design/ in your project (e.g., design/distributed-task-queue.md).
- DistributedTaskQueue — designed and implemented end-to-end with this skill
The methodology here is a harness at the meta level — the iterative loop of draft, evaluate, fix is not specific to software design. The checklist (skills/design/checklist.md) can be extracted and applied to any structured document where consistency, coverage, and minimality matter.
MIT