# Agent Cody

> Agent Cody is a content operations platform for Social Media Marketing Agencies. It manages brands, deliverables, scheduling, approvals, research, and AI-assisted script generation from templates and reels.

Most pages require an authenticated session; only the routes under "Public" are reachable without signing in. Bracketed segments like `[brandSlug]` and `[deliverableId]` are dynamic — substitute a real value when navigating.

For a longer narrative including domain concepts (PESTO framework, Pillars/Angles/Formats, Templates vs. Playbooks, the Steal flows), see [llms-full.txt](/llms-full.txt).

For an HTML rendering of the same content, see [/agent-guide](/agent-guide). Crawler-friendly markdown mirror at [/agent-guide.md](/agent-guide.md).

## Public

- [Sign In](/login): Email + password or Google OAuth sign-in.
- [Agent Guide](/agent-guide): Public navigation map for AI agents — the same content as llms-full.txt rendered as HTML.

## Core

- [Home](/): Authenticated landing page: greeting, brand list with active project counts, quick action to create a new brand.
- [In-app Guide](/guide): Interactive help / onboarding documentation: PESTO framework, research, board, calendar, performance, inbox, roles, glossary.

## Brands

- [Brands](/brands): List of all brands in the active organization with search, filter, and a create dialog.
- [Brand Overview](/brands/[brandSlug]): Brand dashboard with stats, upcoming content, recent deliverables, and quick links.

## Brand Profile

- [Brand Profile](/brands/[brandSlug]/profile): Editable brand profile across identity, audience/ICP, voice, pillars, visual identity, sponsored content, offer, tone, guardrails, brand story, differentiation, and per-platform voice.
- [Brand Profile Wizard](/brands/[brandSlug]/profile/wizard): Step-by-step onboarding for a new brand: identity, audience/ICP, voice/tone, topics, brand story.

## Board & Deliverables

- [Deliverables Board](/brands/[brandSlug]/board): Kanban view of every deliverable for a brand with platform/media/pillar/format/angle filters and create actions.
- [Deliverable Detail](/brands/[brandSlug]/board/[deliverableId]): Full view of a single deliverable: script, caption/hashtags, posting URLs, scheduled date, status stepper, performance, tasks, and activity timeline.

## Calendar

- [Calendar](/brands/[brandSlug]/calendar): Monthly calendar with drag-to-schedule from an unscheduled tray and a per-deliverable detail sheet.

## Inbox

- [Inbox](/inbox): Unified action list — research-profile decisions, deliverable approvals, and triage items.

## Research

- [Brand Research](/brands/[brandSlug]/research): Redirects into the brand competitors view; entry point for research surfaces.
- [Swipe File](/brands/[brandSlug]/research/swipe): Reference-content library per brand: drag-drop upload, URL ingest, tagging, and pillar/category assignment.
- [Research Profile](/brands/[brandSlug]/research/profiles/[username]): Per-brand creator profile view fed by research database (used as input for script generation).
- [Research Reel](/brands/[brandSlug]/research/reels/[reelId]): Reel detail from research — metadata, hooks, transcript, Adapt action.
- [Brand Hooks](/brands/[brandSlug]/research/hooks): Per-brand hook templates (subset of the global hooks library).

## Competitors

- [Competitors](/brands/[brandSlug]/competitors): Per-brand list of competitors / creator profiles with sort + filter by platform/niche/followers; add or import.
- [Competitor Detail](/brands/[brandSlug]/competitors/[username]): Detail view of a single competitor / creator — metadata, follower counts, related content.
- [Creator Intel](/brands/[brandSlug]/competitors/[username]/intel): Deep dive into a creator — niche, top hooks, performance patterns, AI-extracted insights.

## Playbooks

- [Playbooks](/playbooks): Reusable copywriting playbooks (frameworks / checklists / references / transcripts) — org-wide and per-brand.
- [New Playbook](/playbooks/new): Form to create a playbook (name, type, scope, body).

## Hooks

- [Hooks](/hooks): Hook-template library used to seed new scripts — CRUD + duplicate + categorize.

## Library (global)

- [Content Library](/content): Global reel database across the org — search, filter (pillar / platform / angle), tag, manage taxonomy.
- [Reel Detail](/content/[reelId]): Full reel view: metrics, hooks, tags, creator info; copy hashtags, bookmark, view/create hooks, Adapt.
- [Global Taxonomy](/content/taxonomy): Org-wide pillar + angle taxonomy: add / edit / delete pillars and angles; manage angle options.
- [Brand Taxonomy](/brands/[brandSlug]/content): Per-brand pillar + angle overrides on top of the global taxonomy.
- [Templates](/templates): Redirects to /content. Kept for backward-compatible deep links.
- [Creators](/creators): Global creator browser across the org — search, filter, sort, bulk-assign creators to brands.
- [Creator Profile](/creators/[username]): Global creator profile view (org-wide, not brand-scoped).

## Analytics & Reports

- [Analytics](/analytics): Placeholder that prompts you to switch the active brand; per-brand performance lives under /brands/[slug]/performance.
- [Brand Performance](/brands/[brandSlug]/performance): Per-brand performance dashboard: engagement rates, top performers, content breakdowns, AI-generated insights for published content.
- [Reports](/brands/[brandSlug]/reports): Historical performance reports per brand by date range; summary metrics + export.

## Settings

- [Brand Settings](/brands/[brandSlug]/settings): Edit brand basic info, social handles + follower counts, posting goals, social integrations; archive or permanently delete the brand.
- [API keys](/settings/api-keys): Self-serve provisioning of bearer tokens for the MCP server, the Chrome extension, and any server-to-server caller. The raw key is shown once on creation and stored only as a SHA-256 hash.

## Public Share Links

- [Public Report](/report/[token]): Token-gated public performance report (optionally password-protected).
- [Shared Insights](/share/insights/[token]): Token-gated insights / performance narrative — read-only embeddable view.