git:20260629.fe782dc to git:20260630.16fdb2b

---

name: tlamatini-flow-from-objective

description: Turn a one-sentence objective into a downloadable .flw workflow that wires the right Tlamatini visual agents and connections.

metadata:

openclaw:

emoji: "🌊"

tlamatini:

runtime: in-process

requires_tools: ["execute_command", "chat_agent_file_creator"]

requires_mcps: []

budget:

max_iterations: 12

max_seconds: 180

max_tokens: 30000

permissions:

filesystem:

read: ["Tlamatini/agent/agents/**/*"]

write: ["Tlamatini/**/*.flw"]

shell: []

network: deny

db: deny

inputs:

- { name: objective, type: string, required: true,

description: "One-sentence high-level goal" }

- { name: out_path, type: string, required: true,

description: "Where to write the .flw file. With no user-given folder, default it under the Tlamatini Templates directory (TLAMATINI_TEMPLATES) — never C:\\Temp / %TEMP%." }

outputs:

- { name: flw_path, type: string, required: true }

- { name: agent_count, type: integer, required: true }

- { name: connection_count, type: integer, required: true }

triggers:

keywords: ["flow from","make a flow","build a flow","scaffold flow",".flw"]

---

<!--

═══════════════════════════════════════════════════════════════════

✦ T L A M A T I N I ✦ — "one who knows"

Created by Angela López Mendoza · @angelahack1

Developer · Architect · Creator of Tlamatini

Tlamatini Author Banner — do not remove (Angela's name is kept in every build)

═══════════════════════════════════════════════════════════════════

-->

# Flow from objective

Produce a canvas-loadable `.flw` for the user's stated objective.

> **Superseded by the `flow-making` skill.** Prefer `flow-making`: it drives the

> validated, schemaVersion-2 `.flw`. This skill is kept as an alias/entry point —

> do NOT hand-author the `.flw` JSON, because you do not carry the agent catalog

> in context and a hand-written flow hallucinates agent types and will not load.

## Procedure (delegate)

1. Invoke the `flow-making` skill with the same inputs:

`invoke_skill('flow-making', { "objective": "${input.objective}", "out_path": "${input.out_path}" })`.

2. Return its result verbatim: `{ flw_path, agent_count, connection_count }`.

## If you must run it directly

Use the shipped driver — it copies the FlowCreator template to an isolated dir,

runs it, and writes the `.flw`:

```

python Tlamatini/agent/skills_pkg/flow_making/scripts/make_flow.py \

--objective "${input.objective}" --out "${input.out_path}"

```

The last stdout line is `agent_count=<N> connection_count=<M> flw_path=<path>`.

## Correct `.flw` shape (schemaVersion 2)

If you ever emit `.flw` JSON by hand, it MUST match the loader contract

(`acp-file-io.js::loadDiagram` / `flow_spec.py`) — NOT a `{version, agents,

connections:[{from,to,kind}]}` shape (that is obsolete and will not load):

```json

{

"schemaVersion": 2,

"nodes": [

{"id": "starter-1", "text": "Starter", "left": "50px", "top": "50px",

"agentPurpose": "", "configData": {"target_agents": ["monitor_log_1"]}}

],

"connections": [

{"sourceIndex": 0, "targetIndex": 1, "inputSlot": 0, "outputSlot": 0}

],

"artifacts": {}

}

```

See `agent/skills_pkg/flow_making/references/flw_schema.md` for the full contract.