The RiftSeed method

Ratchet Agentic Engineering

Ratchet Agentic Engineering (RAE) is RiftSeed’s agentic engineering method, for governing AI coding agents with practices taken from safety-critical software, in which the project’s rules are tests that can only tighten and a level chosen at the start sets which decisions need a person’s signature.

Specification 0.11, draft · Version 0.11 · 16 October 2026

Eight steps, two decided by a person

  1. Request: brief or request
  2. Requirement: signed, from level 1
  3. Impact: files and tests affected
  4. Agents: build inside the tests
  5. Gate: ceilings and tests in CI
  6. Verdict: by a person, from level 1
  7. Release: goes to production
  8. Probes: replay production

Three principles

The rules

The titles of the twelve rules, before and after the code. Which ones apply depends on the project’s level. The text of each, with the why, the check and the limit, is in the full specification.

  1. RAE-1 · Requirements with a key and a signature
  2. RAE-2 · Traceability, with commits and tests citing the requirement
  3. RAE-3 · Impact analysis before the change
  4. RAE-4 · Sessions with a briefing and a log
  5. RAE-5 · An automated gate before every release
  6. RAE-6 · Ceilings that can only tighten
  7. RAE-7 · Parts that must agree, bound by a test
  8. RAE-8 · Review by someone who did not write the change
  9. RAE-9 · A person’s verdict on every release
  10. RAE-10 · Probes on the published system
  11. RAE-11 · A guard test for every incident
  12. RAE-12 · Dated notes with the reason, next to the code

The levels

The level is chosen at the start of the project, according to how critical it is, and sets which decisions need a person’s signature and how strict the automated gates are. Each level includes the ones below it. Next to the level chosen there is the level reached, shown with the evidence kept. Numbering and thresholds are being defined. Cockpit does not compute the levels yet, so the self-check is done by hand.

How it is chosen

At every level

  1. Level 0: An automated gate before every release and a guard test for every incident. The only signature is the one on the level.
  2. Level 1: Signed requirements, and a person’s verdict on every release.
  3. Level 2: Traceability, impact analysis before every change and recorded sessions.
  4. Level 3: Ceilings that only tighten, parts bound by tests, review by someone else, probes in production and dated notes.

Comparisons and approach

In depth

Four comparisons with other ways of building software with AI, from vibe coding to manual review, then how a platform is built, from the brief to the app.

  1. Vibe coding or RAE
  2. Code or no-code
  3. Spec tools
  4. Review or gates
  5. Platform with AI
  6. From brief to requirements
  7. Built with the method

01 · Comparison

Vibe coding or RAE

Vibe coding, a term coined by Andrej Karpathy in February 2025, means building software by prompting an agent and accepting the code without reading it, in an open loop where no measure comes back. RAE, RiftSeed’s agentic engineering, puts the same agent inside rules drawn from experience. Every mistake becomes a rule, and rules can only tighten.

AxisVibe codingThe method
How the work goesA request in chat, the agent writes, it is tried by hand and accepted.A requirement with a key, the impact analysis, tests written before the code, the CI gate.
What remains afterwardsThe code and the conversation. A later change can break what worked, and it shows up while using the app.A regression test for every fault and ceilings that can only tighten. The quality reached stays.
Who decides the releaseWhoever wrote the prompt, once the app seems to work.The project’s level. From level 1 a person approves every release with the evidence in front of them, and no agent approves.

For a throwaway prototype or an afternoon’s experiment vibe coding is fine, and faster. The closed loop is for software that has to last and change without breaking.

Read in full: The levels of the method

02 · Comparison

Code or no-code

For anyone weighing how to build an app with AI: what changes between generating it from a prompt on a platform and building it through a controlled process, and when the first route is the better one.

Here «no-code platform» means platforms that generate an app from a prompt, for example Base44. The comparison is about the category, not one product.

Two flows, side by side

Prompt-to-app platform

  1. Idea
  2. Prompt: a chat message
  3. The model generates: interface and backend
  4. App in the platform: preview, hosted there
  5. Publish: on the platform hosting

The method

  1. Request: brief or request
  2. Requirement: signed, from level 1
  3. Impact: files and tests affected
  4. Agents: build inside the tests
  5. Gate: ceilings and tests in CI
  6. Verdict: by a person, from level 1
  7. Release: goes to production
  8. Probes: replay production

Five axes

AxisPrompt-to-app platformThe method
ApproachA prompt describes the app, a model generates interface and backend inside the platform. The complexity stays behind the chat.A control system: the written brief fixes the problem, agents carry out the work, a person acts as controller. Nothing ships before its behaviour is checked. The method adapts a few practices from safety-critical software (numbered requirements, every requirement proven by a test, impact analysis before every change) without their formal guarantees.
Quality over iterationsEach request regenerates parts of the app. Without tests, a change can break logic that used to work, and context from earlier requests can get lost.Every release is a notch that stays, with tests that only tighten, the same test cases run in the client and in the backend, and CI gates that stop the release on any regression.
TraceabilityThe app’s history lives in the chat: which request changed what, and why, is rebuilt by rereading the messages.Cockpit keeps the thread: every request in the words of whoever made it, the signed requirement, the commits and tests that cite it, the verdict on the release. A file can be traced back to the requirement that asked for it.
Stack and ownershipHosting, database and tooling are those of the platform. Code export and limits depend on the provider and the plan.A standard stack: React, TypeScript, Postgres on Supabase with Row-Level Security, Deno edge functions. The code lives in a git repository, readable and portable.
LifecycleEach app starts from its own prompt: what one project learned does not carry over to the next by itself.Each project leaves tested modules (sign-in, telemetry, AI spending cap, security), tests and lessons the next one starts from.

