marketmenow: Instructions file for Codex

MarketMeNow — Agent Guide

MarketMeNow is a cross-platform marketing automation framework (Python 3.12+, async, ports-and-adapters architecture). It generates and publishes content across Instagram, Twitter/X, Reddit, LinkedIn, YouTube, TikTok, Facebook, and Email via a CLI (mmn) and a FastAPI web dashboard.

Quick Reference

uv sync                              # Install deps
uv run --extra dev pytest             # Test
uv run ruff check src/ tests/        # Lint
uv run ruff format src/ tests/       # Format
uv run mmn --help                    # CLI
uv run mmn workflows                 # List marketing workflows
uv run mmn run <workflow> [OPTIONS]  # Run a workflow
uv run mmn project add <slug>      # Create project (onboarding wizard)
uv run mmn project list             # List projects
uv run mmn project use <slug>       # Switch active project
uv run mmn auth <platform>           # Authenticate
uv run mmn-web                       # Web dashboard (localhost:8000)

Architecture Invariants

• src/marketmenow/ is platform-agnostic. It must never import platform SDKs or adapter code (except lazy imports in core/registry_builder.py, core/workflow_registry.py, and steps/).
• src/adapters/ contains all platform-specific logic. Adapter packages are independent and must not import from each other.
• All adapter interfaces are typing.Protocol with @runtime_checkable — use structural subtyping, never ABC inheritance.
• All data models are Pydantic BaseModel with frozen=True — mutate via model_copy(update={...}).

Agent Config Locations