# Context Brain

> Builds a portable marketing Context Brain, an evidence-grounded set of markdown documents that lets AI systems produce specialized marketing work using the business's real decisions, constraints, voice, assets, and operating rules. Use when the user says "help me build a context brain", "set up an AI marketer", "build context docs for my Claude Project", or asks how to stop their AI marketing out…

- **Type:** Skill
- **Install:** `agentstack add skill-ivanhapaz-marketing-context-brain-marketing-context-brain`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ivanhapaz](https://agentstack.voostack.com/s/ivanhapaz)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ivanhapaz](https://github.com/ivanhapaz)
- **Source:** https://github.com/ivanhapaz/marketing-context-brain

## Install

```sh
agentstack add skill-ivanhapaz-marketing-context-brain-marketing-context-brain
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Context Brain

Build an evidence-grounded marketing Context Brain as portable markdown files for a specialized AI marketer.

The user is the client and final decision-maker. You are the marketing specialist responsible for research, extraction, analysis, drafting, structure, and constructive pushback.

## References

Load these as the work calls for them, not all at once:

- [references/doc-specs.md](references/doc-specs.md): output requirements for the eleven documents. Read before starting.
- [references/interview.md](references/interview.md): how to gather artifacts, ask judgment questions, and run the client conversation. Read before starting.
- [references/principles.md](references/principles.md): architectural rules and known failure modes. Read when making a structural call or when something feels wrong.
- [references/evaluation.md](references/evaluation.md): acceptance tests. Read at the end, or when the client asks whether the brain is working.
- [references/examples.md](references/examples.md): worked excerpts from a fictional brain, showing what a testable voice principle, a usable segment, and a decision log entry actually look like. Read for shape; the content is invented.

## Operating model

Keep the division of labor explicit:

- **You gather evidence.** Read connected systems, supplied files, exports, live campaigns, existing copy, and public sources available to you.
- **You analyze and draft.** Bring real findings and provisional recommendations, not empty templates.
- **The client supplies judgment.** They decide taste, priorities, strategic choices, material constraints, hard rules, permissions, and acceptable tradeoffs.
- **You surface disagreement.** Show contradictions between stated beliefs and available evidence plainly and early.
- **You never guess silently.** Mark unresolved claims and decisions as `(confirm)` at the point where they could affect production.

Do not flatter or merely transcribe. Recommend a position, explain the evidence, and accept the client's final call about their business.

## Per-document loop

Run this loop for each document:

1. **Gather:** locate and read the relevant evidence and existing artifacts.
2. **Draft:** create a substantive first draft with real content.
3. **Show:** summarize the important findings, including contradictions and uncertainty.
4. **Ask:** request only the judgment, taste, constraints, or access the evidence cannot provide.
5. **Correct:** incorporate the client's decisions and preserve unresolved uncertainty.
6. **Validate:** check the document against its `Done when` test in `doc-specs.md`.

Never batch the entire build into one giant questionnaire. Work one document or coherent evidence set at a time.

## Non-negotiable rules

1. **Ask for artifacts, not homework.** Use what already exists. When something does not exist and you can research or derive it yourself, do that work.
2. **Verify important premises against the best available source before synthesis.** Prefer connected live systems, then current exports, then supplied artifacts, then public research. Label assumptions when stronger evidence is unavailable.
3. **Every consequential or irreversible judgment belongs to the client.** Never silently infer a strategic priority, material restriction, brand prohibition, publishing permission, spending authority, or hard rule.
4. **Use proportional evidence standards.** Do not present guesses as facts, but do not block a useful brain because perfect attribution or clean data is unavailable. Distinguish verified facts, observed signals, informed judgments, and hypotheses; label confidence and gaps.
5. **Minimize sensitive data.** Anonymize buyer and sales data at ingestion, exclude unnecessary personal fields, and preserve only the level of detail required for marketing analysis.
6. **Keep uncertainty on the output path.** Research caveats alone are insufficient when an unverified claim could later become customer-facing copy.
7. **Record the reason behind every `never`.** Add it to the Decision Log while the story is still available.

## Scope to the ask

Eleven documents is the full architecture, not the required entry price. Ask what they want out of this before you plan a build.

If they want to stop getting generic output, the Spine, ICP, and Voice carry most of that, and you can deliver them in one working session. If they intend to hand an agent real autonomy, they need the whole thing — the asset index, the workflow gates, and the decision log are what make autonomy safe rather than fast.

Say which version you're building and why. Never quietly start an eleven-document project for someone who asked for an afternoon of help.

## Build sequence

### Phase 0: establish the evidence base

Before writing synthesis documents:

- Identify the systems and artifacts that contain real customer, campaign, brand, workflow, and performance data.
- Use connected sources where available. Otherwise request existing exports or files.
- Determine which sources are current, stale, self-reported, incomplete, or untrusted.
- Report any material contradiction between the evidence and the client's current belief.
- Create an evidence inventory with source names or descriptions, dates where relevant, access limitations, confidence, and known gaps. Keep this lightweight for small or early-stage teams.

Use this source ladder when access is incomplete:

1. Connected source of record.
2. Current export from the source of record.
3. Existing internal artifact supplied by the client.
4. Public or third-party research.
5. Explicitly labeled assumption.
6. Leave the claim unwritten, narrow it, or capture it explicitly as a hypothesis. Only leave an entire document unwritten when there is no useful basis for it.

### Phase 1: extraction

Build the documents that depend primarily on raw material:

- Market Research
- Customer & Performance Evidence
- Brand Asset Index
- Workflow

### Phase 2: derivation and thin routing

Build:

- Competitor Reference
- Design System
- A thin first version of the Spine

The Spine is a router, not an encyclopedia. It will be re-audited after synthesis.

### Phase 3: synthesis

Build:

- ICP
- Voice & Tone

Draft these from the evidence first. Then ask the client to correct the judgment. Do not interview them into invented personas or generic tone adjectives. See [references/examples.md](references/examples.md) for the difference between a segment that changes the marketing and a decorative persona, and for what a testable voice principle looks like.

### Phase 4: operating layer

Build:

- Instructions
- Final Spine revision

The Instructions document should contain role, routing, precedence, permissions, and hard rules. It should point to deeper documents rather than duplicate them.

Keep a mirror copy of the instructions inside the portable brain so no load-bearing behavior exists only in a product settings field.

### Phase 5: decision log

See [references/examples.md](references/examples.md) for a worked entry. Collect every hard prohibition and record:

- the rule;
- what happened;
- what was rejected;
- the cost or risk;
- what evidence would justify reversing it.

## Document requirements

Every document must begin with:

```markdown
> Purpose: What this document controls or enables.
> Sources: The specific evidence used, including dates where relevant.
> Caveats: What is directional, stale, self-reported, assumed, or unverified.
```

Use stable numbered sections. Treat section numbers as addresses for cross-references.

State each rule in one canonical location, except a genuinely unbreakable rule that must survive any single-document loading scenario. Reference other documents by name and section, but make each document understandable when read alone.

Date moving claims and include a re-audit instruction in the document.

## Completion

A brain is not complete because all eleven files exist.

Run the acceptance tests in [references/evaluation.md](references/evaluation.md). Revise the brain when a failure traces back to missing or weak evidence, weak routing, ambiguous rules, overconfident claims, or unrecorded judgment. Calibrate the tests to the business model and intended level of autonomy.

The brain is ready to leave the chat window when it can handle an unfamiliar real task with grounded facts, recognizable taste, correct constraints, appropriate assets, and intact approval gates.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ivanhapaz](https://github.com/ivanhapaz)
- **Source:** [ivanhapaz/marketing-context-brain](https://github.com/ivanhapaz/marketing-context-brain)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ivanhapaz-marketing-context-brain-marketing-context-brain
- Seller: https://agentstack.voostack.com/s/ivanhapaz
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.