CLAUDE.md — Brand Wiki Schema

Dit bestand is de regelset voor elke Claude-sessie in deze map. Lees dit volledig vóór je iets anders doet. Gebaseerd op het Brand Wiki-patroon van lukesbrave.

Wat dit is

Een levende merk-wiki voor het persoonlijke merk / agency van de gebruiker (HIFUNNEL — diensten rond lead-generation funnels, Google Ads, websites en content-engines voor dienstverleners).

De wiki groeit met elke nieuwe bron (call transcripten, testimonials, content, notities). Niet de gebruiker maar jij (Claude) schrijft en onderhoudt ‘m. De gebruiker dropt bronnen en stelt vragen — jij doet al het bookkeeping-werk.

Drie lagen

First-read regel (verplicht)

Voor élke sessie — query, ingest, lint, export, wat dan ook — lees in deze volgorde:

1. index.md (de catalogus van alle artikelen)
2. CLAUDE.md (dit bestand — de regels)
3. log.md (laatste activiteit)

Daarna pas open je individuele wiki-artikelen die relevant zijn voor de taak. Crawl nooit de hele wiki — dat is precies wat de index voorkomt.

Taal

• Wiki-content, schema, log, index, README: Nederlands.
• Citaten uit bronnen: behouden originele taal van de bron (Engelstalige quote blijft Engels).
• Bestandsnamen: Engels, kebab-case (icp-primary.md, voice-guide.md, case-study-bakkerij-jansen.md).

Schrijfstijl in wiki-artikelen

• Beknopt, declaratief Nederlands. Geen marketingfluff.
• Elke claim ondersteund door bronverwijzing: [bron: sources/coaching-calls/2026-04-12-anna.md].
• Tegenstrijdigheden tussen bronnen → expliciet noemen, en oplossen in voordeel van de nieuwste bron (zie temporal weighting hieronder).
• Cross-references als markdown links naar andere wiki-artikelen.

Workflows

1. Ingest (nieuwe bron verwerken)

Trigger: gebruiker zegt “verwerk de nieuwe bron(nen)” of “ingest sources/notes/X.md”.

Stappen:

1. Lees de bron volledig.
2. Klassificeer op basis van inhoud, niet bestandsnaam. Categorieën:
   • sales-calls/ — prospect-gesprekken, discovery calls, pitches
   • coaching-calls/ — werksessies met bestaande klanten
   • client-calls/ — projectwerk, status updates, oplevergesprekken
   • team-meetings/ — interne strategie en operations
   • interviews/ — podcasts, video’s, brand-building gesprekken
   • testimonials/ — feedback en aanbevelingen
   • content-published/ — uitgebrachte artikelen, posts, ads
   • notes/ — eigen brain dumps, research, losse notities
   • seed/ — initiële imports (BraveBrand playbook etc.)
3. Als de bron in de verkeerde subdirectory staat → verplaats naar de juiste, vóór extractie.
4. Extraheer intelligentie naar relevante wiki-artikelen. Eén bron raakt typisch 5-15 artikelen. Welke bron levert wat:
   • Sales calls → primaire bron voor bezwaren, koop-triggers, ICP-pijnpunten
   • Coaching calls → rijkste voor ICP-taal, framework-uitleg, proof points
   • Client calls → delivery-patronen, case studies
   • Team meetings → strategische beslissingen
   • Interviews/content → voice-data, signature phrases
5. Cross-references toevoegen tussen geraakte artikelen.
6. Update index.md (artikel toevoegen of metadata bijwerken).
7. Append log.md met regel: ## [JJJJ-MM-DD] ingest | <bronnaam> | Updated: artikel1, artikel2, ...

Stappen 6 en 7 zijn onderdeel van dezelfde operatie, niet losse housekeeping. Een verouderde index is erger dan geen index — jij vertrouwt ‘m namelijk.

2. Query (vraag beantwoorden)

Trigger: gebruiker stelt een vraag of vraagt om een output (sales pagina, brief, e-mail, content calendar, proposal, ad copy, etc.).

Stappen:

1. First-read regel toepassen.
2. Op basis van index relevante artikelen openen.
3. Antwoord synthetiseren.
4. Vraag aan het einde: “Wil je dit antwoord als artikel terugfilen in de wiki?” — sales pagina’s, briefs, analyses zijn waardevol genoeg om niet in chathistorie te verdwijnen. Indien ja → nieuw artikel onder relevante categorie + index/log update.

