# style

Part of [pi-suite](../../README.md). Turn it off with `/suite off style`.

One way of answering for every model: short, outcome first, and formatted for what Pi's terminal can draw.

## What it adds

A `response_style` section in the system prompt, the same on every turn so it stays cached. It's about 400 tokens. The text is in [`src/prompt.ts`](src/prompt.ts).

- **Outcome first:** the answer, what changed or what's needed, in one to three lines, with detail under it.
- **No padding:** no restating the request, narrating steps or closing recap. Short question, short answer.
- **Honest reports:** what failed, what was skipped, what wasn't checked.
- **Formatting for scanning:** headings only for replies with several parts, tables to compare, `path:line` for code.
- **What the terminal draws:** Markdown with tables and highlighted code, simple math as Unicode, and Mermaid diagrams for the five types Pi draws, kept narrow enough to fit. Other diagram types, HTML and images don't render, so it avoids them.

With [`artifact`](../artifact/README.md) on, longer write-ups go to a page when you ask for one.

## If you have your own

Pi's `~/.pi/agent/APPEND_SYSTEM.md` and `AGENTS.md` still apply, but this section comes after them in the prompt, so where they disagree the model tends to follow this one. If they hold the same kind of rules, remove those, or turn this off, so the model doesn't get both.