BrandstaqBrandstaq Docs
Chat Tools

Update Agent Goals

Manage an agent's DAILY STANDING ORDERS — durable patterns of work the agent should do every day or every week.

Skill name: update_agent_goals

When to use it

Brandstaq automatically picks Update Agent Goals when you say things like:

  • Add a goal: grow our Twitter following to 5000
  • Replace the agent's goals with: post 3x weekly, respond to all DMs within 4h

Parameters

NameTypeRequiredDescription
goalstringNoThe standing order text (e.g. 'Reply to ~50 posts/day about automated trading on Twitter', 'Publish 1 thread/week on backtesting'). DAILY STANDING ORDERS, not time-bound OKRs. For 'add': the new standing order. For 'remove': text to match against. For 'edit': the NEW text for the matched goal. For 'replace_all' / 'replace_all_confirmed': comma- or semicolon-separated list of new standing orders.
matchstringNoFor `edit` ONLY: a few words from the EXISTING goal you want to change, used to locate it (must match exactly one goal). The replacement text goes in `goal`.
actionstringYesAction to perform. `add` appends one new standing order. `remove` deletes by partial-match text. `edit` changes ONE existing goal in place: `match` selects which goal (partial-match text), `goal` is the new text. Use `edit` to reword/change a single goal — NOT `replace_all` (which rebuilds everything and will refuse to drop the others). `list` shows current standing orders + do_rules + dont_rules. `replace_all` rebuilds the WHOLE list from `goal` (comma- or semicolon-separated); refuses if it would shrink the list, preserving the user's existing orders. `replace_all_confirmed` bypasses the shrinkage brake — use ONLY when the user explicitly asked to overwrite everything. Aliases: `set`/`replace`→`replace_all`; `change`/`reword`/`rephrase`/`modify`/`revise`→`edit`.
do_rulesstringNoComma-separated list of 'always do' rules to replace existing do_rules. Optional.
agent_namestringNoName of the agent whose goals to manage. If not specified, uses the first active agent.
dont_rulesstringNoComma-separated list of 'never do' rules to replace existing dont_rules. Optional.

When the agent reaches for it

When you change what an agent is working toward — add a goal, replace its goals wholesale, set guardrails — the agent picks this. Goals cascade into the agent's daily planning so changes take effect on the next run.

Related skills