by Ido-Levi
Semi-Structured Agentic Framework. Workflows build themselves as agents discover what needs to be done, not what you predicted upfront.
# Add to your Claude Code skills
git clone https://github.com/Ido-Levi/Hephaestus
What if AI workflows could write their own instructions as agents discover what needs to be done?
Quick Start • Documentation • Examples • Join our discord • Hephaestus Dev
</div>https://github.com/user-attachments/assets/7b021611-2c09-494b-9da1-2ce05176dc51
Watch how Hephaestus coordinates multiple AI agents, monitors their trajectories, and builds workflows dynamically
</div>Ready to use Hephaestus as a development tool? We've built Hephaestus Dev - a pre-configured setup with 5 production-ready workflows for software development:
| Workflow | What it does | |----------|--------------| | PRD to Software Builder | Build complete software from a Product Requirements Document | | Bug Fix | Analyze, fix, and verify bugs systematically | | Index Repository | Scan and index a codebase to build knowledge in memory | | Feature Development | Add features to existing codebases following patterns | | Documentation Generation | Generate comprehensive docs for existing codebases |
python run_hephaestus_dev.py --path /path/to/project
I was trying to build a system where AI agents could handle complex software projects. You know the kind: "Build me an authentication system with OAuth, JWT, rate limiting, and comprehensive tests."
Traditional agentic frameworks can branch and loop, but they have a limitation: every branch needs predefined instructions. You must write the task descriptions upfront for every scenario you anticipate.
But what about discoveries you didn't anticipate? When a testing agent finds an optimization opportunity, a security issue, or a better architectural pattern?
Here's what I tried instead: Define logical phase types that are needed to solve problems - like "Plan → Implement → Test" - and let agents create tasks in ANY phase based on what they discover.
Instead of a rigid sequence, I set up phase types:
The key insi...