{"id":50790391,"url":"https://github.com/caiopizzol/brand.md","last_synced_at":"2026-06-12T10:31:26.678Z","repository":{"id":349145913,"uuid":"1181150444","full_name":"caiopizzol/brand.md","owner":"caiopizzol","description":"brand.md — an open standard for brand identity files. Like AGENTS.md for coding agents, brand.md gives AI tools your brand context.","archived":false,"fork":false,"pushed_at":"2026-06-01T14:57:04.000Z","size":198,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T16:28:42.160Z","etag":null,"topics":["ai","brand","brand-identity","brand-strategy","branding","claude-code","markdown","open-standard","plugin"],"latest_commit_sha":null,"homepage":"https://thebrand.md","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caiopizzol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-13T20:01:16.000Z","updated_at":"2026-06-01T15:24:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/caiopizzol/brand.md","commit_stats":null,"previous_names":["thebrandmd/brand.md","caiopizzol/brand.md"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/caiopizzol/brand.md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiopizzol%2Fbrand.md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiopizzol%2Fbrand.md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiopizzol%2Fbrand.md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiopizzol%2Fbrand.md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caiopizzol","download_url":"https://codeload.github.com/caiopizzol/brand.md/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiopizzol%2Fbrand.md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34240815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","brand","brand-identity","brand-strategy","branding","claude-code","markdown","open-standard","plugin"],"created_at":"2026-06-12T10:31:24.179Z","updated_at":"2026-06-12T10:31:26.673Z","avatar_url":"https://github.com/caiopizzol.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# brand.md\n\nAn open standard for brand identity files.\n\n`brand.md` is a file that lives in your project root and tells AI tools how your brand looks, sounds, and behaves. Like `AGENTS.md` gives AI agents coding instructions, `brand.md` gives them brand context.\n\n## Quick example\n\n```markdown\n---\nname: \"Acme\"\ntagline: \"Build faster, break nothing\"\nversion: 1\nlanguage: en\n---\n\n# Acme\n\n## Strategy\n\n### Overview\nAcme is a deployment platform for teams that ship daily...\n\n### Positioning\nCategory: Zero-downtime deployment infrastructure.\nNot a CI/CD pipeline. Not a hosting provider. Not DevOps consulting...\n\n### Personality\nArchetype: The Reliable Engineer...\n\n### Promise\nShip with confidence. Every time...\n\n### Guardrails\nIf it sounds like marketing, rewrite it...\n\n## Voice\n\n### Identity\nWe are the infrastructure teams trust when downtime isn't an option...\n\n### Tonal Rules\n- Write like an engineer explaining to another engineer.\n- Never use \"revolutionary\" or \"game-changing.\"\n- Calm confidence. Always.\n\n| We Say | We Never Say |\n|---|---|\n| \"Zero-downtime deploys\" | \"Seamless cloud solution\" |\n\n...\n\n## Visual\n\n### Colors\n- Primary: #0F172A (deep navy) — headings, UI chrome\n- Accent: #38BDF8 (sky blue) — CTAs, links, highlights\n...\n```\n\n## Structure\n\n```\nbrand.md\n├── Frontmatter (name, tagline, version, language, type?, architecture?)\n├── ## Strategy\n│   ├── ### Overview\n│   ├── ### Positioning\n│   ├── ### Personality\n│   ├── ### Promise\n│   └── ### Guardrails\n├── ## Voice\n│   ├── ### Identity\n│   ├── ### Tagline \u0026 Slogans\n│   ├── ### Manifesto (optional)\n│   ├── ### Message Pillars\n│   ├── ### Phrases\n│   ├── ### Social Bios (optional)\n│   └── ### Tonal Rules\n└── ## Visual\n    ├── ### Colors\n    ├── ### Typography\n    ├── ### Photography (optional)\n    └── ### Style (optional)\n```\n\n## Hierarchy\n\nLike `CLAUDE.md`, `brand.md` supports directory-based hierarchy. A master brand in the project root cascades down to product brands in subdirectories.\n\n```\ncompany/\n├── brand.md                    ← master brand (Acme Corp)\n├── cloud/\n│   └── brand.md                ← product brand (Acme Cloud)\n└── analytics/\n    └── brand.md                ← product brand (Acme Analytics)\n```\n\nProduct brands are sparse — they only define sections where they diverge. Missing sections inherit from the parent. Guardrails always cascade down.\n\nFour architecture types control how much a product inherits:\n\n| Architecture | Coupling | Example |\n|---|---|---|\n| `branded-house` | Tightest | Google → Google Maps |\n| `endorsed` | Parent visible | Marriott → Courtyard by Marriott |\n| `sub-brand` | Shared DNA | Apple → iPhone |\n| `independent` | Loosest | P\u0026G → Tide |\n\nSee [spec/brand-md.md](spec/brand-md.md) for the full hierarchy specification.\n\n## Generate one\n\n### Install\n\nAdd the marketplace and install the plugin:\n\n```\n/plugin marketplace add thebrandmd/brand.md\n/plugin install brand-md@brand-md\n```\n\n### Run it\n\n```\n/brand-md:brand\n```\n\nThe skill researches your market, interviews you, and generates a complete `brand.md`.\n\n### Or test locally\n\n```bash\ngit clone https://github.com/thebrandmd/brand.md\nclaude --plugin-dir ./brand.md\n```\n\nThen run `/brand-md:brand` inside Claude Code.\n\n## Spec\n\nFull specification: [spec/brand-md.md](spec/brand-md.md)\n\n## Why brand.md?\n\nEvery AI agent writing copy, generating social posts, designing pages, or creating marketing assets currently has **zero brand context**. You either paste brand guidelines into every prompt, or you get generic output.\n\n`brand.md` fixes this. One file, one location, every tool reads it.\n\n## License\n\nMIT\n\n## Contributors\n\n\u003ca href=\"https://github.com/caiopizzol\"\u003e\u003cimg src=\"https://github.com/caiopizzol.png\" width=\"50\" height=\"50\" alt=\"caiopizzol\" title=\"Caio Pizzol\" /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaiopizzol%2Fbrand.md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaiopizzol%2Fbrand.md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaiopizzol%2Fbrand.md/lists"}