What a good description includes
A strong step description specifies:- What to work with — the data, document, or service involved
- What to do with it — extract, classify, summarise, send, write
- What the output should be — format, structure, variable name
| Too vague | Specific |
|---|---|
| Get the contracts | Fetch all contracts uploaded to @GoogleDrive in the last 7 days |
| Summarise it | Summarise each document in one paragraph covering obligations, payment terms, and notice period |
| Send the results | Write results to @GoogleSheets — one row per contract, columns: party names, start date, end date, governing law |
How Felix handles vague descriptions
If your description is missing details Felix needs to build the step, it will ask a follow-up question before generating code. This means you don’t need a perfect description to start. Write what you know — Felix will ask for the rest.Felix asks follow-up questions to close gaps, not to test you. If you’re unsure of a detail, describe what usually happens and Felix will work with that.
Using @mentions in descriptions
Reference connectors directly in your descriptions using @mentions. Felix uses these to generate the correct API calls and authentication.
Referencing previous steps
Each step can reference outputs from earlier steps. Describe what data you need and Felix wires the connection automatically.Describing edge cases
If your process has exceptions or conditions, describe them explicitly.Tips
- Describe the output before the process if you know what you need. Working backwards often produces cleaner steps.
- Use domain language. Felix understands legal, insurance, and finance terminology — use the terms you would use with a colleague.
- Be explicit about filters. “Recent contracts” is vague. “Contracts uploaded in the last 30 days” is not.
- Describe one action per step. If a description contains “and then”, consider splitting it into two steps.
Steps
How steps chain together
Code
How Felix generates code
Chat
Working with follow-up questions

