git:20260916.cef3995 to git:20260920.22628c0

---

name: tlamatini-new-acp-agent

description: Scaffold a new Tlamatini visual agent end-to-end across the 8 places the agent contract requires (script + config.yaml, view + url, migration, CSS gradient, 4 JS files, agentic_skill.md, README.md, lint).

metadata:

openclaw:

emoji: "🧱"

tlamatini:

runtime: in-process

requires_tools: ["chat_agent_file_creator","chat_agent_executer","chat_agent_pythonxer"]

requires_mcps: ["Files-Search"]

budget:

max_iterations: 30

max_seconds: 600

max_tokens: 80000

permissions:

filesystem:

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

write:

- "Tlamatini/agent/agents/${input.agent_name}/**/*"

- "Tlamatini/agent/views.py"

- "Tlamatini/agent/urls.py"

- "Tlamatini/agent/static/agent/css/agentic_control_panel.css"

- "Tlamatini/agent/static/agent/js/acp-*.js"

- "Tlamatini/agent/migrations/*.py"

- "Tlamatini/agent/agents/flowcreator/agentic_skill.md"

- "README.md"

shell:

- "python -m ruff check Tlamatini/agent"

- "npm run lint"

network: deny

db: ["read", "write-via-migrations-only"]

inputs:

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

description: "snake_case folder name; display name derived as title-case" }

- { name: category, type: enum,

values: ["control","routing","gates","action","crypto","utility","terminal"],

required: true }

- { name: gradient, type: string, required: false,

description: "4 hex colors comma-separated (#aabbcc,...)" }

outputs:

- { name: files_changed, type: array, required: true }

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

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

triggers:

keywords: ["new agent","add agent","scaffold agent","create acp agent"]

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

---

<!--

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

✦ 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)

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

-->

# New ACP agent

Read `Tlamatini/.agents/workflows/create_new_agent.md` first. It is the

ground truth for the 8-step contract. This skill drives that procedure

end-to-end.

## Steps

1. Validate `agent_name` is snake_case ASCII; reject collisions with

existing agents in `Tlamatini/agent/agents/`.

2. Copy `shoter.py` boilerplate into the new directory; rename references.

**Temp/Templates policy (2026-06-02):** if the agent creates temp files, add

the module-top `if (os.environ.get('TLAMATINI_TEMP') or '').strip(): …

tempfile.tempdir = …` guard (verbatim from `executer.py` — an `if`-block, not

a `def`, so ruff E402 stays clean); if it scaffolds a project/template dir

(firmware/engine style), default the parent to `<app>/Templates`

(`TLAMATINI_TEMPLATES`). See `prompt.pmt` Rules 15/16 + `agent/path_guard.py`.

3. Add a Django view + URL pair for the connection-update endpoint.

4. Create the migration that seeds an `Agent` row with the display name.

5. Add the CSS gradient block in `agentic_control_panel.css` and the

hover variant.

6. Update the four JS files: connector, classMap (6 locations), undo/redo,

.flw load.

7. Update `agentic_skill.md` and `README.md` (agent count, table,

classification, glossary, changelog, API table).

8. Run `python -m ruff check` and `npm run lint`. Stop on any error and

report.

## Output

Return:

```json

{

"files_changed": ["..."],

"migration_id": "00NN_add_<agent_name>",

"lint_summary": "ruff: 0 errors; eslint: 0 errors"

}

```

## Current installed-agent contract — 2026-09-15

Use `agent/agents/flowcreator/flow_catalog.json` for canonical names, current config schemas, output/input slots, lifecycle flags and structured fields for all 89 installed types. GUI-Manager is design only. After changing a template/contract/reference, run `python scripts/update_flow_catalog.py` and its `--check` mode in the repository. Deployment refreshes runtime snapshots.

FlowCreator selects capabilities before detailed design, validates the generated plan, and uses bounded repair. Declare Ender input connections explicitly; Ender `target_agents` is a kill list. Counter uses L/G slots; source dependencies do not choose a conditional output branch. Generated Parametrizers require valid `_parametrizer_mappings`, one source and one target. Do not maintain a separate hardcoded Parametrizer producer list.

For desktop flows, use explicit physical/screenshot geometry and verified target windows. `input_sent` is input delivery only; errors may be partial and must not be blindly replayed. Read `docs/desktop-input-and-flow-contracts.md` and `docs/agent-coverage.md` for the full contract and verification scope.