> For the complete documentation index, see [llms.txt](https://cardstock-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cardstock-studio.gitbook.io/docs/test/personas-and-goals.md).
# Personas & Goals
Simulations are played following the same logic. *Personas* identify changes to that logic allowing for multiple types of players to be simulated.
You can create profiles manually, though we suggest you instead write down thoughts about different profiles, and let the AI define them using the "*Export AI Instructions*", and then "*Import*" the response.
## Setting Values
Once personas are created, you can modify their values.
{% hint style="info" %}
**These are robots. They do not act like humans.**
You may find that in simulations, some personas always win or always lose.
:warning: If you find this to be the case, it may be that your game has balance issues, or that the persona is not acting rationally (because it's a robot). You may wish to change settings and re-simulate to see which setting is causing the change in results, and then decide if the issue is with the game, or with the simulation logic itself.
If it is with the simulation, you may wish to go back to the [Build Playtest Game](/docs/test/build-playtest-game.md) to refine the game logic.
{% endhint %}
## Adding or Refining Variables
The first Persona setup step will create variables that can be tweaked. If you'd like to refine those or add more, use the "*Advanced — Search-bot personas (objectives)*" option — describe your changes, and let the AI provide the update code.
## Setting Goals
Players will need goals. In the "*Advanced — search-bot goals*" section, you can add goals personas should approach (often things that lead to points), and goals they should avoid (often things humans would also seek to avoid).
If the goal is one that leads to a win, toggle on the "Win goal", which sets the weight for all personas to the full amount, otherwise some may choose to ignore the goal — something humans generally will not do.
{% hint style="info" %}
The "Avoid" goals are populated by the metrics your game is watching. If you need a specific goal to avoid, you can go back and add it as a new metric in the [Measurements](/docs/test/measurements.md) step.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://cardstock-studio.gitbook.io/docs/test/personas-and-goals.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
