Start
kickoff
Fetch the ticket, explore the codebase, and route to the right skill.
Keeps you from: Jumping straight into code without understanding the scope or prior decisions.
Beislið
/ BAY-sleeth / — Icelandic for 'the harness'
Hold the reins while agents do the work.
A human-centric, extensible framework for collaborating with coding agents.
beislid workflow · skill montage
Why Beislið
Make agents follow your team's delivery process.
Repo-local workflow
.beislid/workflow.md defines your process. Every agent reads the same playbook.
Ticket to reviewed PR
Kickoff fetches context and routes through spec, design, implement, verify, review, ship.
Human approval gates
Checkpoints at the moments that matter. Agents work inside the process, not around it.
Your rules, any agent
Project-specific quality checks and shipping rituals. Not someone else's methodology bolted on.
Lifecycle
Start from an idea, or hand it a ticket.
Beislið routes both through the same checkpoints: shape, design, build, verify, review, ship. Every change follows your team's process, human or bot.
Shape
spec
Turn vague work into a lightweight product spec.
Keeps you from: Building the wrong thing because the first prompt sounded clear enough.
Design
blueprint
Choose and approve the implementation approach before code.
Keeps you from: A coding agent wandering into architecture decisions mid-change.
Plan execution
implement
Break the approved design into file-level tasks with a tracer bullet first.
Keeps you from: Large changes turning into an untracked pile of edits.
Check evidence
verify
Run commands and read the output before claiming success.
Keeps you from: Probably-works summaries without fresh evidence.
Inspect
review
Run a side-effect-free review over a local or supplied diff.
Keeps you from: Obvious findings making it to human review.
Deliver
ship-it
Take ready work through checks, fresh-eyes, push, and PR creation.
Keeps you from: Opening a PR before the branch is ready.
Evidence
show-me
Generate a visual proof deck showing the change works — screenshots, logs, and commands.
Keeps you from: Shipping without durable evidence that the feature actually works.
beislid session · add dark mode
Extensible
Make it yours.
Define your team's delivery process in one file. Quality gates, approval checkpoints, shipping rituals — every agent reads the same playbook, in any repo, on any host.
Workflow
.beislid/workflow.md Scope Per-repo or global
Hosts Claude · Pi · Codex · more
Gates Your rules, not ours
custom quality checks approval checkpoints shipping rituals Get started
Add a workflow to any repo in under a minute.
1
Install Beislið
curl -fsSL https://beislid.dev/install.sh | sh git clone https://github.com/sandsower/beislid.git
cd beislid && ./install.sh 2
Define your workflow
Run /setup in your repo to generate .beislid/workflow.md with your team's gates and rituals.
3
Start working
Run /kickoff [ticket number] or a description and watch it follow your process from spec to PR.