Tracehound X Agent Architecture

AI Work Team for @tracehoundai X Account Management

← Back to dashboard

4
AI Agents
5
Content Pillars
5
Daily Slots
7
API Endpoints
3
Workflows

Agent Team

Four specialized Claude Opus agents with persistent memory, coordinated through an orchestrator.

📋
Content Strategist
Plans what gets posted, when, and why
Claude Opus Persistent Memory

Responsibilities

  • Weekly content themes and daily slot assignments
  • Content calendar and campaign planning
  • Pillar balance and content mix optimization
  • Narrative research for content angles
  • Performance review and strategy adjustments

Templates

  • Content Pillars Framework
  • Weekly Plan, Daily Brief, Calendar
  • Campaign Planner, Performance Review

Reads From

  • knowledge/ (features, tokenomics, narratives)
  • content/calendar/ (existing plans)
  • output/analytics/ (performance data)
  • brand/ (voice, terminology, do-not-say)
Copywriter
Turns strategy briefs into polished tweet copy
Claude Opus Persistent Memory

Responsibilities

  • Write tweets, threads, and QRT copy
  • Maintain brand voice consistency
  • Evaluate visual need per post
  • Delegate to graphic-designer when needed
  • Produce multiple draft variations

Output Formats

  • Single tweet (280 chars max)
  • Thread (4-8 tweets, numbered "1/" format)
  • YAML frontmatter + markdown body

Key Constraint

  • Never financial advice or price predictions
  • Every tweet must pass "would I bookmark this?" test
📊
Data Analyst
X performance analytics and trend discovery
Claude Opus Persistent Memory

Responsibilities

  • Pull X API v2 metrics (engagement, reach, growth)
  • Analyze post performance and content types
  • Identify trending topics and opportunities
  • Build interactive HTML dashboards
  • Surface strategic recommendations

X API Access

  • Bearer token auth (read-only analytics)
  • Endpoints: user info, tweets, search, mentions
  • Rate-limit aware, cache-first approach

Analysis Framework

  • Observation (data) → Insight (why) → Action → Impact
🎨
Graphic Designer
Evaluates visual need and creates brand graphics
Claude Opus Persistent Memory

Responsibilities

  • Assess whether each post needs imagery
  • Create graphics matching brand identity
  • Design announcements, infographics, thread openers
  • Maintain visual consistency across campaigns

Brand Palette

  • Background: #0a0a0a (near-black)
  • Accent: #00c9a7 (teal/cyan)
  • Glow effects, portal rings, polygonal style
  • Format: 1200x675px (16:9)

Invocation

  • Usually called BY the copywriter (auto-delegation)
  • Can be called directly for standalone requests

Content Production Pipeline

The standard flow from strategy to published tweet.

Agent 1
Content Strategist
Agent 2
Copywriter
Agent 3 (optional)
Graphic Designer
Gate
Human Review
Output
Publish to X

Feedback loop

Published
Live on X
Agent 4
Data Analyst
Feeds Back To
Content Strategist

Post Status Flow

Every post transitions through these states.

Pending
Draft
Approved
Published

Rejected drafts return to Pending for rework

Content Pillars

All content maps to one of five strategic pillars. No pillar should exceed 35% of weekly output.

📡
Signal Intelligence
AM-1 primary
25-35% weekly
📦
Product Showcase
AM-2 primary
20-25% weekly
📚
Education & Depth
PM-1 primary
8-12% weekly
👥
Community & Culture
PM-2 primary
20-25% weekly
🌐
Ecosystem & Narrative
FLEX primary
10-15% weekly

Daily Content Workflow

The four-phase cycle that runs every day. Target: 3-5 posts per day.

1

Morning Cycle — Planning

06:00 - 09:00 UTC
  1. Analyst Scans overnight market activity, narrative shifts, competitor posts
  2. Analyst Delivers morning brief: top 3 relevant developments + active narratives
  3. Strategist Selects daily themes, assigns content to 5 slots (AM-1, AM-2, PM-1, PM-2, FLEX)
  4. Strategist Outputs content brief for each slot (type, theme, angle, key points, CTA)
