> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amadora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand details

Brand Details consist of four core documents under **Settings → Brand details** that provide Amadora’s AI agents with your company's canonical facts, proof points, voice rules, and page structures.

Every landing page and blog draft generated in Actions references these documents.

<img src="https://mintcdn.com/amadoraai/I0tPWIJGmZ0cF4Bl/images/Brand_details_settings-1.png?fit=max&auto=format&n=I0tPWIJGmZ0cF4Bl&q=85&s=8d8c44c267d3785a7cc3435872815c79" alt="Brand Details Settings 1" width="2302" height="1424" data-path="images/Brand_details_settings-1.png" />

## Overview of Brand Documents

| Document              | Core Focus                                                                                 | Length / Limit                         |
| --------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------- |
| Company Details       | Canonical facts: products, audience, exact pricing, policies, and naming rules.            | 900-word ceiling (400–700 target)      |
| Evidence Database     | Proprietary proof points: data findings, client outcomes, methods, and arguable positions. | 15 core · 35 supporting · 10 positions |
| Writing Style & Voice | Tone rules: sentence rhythm, vocabulary, punctuation habits, and verbatim examples.        | 250–800 words                          |
| Page Style            | Structural benchmarks: section counts, word budgets, and block-to-prose ratios.            | Measured from live site                |

## Document Breakdown

### Company Details

Contains canonical facts including target personas, exact offer pricing, operational policies, credentials, and naming rules. Researched automatically from your website, documentation subdomains, and relevant review platforms.

<img src="https://mintcdn.com/amadoraai/I0tPWIJGmZ0cF4Bl/images/Company_details-1.png?fit=max&auto=format&n=I0tPWIJGmZ0cF4Bl&q=85&s=437ff36616d0574e443df11242edcd23" alt="Company Details 1" width="2300" height="1542" data-path="images/Company_details-1.png" />

* **What to exclude:** Marketing slogans, unverified claims, or placeholder text for unconfirmed facts.

### Evidence Database

Holds proprietary proof points, proprietary data, case outcomes, and arguable industry positions you are willing to defend publicly.

<img src="https://mintcdn.com/amadoraai/I0tPWIJGmZ0cF4Bl/images/evidence-database-1.png?fit=max&auto=format&n=I0tPWIJGmZ0cF4Bl&q=85&s=06ba9ff0e63fdd45d75a91d925e4fa37" alt="Evidence Database 1" width="1990" height="1366" data-path="images/evidence-database-1.png" />

* **Requirements:** At least 30% of entries must be data- or case-driven. Public sources retain links, while internal sources remain unlinked.
* **What to exclude:** Confidential numbers, internal feedback, or unreleased data under NDA.

### Writing Style & Voice

Defines sentence rhythm, emotional tone, permitted vocabulary, and style habits using exact excerpts from your existing content.

<img src="https://mintcdn.com/amadoraai/VEZKc6seBzRoZL5M/images/writing-style-&-voice-1.png?fit=max&auto=format&n=VEZKc6seBzRoZL5M&q=85&s=1755fe2953274a4f93916944979adb20" alt="Writing Style & Voice 1" width="1990" height="1366" data-path="images/writing-style-&-voice-1.png" />

* **What to exclude:** Facts, pricing, founding dates, or team statistics. Keeping factual data inside Company Details ensures voice rules remain evergreen.

### **Page Style**

Measures the physical layout of your live homepage and key marketing pages to establish structural copy budgets.

<img src="https://mintcdn.com/amadoraai/VEZKc6seBzRoZL5M/images/page-style-1.png?fit=max&auto=format&n=VEZKc6seBzRoZL5M&q=85&s=cb50d908404aba2f189e506ebdd18fc0" alt="Page Style 1" width="1990" height="1424" data-path="images/page-style-1.png" />

* **What to exclude:** Strategic aspirations. Page Style reflects your current live site structure only.

## Generating & Updating Documents

Click **Generate instruction** (50 credits per document) on any card to have the agent research your site and generate an initial document.

You can refine any document using plain-language instructions (e.g., *"Our starter plan is €490/mo, not €390. Use pricing from /pricing"*).

## Conflict Resolution Hierarchy

When source data or instructions conflict, the agent resolves them using the following priority:

| Priority | Conflict Scenario                                 | Winning Rule                                       |
| -------- | ------------------------------------------------- | -------------------------------------------------- |
| 1        | Pasted text vs. Website data                      | Manually pasted content takes precedence.          |
| 2        | Older fact vs. Newer fact                         | The most recent source date takes precedence.      |
| 3        | Self-claimed rating vs. Review platform           | Independent review platform data takes precedence. |
| 4        | Custom instruction vs. Default agent method       | User instruction takes precedence.                 |
| 5        | Page Style voice sample vs. Writing Style & Voice | Writing Style & Voice document takes precedence.   |

## Workflow Dependencies

| Workflow            | Company Details | Evidence Database | Writing Style & Voice | Page Style |
| ------------------- | --------------- | ----------------- | --------------------- | ---------- |
| Landing page drafts | Required        | Required          | Required              | Required   |
| Blog drafts         | Required        | Required          | Required              | —          |
| Content briefs      | Required        | —                 | —                     | —          |
| Site Structure      | —               | —                 | —                     | —          |
| Content plan        | —               | —                 | —                     | —          |

## FAQs

<AccordionGroup>
  <Accordion title="Do I need all four documents before using Actions?">
    No. **Site Structure** and **Content Plan** run without them. However, landing page and blog drafts require complete Brand Details to generate accurate, non-generic copy.
  </Accordion>

  <Accordion title="Are Brand Details shared across all projects in an account?">
    No. Brand Details are isolated per project to protect client context.
  </Accordion>

  <Accordion title="Should I regenerate a document if a single fact is wrong?">
    No. Edit the document directly using plain-language instructions. Only regenerate when major portions of your business or site architecture change.
  </Accordion>

  <Accordion title="How often should I update these documents?">
    Update **Company Details** whenever pricing or policies change, **Evidence Database** as new case studies/data emerge, and **Voice** or **Page Style** only during major rebrands.
  </Accordion>
</AccordionGroup>