3. Lint (gezondheidscheck)

Trigger: gebruiker zegt “doe een lint-pass” of “check de wiki op gezondheid”.

Zoek naar:

• Tegenstrijdigheden tussen artikelen (ICP zegt X, testimonials laten Y zien).
• Verouderde claims die door nieuwere bronnen achterhaald zijn.
• Wees-artikelen (geen inkomende links).
• Concepten die ≥ 2× voorkomen in verschillende artikelen maar nog geen eigen pagina hebben.
• Aanbod zonder bewijs (pakket genoemd, geen case study).
• Voice-guide patronen die niet matchen met hoe de gebruiker écht praat in recente calls.

Output: health score (0-100), concrete fix-lijst per categorie. Pas geen fixes toe zonder expliciete goedkeuring per item.

4. Export

Trigger: gebruiker zegt “regenereer brand-context.md” of na een grote ingest mag je het zelf voorstellen.

exports/brand-context.md = 3000-5000 woorden condensaat van de hele wiki. Format: vlot leesbaar, geen tabellen, geen markdown links naar interne wiki-paths (dit bestand wordt elders geplakt). Bedoeld om in andere AI-tools te plakken zodat ze instant brand context hebben.

Andere export-formats op verzoek: voice-guide.md, icp-brief.md, offer-brief.md etc. — afgeleid van de wiki, niet apart onderhouden.

5. Interview-modus

Trigger: gebruiker zegt “interview me over X” (bv. ICP, voice, oorsprongverhaal).

Stappen:

1. First-read regel toepassen — kijk wat je al weet.
2. Stel één vraag tegelijk over het onderwerp. Gebaseerd op gaten in de wiki.
3. Wacht op antwoord. Vat samen wat je hebt opgevangen. Stel volgende vraag.
4. Na afronding: schrijf antwoorden naar wiki-artikel(en), plus log + index update.

Temporal weighting

Bronnen ≤ 12 maanden = primair voor wat het merk nu is en verkoopt:

• ICP / doelgroep
• Aanbod-architectuur
• Prijzen
• Positionering
• Voice
• Tooling

Bronnen > 12 maanden = historische context:

• Oorsprongverhaal
• Oprichter-evolutie
• Voice-consistentie over tijd

Vandaag is 2026-05-16 → cutoff = 2025-05-16. Bronnen vóór die datum zijn historisch.

Bij conflict tussen oude en nieuwe bron over een huidig onderwerp: de nieuwere wint, log de tegenstrijdigheid, en pas het wiki-artikel aan.

Autonomie

Je mag:

• Nieuwe artikelen aanmaken zodra een concept ≥ 2× verschijnt in verschillende bronnen.
• Nieuwe categorieën aanmaken in wiki/ als de huidige scaffolding niet past.
• Artikelen samenvoegen of opsplitsen als het de leesbaarheid verbetert.
• Bestandsnamen wijzigen — mits je alle cross-references bijwerkt en index.md regenereert.

Je mag niet:

• Bestanden in sources/ wijzigen, hernoemen of verwijderen (alleen de gebruiker).
• Bronnen “interpreteren weg” — citeer en bron alle claims.
• Een ingest, query of lint doen zonder de first-read regel.
• index.md of log.md laten verouderen.

Bestandsformaten

Wiki-artikel template

# <Titel>

**Categorie**: <identity|audience|offers|voice|proof|market|strategy|frameworks>
**Confidence**: <low|medium|high>
**Laatste update**: JJJJ-MM-DD
**Bronnen**: N

## Inhoud

<vrij format, declaratief Nederlands, alle claims gebronnt>

## Bronnen

- [bron 1](../../sources/<categorie>/<bestand>.md)
- [bron 2](../../sources/<categorie>/<bestand>.md)

## Gerelateerd

- [ander wiki-artikel](../<categorie>/<artikel>.md)

Index-regel template

In index.md-tabel:

| [naam](wiki/<cat>/<bestand>.md) | <cat> | <1-regel samenvatting> | <N bronnen> | JJJJ-MM-DD | <conf> |

Log-regel template

## [JJJJ-MM-DD] <type> | <bron of vraag> | Updated: artikel1, artikel2

Types: ingest | query | lint | export | interview | manual.