2

Midday Cycle — Creation

09:00 - 13:00 UTC
  1. Copywriter Generates tweet/thread copy for each content slot
  2. Designer Creates graphics for posts that need visual enhancement
  3. System Drafts saved to content/drafts/ and schedule.json (status: draft)
  4. Human Reviews drafts in dashboard, approves or rejects each post
3

Afternoon Cycle — Publish & Engage

14:00 - 18:00 UTC
  1. Auto-Publisher Hourly cron checks for approved posts whose scheduled_time has passed
  2. X API Uploads media (if any) then posts tweet or thread via OAuth 1.0a
  3. Engagement Monitors replies and mentions within first 2 hours of publishing
  4. Engagement Drafts responses to meaningful community interactions
4

Evening Cycle — Review

18:00 - 22:00 UTC
  1. Analyst Pulls post performance metrics via X API v2
  2. Analyst Logs insights to agent memory (baselines, patterns, top performers)
  3. Strategist Performance data feeds into next morning's planning cycle

Engagement Loop

Continuous community monitoring and response workflow.

Ongoing Engagement

Continuous
  1. Engagement High priority (1hr): Direct questions about Tracehound, FUD/misconception correction
  2. Engagement Medium priority (4hr): Community sharing Tracehound, relevant threads for value-add
  3. Engagement Low priority: General crypto discussions (opportunistic)
  4. Human Escalation triggers: Price/investment Qs, partnerships, legal, security, media, wallet data, harassment

Narrative Monitoring

Crypto narrative tracking for timely content opportunities.

🔍

Narrative Lifecycle Tracking

Multi-cadence
  1. Real-time: Token unlocks, major on-chain movements, viral narratives
  2. Hourly: Trending topics on Crypto Twitter, sentiment shifts
  3. Daily: Competitor content audit, narrative momentum assessment
  4. Weekly: Narrative lifecycle review (emerging → active → peaking → fading)
  5. Content windows: Breaking (0-2hr) → Active (2-24hr) → Fading (24-72hr) → Dead (72hr+)

Agent Routing Rules

How user requests are matched to the correct agent.

Content Strategist

Planning, calendars, strategy, narrative research
plan contentcontent calendarwhat should we postweekly plancampaign plancontent briefcontent ideaswhat topicsengagement dropping

Copywriter

Writing tweets, threads, QRTs, announcements
write a tweetdraft a threadwrite copywrite a postcreate a tweet aboutwrite an announcementdraft this

Data Analyst

Performance analytics, dashboards, trend discovery
how are we performingengagement metricsanalyticsdashboardperformance reporttrending topicsreach droppedour best posts

Graphic Designer

Visual assessment, graphic creation, brand imagery
create a graphicdesign an imagemake a visualneed an imagecreate a banner

Multi-Step Routing Logic

  1. Topic/angle is clear → Go directly to Copywriter
  2. Strategy decisions needed first → Start with Strategist then pass brief to Copywriter
  3. Performance data needed → Start with Analyst then pass findings to Strategist
  4. Independent tasks → Run agents in parallel (e.g., analyst + strategist simultaneously)

Dashboard & REST API

Node.js + Express web dashboard with approval workflow and X API posting.

app.tracehound.ai
Dashboard URL
Express
Framework
OAuth 1.0a
X API Auth
Hourly
Auto-Publish Cron

API Endpoints

MethodPathAction
GET/api/postsList all posts (filter by ?status= or ?date=)
GET/api/posts/:idGet single post by ID
PUT/api/posts/:idUpdate post content or fields
POST/api/posts/:id/approveMove status: draft → approved
POST/api/posts/:id/rejectMove status: draft → pending
POST/api/posts/:id/publishPublish to X (approved → published)
POST/api/posting/publish-dueBatch publish all approved posts past due
GET/api/statsAggregate counts by status

X API Integration

🐦

Tweet Publishing Flow

  1. Single Tweet: Upload media (if image_path set) → POST /2/tweets with text + media_id → Store published_id
  2. Thread: Post tweet 1 (with media) → get ID → Post tweet 2 as reply → get ID → chain → Store all IDs
  3. Media Upload: INIT (declare) → APPEND (5MB chunks) → FINALIZE (complete) → Return media_id_string

