What Crucible Alpha is

Crucible Alpha is an early release that came out of a couple weeks of intensive building. It works, it provides real productivity gains, and it represents only the tip of the iceberg of what's possible with structured AI development.

It's a best-effort system. The agents do a good job of following the workflow, creating documents, and managing tasks — but it's not 100% automated. You are an active participant, not a passive observer.

Set your expectations: Think of each agent as a capable but new team member. They'll do good work, but they need direction. You'll sometimes need to remind them to create tasks, update documents, or search the knowledge base. This is by design — Crucible Pro will lock this down with enforced structure and quality gates.

Install

1. Download and unzip
Download Crucible for macOS — unzip and open the folder
2. Open in VS Code
code Crucible-1.0.0
3. Start working
# Claude Code auto-connects via .mcp.json

Requires: VS Code, Claude Code, Node.js 20+

How to work with agents

Crucible gives you specialized AI personas — requirements, design, architecture, implementation, testing, security, DevOps, and more. Each one has a full chat interface through Claude Code and access to specialized MCP tools.

Treat each agent like a person. Ask questions. Give feedback. Push back on decisions you disagree with. The agents work best when you're actively guiding them, not just watching.

The key things you need to do:

Tips for getting the most out of it

Start small. Pick one feature or user story. Walk through the full workflow — requirements, design, implementation, testing — before scaling up. You'll learn the system faster this way.
Use the knowledge base. The more documents and artifacts you create, the smarter the system gets. Prior requirements inform future design. Past architecture decisions guide new implementation. Don't skip the docs.
Be specific with agents. Instead of "build a login page," try "create a requirements doc for user authentication with OAuth support, then create an implementation task." The more structure you give, the better the output.
Check the task board. The VS Code sidebar shows all tasks grouped by status and persona. Use it to track what's in progress, what's blocked, and what's done.
Don't fight the workflow. Requirements before design. Design before implementation. Implementation before testing. The agents work best when you follow the natural SDLC flow.

What to expect

Crucible Alpha will sometimes surprise you with how well it handles complex multi-file development. It will also sometimes forget to update a task or skip a documentation step. That's normal at this stage.

The system is genuinely useful — it was used to build significantly more complex systems on top of itself. But it requires an engaged human operator who understands what good software development looks like.

Crucible Pro is in active development and will address these gaps with enforced process structure, locked-in quality gates, multi-LLM support, and predictable file organization. Alpha is the foundation.

Getting help

Issues and questions: GitHub Issues
Contact: tony@emberagenticlabs.com