appgrammar_start

Axiom: II — Context | Category: Execution

Start executing an appgrammar blueprint. Returns the first step, the system prompt, the design system JSON, and all remaining step tokens.

Blueprint mode: Read sys (system prompt) and sys_design (design system JSON) first. The tokens[] array contains all remaining step tokens in order. Plan your execution: step 1 is provided inline, then call appgrammar_next(appgrammar_id, token) for each subsequent token. Total steps = tokens.length + 1.

Response fields:

• step — the first step object with fields: s (step number), t (type), p (file path), desc (description), c (content), ctx (context), reg (file registry)
• nx — token for the next step
• dn — boolean, true when blueprint is complete
• sys — system prompt for the executing agent
• sys_design — design system JSON
• tokens — array of all remaining step tokens

Step types: cf (create file), cmd (run command), rf (replace in file), if (insert before marker), af (append to file), mk (make directory).

Parameters

Parameter	Type	Required	Description
appgrammar_id	string (UUID)	Yes	ID of the appgrammar to start executing.

Example

{
  "method": "tools/call",
  "params": {
    "name": "appgrammar_start",
    "arguments": {
      "appgrammar_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  }
}