Auto-Publishing Schedule

Hourly Cron Task

Every hour at :07
  1. Scheduled task runs publish-due.js every hour
  2. Script reads schedule.json, filters: status=approved AND scheduled_time ≤ now
  3. For each due post: upload media → post to X → update status to published
  4. Prints summary to stdout (published count, failed count)

Data Schema

The schedule.json schema — single source of truth for all posts.

// content/schedule.json — each entry { "id": "w1-mon-am1", // Unique post identifier "date": "2026-04-14", // Publishing date "day": "Mon", // Day of week "slot": "AM-1", // Time slot (AM-1/AM-2/PM-1/PM-2/FLEX) "scheduled_time": "2026-04-14T08:00:00Z", // Exact publish time (UTC) "type": "tweet" | "thread", // Content format "pillar": "signal", // Content pillar "title": "Fear & Greed at 46 days", // Display title "content": "Tweet text...", // Full tweet copy (280 chars max) "thread_tweets": ["1/...", "2/..."], // Thread tweets array (empty for single) "image_path": null | "path/to/image.png", // Graphic asset "status": "pending" | "draft" | "approved" | "published", "published_id": null | "X tweet ID", "published_thread_ids": [], // Array of tweet IDs for threads "created_at": "ISO timestamp", "updated_at": "ISO timestamp" }

Slot-to-Time Mapping

SlotUTC TimePrimary PillarPurpose
AM-108:00 UTCSignal IntelligenceTimely market observations
AM-209:00 UTCProduct ShowcaseFeature highlights and use cases
PM-114:00 UTCEducation & DepthThreads and deep-dives
PM-216:00 UTCCommunity & CultureEngagement and relationship building
FLEX12:00 UTCEcosystem & NarrativeReactive/trending content

Environment Variables (.env)

# X API Authentication X_BEARER_TOKEN=AAAA... # Read-only (data-analyst) X_API_KEY=... # OAuth consumer key X_API_SECRET=... # OAuth consumer secret X_ACCESS_TOKEN=... # OAuth access token X_ACCESS_TOKEN_SECRET=... # OAuth access token secret # Dashboard DASHBOARD_PORT=3000 # Optional, defaults to 3000

File Structure

Complete project directory tree.

tracehound-x-agent/ CLAUDE.md # Project overview & agent routing rules .env # X API credentials .claude/ agents/ # Agent definitions (Claude Code) content-strategist.md copywriter.md data-analyst.md graphic-designer.md agent-memory/ # Persistent agent memory content-strategist/ copywriter/ data-analyst/ graphic-designer/ launch.json # Dashboard server config agents/ # Agent configs & templates README.md # Architecture overview content-strategist/ config.md content-pillars.md weekly-plan-template.md daily-brief-template.md calendar-template.md campaign-planner-template.md performance-review-template.md copywriter/ config.md engagement/ config.md analyst/ config.md brand/ # Brand guidelines voice-guide.md terminology.md do-not-say.md visual-guide.md logo-profile-pic/ # 6 logo variants + profile pic knowledge/ # Curated knowledge base tracehound-features.md tokenomics.md competitors.md crypto-narratives.md prompts/ # Prompt templates tweets/ market-observation.md product-highlight.md threads/ educational.md replies/ community-response.md campaigns/ launch-campaign.md workflows/ # Automation workflows daily-content.md engagement-loop.md narrative-monitor.md content/ # Content pipeline schedule.json # Master schedule store calendar/ # Monthly/weekly plans drafts/ # Draft posts (16 files) approved/ # Approved posts published/ # Published archive dashboard/ # Node.js web dashboard server.js package.json lib/ schedule-store.js x-api-client.js media-upload.js routes/ api.js posting.js scripts/ publish-due.js # Auto-publisher (cron) public/ index.html css/styles.css js/dashboard.js context/ # Source materials Tracehound Whitepaper.pdf Tracehound Pitch Deck.pdf output/ # Generated outputs analytics/ reports/ architecture.html