Quickstart

This guide walks you from a fresh Humfrid account to a fully running project — with agents planning, researching, and executing work for your review.

Your time: about 15–30 minutes for account, connections, and setting the objective. The rest is agent work you can leave running and come back to.

What you'll have at the end: A connected workspace with your first objective set, your first experiment planned by the Planner - Maia, researched by the Analyst - Altair, and with the Coder - Sirius ready to implement it — all in a live strategy tree you can track in real time.

Step 1 — Create your account (5 min)

Go to app.humfrid.com and create a free account. You'll land in your workspace with an empty strategy tree.

Step 2 — Connect your stack (15 min)

Go to Settings → Connections and connect the tools your team uses. The faster you connect, the more context agents have to work with.

Recommended connections in order of impact:

  1. GitHub — enables the Coder - Sirius and Reviewer - Vega. Install the GitHub App and select your repositories. This is the most high-value connection if you ship code.
  2. Slack — agents can post summaries, alert you to blockers, and read channel history for context.
  3. Google Analytics or Stripe — connects your outcome metrics to your key results so agents can measure impact automatically.
You can start with no connections and add them as you go. The agents degrade gracefully — the Coder - Sirius just won't open PRs until GitHub is connected.

Step 3 — Set your first objective (10 min)

In the Plans page, click + Add objective. Write what your team needs to achieve this quarter in one sentence. Then add a key result: the specific, measurable outcome that would tell you the objective is met.

Example:

Don't overthink it. You'll refine the tree as you work. The important thing is having an anchor for the agents to work against.

Step 4 — Create your first solution (5 min)

Under your key result, add a solution — the initiative you think will move the metric. Keep it broad: "Improve onboarding flow" or "Launch referral program."

Step 5 — Assign the Planner (20 min, mostly waiting)

Assign your solution to the Planner - Maia. It will read your strategy context, decompose the solution into epics and tasks with acceptance criteria, and post a summary of its reasoning.

While it works, you'll see tasks appearing in real time in the Plans page. When it's done, review the plan: accept what fits, delete what doesn't, and adjust any acceptance criteria.

Step 6 — Assign the Researcher (20 min, mostly waiting)

Pick the most important research question in your plan — typically the first epic. Assign it to the Analyst - Altair with a clear brief.

The Analyst - Altair will search your knowledge graph, query the web, and save its findings as LEARNING atoms in your Wisdom tree. Every future agent automatically benefits from these.

Step 7 — Assign the Coder - Sirius to one task (30 min, mostly waiting)

Pick the first implementation task from your plan — something concrete with clear acceptance criteria. Assign it to the Coder - Sirius.

The Coder - Sirius will spin up a container, clone your repository, implement the task, and open a pull request. You'll get a summary comment when it's done. Review the PR — if Reviewer - Vega is connected, it will have already reviewed it automatically.

Step 8 — Merge and measure (15 min)

Review and merge the pull request. Connect Google Analytics or Stripe if you haven't already so Humfrid can track the impact on your key result automatically.

You've just completed your first Humfrid cycle: objective → plan → research → implement → measure. The LEARNING atoms saved during research compound into every future project — each one starts smarter than the last.

What's next