Documentation
of Forma.

How a person’s intent moves through the five nodes of the protocol — from interview and brief to a verified result on the board.

Sections:Project analyticsProject structureProject protocolProject resources

Protocol sections

Everything you need,
to start a cycle.

Nine sections — by kind of engine goal. Each one has short articles on who forms the goal, which route it takes and who confirms it.

Project analyticsProject analytics in the Forma protocol: what production costs — tokens, cache-read, passes and the price of a cycle, and how it changes over time.1 articleProject structureForma project structure: items, order of work and the road map, plus documentation for people — user, administrator and technical.1 articleProject protocolForma project protocol: the engine every task runs through — five nodes, kitting, execution, check and return, and the route machine.1 articleProject resourcesForma project resources: references, assets, images, ideas and prompts — everything needed to carry out a project. What counts as a resource and how to gather it.1 articleForm BalanceForm Balance: the system's equilibrium, nodes as partners, errors and Core's remarks when a cycle of work closes. How to keep the balance of forces.1 articleDiscussion of affairsDiscussion of affairs in Forma: incoming tasks, interviews, reviews and problem solving. How goals and production tasks are formed from communication.1 articleProduction channelsForma production channels: where the product is made — launch and delivery, the main goal and subgoals, roles and runners.1 articleCompetence segmentsForma competence segments: the store of experience and roles from which a project template is built. How experience turns into roles and why that cuts costs.1 articleGoal achievementGoal achievement: the result image and the check at the end. What the project aims for, how the goal of each section is set and how to check that it was reached.1 articleProject TemplatesReady-made setups for a specific kind of work: what a project template is, what it brings to the project, and how to install it.1 articleAI ModelsWhich models work in the project, how a model is chosen for a task, and how its cost is accounted for.1 articlePlugin Setup and DevelopmentHow to install the Forma plugin in a project and how to add your own functionality to it.1 article

Quick start

Three steps
to the first cycle.

  1. Describe the result imageIntent runs the interview and records the brief verbatim.
  2. Set the thresholdsAttempts and cycle volume — as numbers, before the start.
  3. Start the cycleCards, kit, execution and the Core verdict.

Frequently asked questions

What is Forma?

An open protocol for working with AI agents: rules, roles of the five nodes (Intent, Spec, Kit, Run, Core), skills and a card board, a set of files in your repository.

Which engines does the protocol work with?

Claude Code, Codex and Gemini. The rules are common to all engines; the particulars of each are described in its own file.

How much does it cost?

The Protocol is free. You pay only for the models the nodes run on.

Where to start?

Describe the Result Image — Intent will run the interview and record the brief verbatim. Then set the thresholds: attempts and cycle volume — as numbers, before the start. After that, launch the cycle.

Who confirms that the work is done?

Never the executor itself: the work is confirmed by the receiving node. An external result is accepted by the human, and the verdict on the cycle is issued by Core.

New articles

Plugin Setup and DevelopmentInstalling the plugin and building your own functionality→AI ModelsAI Models: overview→Project TemplatesWhat a project template is→Goal achievementGoal achievement: checking against the image→Competence segmentsCompetence segments: roles as experience→Production channelsProduction channels: where the product is made→

Ask in the community

No discussions yet — start the first one: protocol questions, cycle reviews, findings.

Ask a question↗