Files

centdix af200de3c4 feat(ai): standardize and improve system prompts (#7346 )

* init

* test in frontend

* copy files

* use in cli

* better

* add desc to sdks

* better

* fix ts parsing

* add docs to ts client

* add docs to python client

* use script prompt in frontend

* regen

* use in flow

* rm

* use in cli, create AGENTS.md instead of cursor rules

* remove apply

* better

* better

* simplify cli

* more docs

* cleaning

* update readme

* generate cli file

* better folder names

* fix ts

* fix multiline

2025-12-12 17:26:19 +00:00

1.9 KiB

Raw Blame History

System Prompts

This directory contains the single source of truth for AI system prompts used by both the frontend copilot and CLI guidance.

Structure

system_prompts/
├── base/              # Core instruction templates (manually written)
├── languages/         # Language-specific instructions (manually written)
└── auto-generated/    # Auto-generated files (DO NOT EDIT)
    ├── sdks/          # SDK documentation
    ├── cli/           # CLI command documentation
    ├── prompts.ts     # TypeScript exports
    └── index.ts       # Helper functions

Usage

Regenerating Prompts

When SDK methods or the OpenFlow schema change, run:

python system_prompts/generate.py

This will:

Parse TypeScript and Python SDK files to extract function signatures
Parse the OpenFlow YAML schema
Parse the CLI commands
Assemble complete prompts from markdown files
Generate TypeScript exports in auto-generated/

Scope

These system prompts contain ONLY:

How to write Windmill scripts (language syntax, conventions, SDK usage)
How to structure Windmill flows (OpenFlow schema, module types, data flow)
Resource type handling, S3 operations

They DO NOT contain:

Tool usage instructions (edit_code, set_flow_json, etc.)
IDE/editor specific commands
Testing tool invocations

Tool instructions are added separately by the frontend and CLI.

Integration

Frontend

Uses Vite path alias $system_prompts pointing to auto-generated/:

import { FLOW_GUIDANCE } from "$system_prompts/flow";
import { getLangContext } from "$system_prompts/languages";

CLI

Copies the relevant prompts in /cli/src/guidance/prompts.ts


## Editing Guidelines

- Edit markdown files in `base/`, `languages/`
- Never edit files in `auto-generated/` directly
- After editing, run `generate.py` to update exports

1.9 KiB Raw Blame History