How amadad/brandos works
brandOS is a CLI-first brand operations toolkit. Its documented workflow starts with brand configuration, develops persona and market intelligence, plans campaigns, produces content, evaluates it against quality criteria, publishes approved material, and monitors results for future learning. The graph preserves those major product stages and the autonomous decision loop. Several stage-to-stage links are documented in the README; sampled source confirms selected orchestration and persistence behavior, but not every integration or connection.
Main entry points: brand_os/cli.py CLI commands · plan/cli.py Campaign planning · produce/cli.py Content production · eval/cli.py Content evaluation
Components 23
User entry
- CLI commands
src/brand_os/cli.py
Brand foundation
- Brand configuration
src/brand_os/core/brands.py - Persona tools
src/brand_os/persona/cli.py
Research and planning
- Competitive intel
src/brand_os/intel/pipeline.py - Signal monitoring
src/brand_os/signals/cli.py - Campaign planning
src/brand_os/plan/cli.py - Market research
src/brand_os/plan/stages/research.py - Campaign records
src/brand_os/plan/store.py
Content lifecycle
- Content production
src/brand_os/produce/cli.py - Copy generation
src/brand_os/produce/copy.py - Image generation
src/brand_os/produce/image/generate.py - Video generation
src/brand_os/produce/video/generate.py - Content evaluation
src/brand_os/eval/cli.py - Evaluation learnings
src/brand_os/eval/learnings.py
Publishing and monitoring
- Publishing queue
src/brand_os/publish/queue.py - Platform publishing
src/brand_os/publish/cli.py - Brand reports
src/brand_os/monitor/reports.py - Autonomous loop
src/brand_os/loop.py
Shared runtime
- Decision and policy
src/brand_os/core/decision.py - LLM interface
src/brand_os/core/llm.py - Local data paths
src/brand_os/core/storage.py
Other components
- Operator
- LLM providers
Connections 30
- Operator → CLI commands: runs commands
- CLI commands → Brand configuration: manages brands
- CLI commands → Persona tools: runs persona
- CLI commands → Competitive intel: runs intel
- CLI commands → Signal monitoring: fetches signals
- CLI commands → Campaign planning: plans campaigns
- CLI commands → Content production: generates content
- CLI commands → Content evaluation: grades content
- CLI commands → Platform publishing: publishes posts
- Campaign planning → Market research: runs research
- Campaign planning → Campaign records: saves campaigns
- Content production → Copy generation: generates copy
- Content production → Image generation: generates images
- Content production → Video generation: generates video
- Content evaluation → Evaluation learnings: logs evaluations
- Platform publishing → Publishing queue: reads and updates
- Autonomous loop → Decision and policy: checks decisions
- Market research → LLM interface: requests analysis
- Persona tools → LLM interface: generates persona
- LLM interface → LLM providers: calls provider
- Campaign planning → Local data paths: stores output
- Competitive intel → Brand configuration: loads brand config
- Autonomous loop → Brand configuration: loads brand config
- CLI commands → Brand reports: runs reports
- Competitive intel → Campaign planning: informs planning
- Campaign planning → Content production: guides production
- Content production → Content evaluation: submits content
- Content evaluation → Publishing queue: approves for queue
- Platform publishing → Brand reports: provides outcomes
- Brand reports → Evaluation learnings: feeds learning