Documentation
Documentation
Helen’s Foundry keeps what you’re building connected to why you’re building it — one linked graph from mission to merged PR, with drift surfaced the moment work diverges from intent. These guides cover the concepts, getting set up, and connecting your agents.
Start here
Set up your workspace
Create a workspace and build your foundation with Helen: your mission, a goal, and the work under it.
Connect an agent
Give Claude, Cursor, or another MCP client access to your workspace, so it reads the context chain before it writes code.
Connect a repository
Connect GitHub, connect a repository, and get checks on your pull requests. Includes the steps for a personal repository.
Get started
Concepts and guides
Artifact types
The fields, hierarchy, tier, and lifecycle states for every artifact in the graph.
Authoring artifacts
Create and link artifacts, use lifecycle states and closure reasons, and assign clear ownership.
Agent-ready tickets
Write bounded, testable acceptance criteria an agent can implement and verify without guessing.
Pull request checks
What Helen posts on a pull request, why nothing appears when a repository is not connected, and why an unlinked pull request fails rather than goes quiet.
Insights glossary
The signals and metrics Helen surfaces in Insights — what each one measures and how to read it.
Reference
Check reference
Every finding Helen’s Foundry can raise in Reconcile: what it means, and what to do about it.
MCP tool reference
Inspect every tool exposed by the live MCP registry, including its purpose, parameters, and required fields.
Error reference
The error codes the API and MCP server can return, what each one means, and how to recover.