How-to guides
Short, step-by-step guides for the things you do most: installing the Foundry, letting it build your GitHub issues, approving plans, writing flows and keeping it all safe.
Get started
- How to install Spaghetti Code Foundry on your MacInstall Spaghetti Code Foundry from source on macOS, link the scf command, start the web UI and create the first admin account.
- How to run your first flow by handCreate a small flow, run it on a local git repository in its own worktree, then check the steps and the diff in the web UI.
- How to let the Foundry build your GitHub issuesAdd an issues watcher with the issue-gitflow flow and the Factory_go label, so labelled issues are planned, coded, tested and merged into develop.
- How to add a repository and choose its sign-inAdd a repository under My repositories, pick a token, deploy key or GitHub App for the Foundry to sign in with, and test the connection.
- How to keep the Foundry running as a login serviceInstall the Foundry as a macOS login service so watchers keep running after a restart, and learn how restarts and self-update work.
- How to use the Foundry from the command lineSign in with scf login, list runs and what waits for you, script with --json, and make any server call with scf api from your terminal.
- How to upgrade from claude-factoryMove an existing claude-factory install to Spaghetti Code Foundry: new remote, new scf command, new data folder and a refreshed login service.
Daily work
- How to answer questions and approve risky plansAnswer the Foundry's questions and decide on risky plans and splits, from Home or on the GitHub issue, so your stories keep moving.
- How to resume, retry or approve a stopped runFind out why a run stopped or failed, fix the cause, then resume it at the failed step, retry it with a hint, or approve it to go on.
- How to hand the Foundry a whole epicLabel a batch of stories at once, set the build order with Depends on, and let the Foundry split stories that are too big into smaller ones.
- How to turn an idea into ready storiesUse a Refinement session and the architect to grow a rough idea or an existing issue into stories that meet the Definition of Ready.
- How to work with gitflow and the daily releaseSet up develop, feature branches and the daily release pull request to main, and know what happens to bug fixes when hotfixes are on.
- How to follow your work on Home and the boardRead Home, the board and the health line to see where every story is, who has the next move, and whether the Foundry itself is well.
- How to ask SCF for help in the appSwitch on Ask SCF, ask questions about the Foundry and your own work, check how sure an answer is, and know what the assistant will not do.
Configure and extend
- How to write your own flowCreate a flow from a template, edit it visually or as YAML, reuse library blocks, let any AI write one, and check it with scf validate.
- How to choose models and routing rulesPick Claude Code, Codex or a local model per step, set routing rules and a default model, and add fallbacks for when a model hits a limit.
- How to add skills from an open-source library safelyDeclare a skill source, import a reviewed commit into quarantine, scan, review and check it, then publish and approve a catalogue release.
- How to keep your code and secrets safeUse separate run workspaces, protected branches, the secret scan, approval steps, budgets and sandboxing so runs cannot harm your code.
- How to control costs and read the dashboardSet a daily budget, run and step limits and per-user limits, read spend on the dashboard, and compare models on your own code with evals.
- How to invite users and set rolesAdd accounts, send set-password links, choose admin or user, publish flows for users and let them run work on their own repositories.
- How to fix common problemsFind out why nothing happens to an issue, why a run failed or a push was refused, and fix Codex, local model, budget and sign-in problems.