Skip to content

For the complete documentation index, see llms.txt.

Teach conventions with feedback

A convention is a rule your team wants in every suggestion. Examples include a tone, where changelog entries go, or a kind of change you never document. When you teach Promptless a convention, it records the rule in your Agent Knowledge Base. It reads the rule on later tasks, so you don’t repeat the same feedback on every suggestion.

Teach a convention in either of these ways:

  • State it as a standing rule in feedback you give on a suggestion. Use this when a suggestion shows you a rule you hadn’t written down.
  • Write it in the Knowledge Base yourself. Use this for rules you already know, so they apply from the first suggestion.

To choose a feedback method for the suggestion in front of you, see Give feedback on a suggestion.

Promptless records feedback as a convention when it says how Promptless should behave from now on. Feedback that only corrects the current suggestion changes that suggestion and nothing else.

  1. Give feedback through a method that reaches Promptless:

    • Request Changes

    • A dashboard comment, or close feedback, with Send to Promptless checked

    • A comment on the docs PR

    • A reply in the Slack or Microsoft Teams thread

  2. Phrase the rule so it applies beyond this suggestion, with words such as “always”, “never”, “from now on”, or “for all future suggestions”.

Compare a one-off correction with the same feedback written as a standing rule:

One-off correctionStanding rule
”Make the tone of this page more conversational.""Make the tone more conversational, and do that for all future suggestions too."
"Move this changelog entry into its own suggestion.""I always want changelog entries in their own suggestion."
"This dependency bump doesn’t need docs.""Don’t create suggestions for dependency bumps.”

To combine both, fix the current suggestion and state the rule in the same request.

When Promptless records a convention, its notification about the work includes a Recorded: line that links each Knowledge Base file it changed.

To review every recorded convention, open the Agent Knowledge Base. The Recent updates by Promptless list shows each change with its diff and a link to the suggestion that prompted it. See Track what Promptless changed.

If Promptless recorded a rule you didn’t intend, or worded it too broadly, an admin can correct it as the next section describes.

Only organization admins can edit Knowledge Base files.

  1. In the Promptless dashboard, open Settings and select Agent Knowledge Base.

  2. Open the file for the kind of convention you want to add:

    ConventionFile
    Writing style, terminology, and formattingstyle/client_style_guide.md
    Whom Promptless mentions and how it formats notificationsdoc_workflow/notification_preferences.md
    Any other rule Promptless must follow on every taskPROMPTLESS.md
  3. Add the convention as a plain-language rule.

  4. Select Save.

Promptless reads the file on later tasks. For how each file shapes Promptless’s work, see Know the files that shape every task.