When a no-code platform is the better choice

  • A quick visual mock, to show an idea or try a flow in an afternoon.
  • An internal throwaway tool, needed for a few weeks and then dropped.
  • Nobody available to maintain code: hosting and updates stay with the platform.
  • Standard needs, such as forms, lists or a simple dashboard, that the platform already covers.

What stays the same

  • Both routes use language models to write software.
  • Both start from a description in plain language.
  • In both cases the result depends on how clearly the problem is described.

Read in full: The loop of the method

03 · Comparison

The method next to spec tools

Tools such as Spec Kit and Kiro work on the first half of the loop: they turn a request into a specification, then into a plan and tasks for the agent, before any code is written.

AxisSpec toolsThe method
Where they workBefore the code: request, specification, plan.After the code: tests that only tighten, a guard test for every incident, probes in production and the sign-offs the level asks for.
What remainsA specification that describes what to build.Numbered requirements tied to the tests that prove them and the releases that contain them, in Cockpit.
Who decidesWhoever writes the specification approves it before the agent starts.The level, chosen and signed at the start, sets what a person signs; whoever signs has the evidence in front of them.

They work together: a specification written with one of these tools can be the request the loop starts from, and the method adds what happens next.

Read in full: The full specification

04 · Comparison

Manual review or gates

The most common way to keep an agent in check is to read every pull request it opens. It works as long as the code to read fits in a person’s time.

AxisReview by handThe method
What the person readsEvery changed line.The evidence: which requirements the change touches, which tests passed, which ceilings tightened, which incidents are still open.
What remains afterwardsA comment on the pull request.A test: every mistake found becomes a check that runs on every push.
When it falls shortWhen agents write more code than a person can read with care.Control moves from lines to rules; the person decides on the release.

Reading everything is still the right choice for a small codebase, for a change that touches security and when learning a new codebase.

Read in full: The evidence and the verdict, in Cockpit by RiftSeed

05 · Approach

A platform with AI inside, step by step

For the lab, a platform is cloud software shaped around the work of the people who use it, with AI inside the product and a person on the decisions that matter.

  • Shaped on the work. Screens follow the steps of the people doing the work, in the order they take them. Requirements are written in the words of whoever asks for them and carry a key, so every change to the code traces back to a request.
  • AI inside. AI works inside the screens, with a spending ceiling and a reserve model written into the configuration. It can be switched off, and the work carries on without it. The decisions that matter stay with a person.
  • In the cloud, shared. One installation serves several organisations. The database keeps their data apart row by row, and each one sees only its own. An update reaches all of them at once.
  • Kept with the method. Requirements, tests, probes and verdicts, like every project of the lab. An incident closes only with a regression test that reproduces it, and that test stays.

The shared base

The parts every platform repeats are written once. The lab’s apps already run on them, and their tests hold them in place.

  • Access
  • Notifications
  • Telemetry
  • AI spending ceilings
  • Row-level security
  • Release

Read in full: Platforms

06 · Approach

From brief to requirements

Before any code is written, what is being built has to be clear. A guided AI interview turns an idea or a work process into confirmed requirements.

  1. A guided chat collects the problem, one question at a time.
  2. Each requirement is confirmed before moving on: the brief holds confirmed requirements only.
  3. The brief comes with requirements, a roadmap and the main challenges.

The AI proposes the requirements and rewords them after every correction; they can be added, dropped or split in two, and the decision stays with whoever writes the brief.

When the list is settled, the requirements freeze and stay as approved, copied word for word.

The brief is the document the agent implements against and the one the result is read against. If the behaviour does not add up, the comparison is made against the written brief.

Read in full: The brief generator

07 · Approach

What an app built with the method is like

A standard stack and, around the code, the rules of the method: a gate before every release, ceilings that only go down, probes on the published site, a guard test for every incident.

The stack

  • Interface: React and TypeScript
  • Data: Postgres on Supabase, with row-level security
  • Server: Deno edge functions
  • Code: A git repository, readable and portable

Around the code

  • Gate before release. Release is a push to main: typecheck and tests run first, and the deploy depends on them. A red gate stops everything, and no agent approves a release.
  • Ceilings that only go down. Every measure that must only improve has a ceiling: accessibility warnings, the shapes and text sizes of the interface. The ceiling drops with every fix, and the commit that exceeds it fails.
  • Probes on the published site. Playwright scripts replay real scenarios on the production site, from desktop and phone. They count errors, blank pages and crash screens.
  • A guard test for every incident. A failure that is found becomes an incident, which closes only with the guard test that reproduces it.

Read in full: The rules of the method

The full specification

The rules one by one, with the why, the check and the limit of each; the levels with the self-check; the lineage and the glossary. It is reserved, and it is requested by writing to the lab. Write to the lab