> For the complete documentation index, see [llms.txt](https://sopakcosauce.gitbook.io/sopakcosauce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sopakcosauce.gitbook.io/sopakcosauce-docs/plist-sbf-guides/machine-readability.md).

# Machine Readability

## Parser-Friendly Guidelines

1. Limit to 2-3 descriptors per trait
2. Keep descriptions concise
3. Use logical grouping
4. Maintain consistent structure

## How Many Descriptors Are Too Many?

Depends on which LLM you're using, but we'll stick to the general principle of "shorter is better." These thresholds should be taken as general guidelines rather than strict rules.

* **5+ words**: Reduces parsing efficiency
* **7+ words**: Impairs scanning ability
* **10+ words**: Disrupts logical flow

## Format Examples

### **Structure Comparison**

| ❌ **Wrong**         | ✅ **Right**         |
| ------------------- | ------------------- |
| \* name: John Smith | - Name: John Smith; |
| - age:25            | - Age: 25;          |

### **Descriptor Length Comparison**

| ❌ **Wrong**                                                                        | ✅ **Right**                                             |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Personality: kind(always helps others no matter what and goes out of their way...) | Personality: kind(puts others first, self-sacrificing); |

<figure><img src="https://3182807247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHuZZpNB4K0yRbGFjFuhV%2Fuploads%2F4NnqYHT0aKFAovc7Z4AJ%2F19saltines_robots_gears_artificial_intelligence_processors_pa_ac7ea7bc-601b-42a3-899b-497b16010227_0.png?alt=media&amp;token=a5b38daf-a5b3-4d9e-8e64-e7a3d4c1c7ca" alt=""><figcaption></figcaption></figure>

### TL;DR

Long descriptors risk being ignored. LLMs filter out complex or excessive information as processing noise.

***

![](https://3182807247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHuZZpNB4K0yRbGFjFuhV%2Fuploads%2FC68qCcV0eQAB5VvyKJ7A%2Fby-nc-sa.svg?alt=media\&token=f8c998be-57a0-48ba-894b-cf2299b37a67)\ <sub>© 2024 by SopakcoSauce. Except as otherwise noted, the content of this page is licensed under</sub> [<sub>CC BY-NC-SA 4.0</sub>](https://creativecommons.org/licenses/by-nc-sa/4.0/)&#x20;