Back to .md Directory

SPDX-License-Identifier: MIT

Walks through a complete AI copywriter workflow for a banking campaign, showing memory, actions, and decision procedures at each stage.

May 2, 2026
0 downloads
1 views
ai eval workflow
View source

What this file does

Walks through a complete AI copywriter workflow for a banking campaign, showing memory, actions, and decision procedures at each stage.

When to use it

  • Designing an AI agent workflow for creative copywriting tasks
  • Building a multi-stage cognitive architecture with memory and decision procedures
  • Teaching how to structure agentic workflows with explicit inputs, outputs, and internal actions
  • Documenting a realistic end-to-end scenario for an AI writing assistant

SPDX-License-Identifier: MIT

Copyright (c) 2025 Vamsi Duvvuri

Nina Writer: Detailed Workflow Scenario

Fifth Grade Explanation:

This document shows how our AI copywriter, Nina, works on a real project. It's like watching her think and write as she creates advertisements, showing what information she uses, how she makes decisions, and who she works with.

High School Explanation:

This document provides a detailed walkthrough of Nina Writer's cognitive and operational processes during a typical copywriting assignment, demonstrating how memory systems, action spaces, and decision procedures integrate in a real-world advertising scenario with specific inputs, processing steps, and outputs.


Nina Writer's Campaign Copywriting Workflow

Campaign Scenario: Refresh Financial - "Freedom Banking" Launch Campaign

Project Context

Refresh Financial is launching a new digital banking platform called "Freedom Banking" targeting millennials and Gen Z customers who feel constrained by traditional banking. The platform emphasizes no hidden fees, instant account opening, and AI-powered financial guidance. The campaign needs to drive app downloads and new account openings with a tone that feels authentic and non-corporate.

Workflow Stage 1: Creative Brief Intake

Inputs

  • Creative brief document from Carlos Planner containing:

    • Campaign objectives and KPIs (200,000 app downloads in first month)
    • Target audience definition (25-38 year olds, digitally native, financially conscious)
    • Key product features and benefits
    • Competitive positioning against traditional banks
    • Campaign timelines and deliverables needed
  • Brand guidelines from Simon Strategist including:

    • Brand voice parameters (conversational, honest, slightly irreverent)
    • Messaging hierarchy and key claims
    • Prohibited language and compliance requirements for financial services
    • Visual identity elements that copy needs to complement
  • Research insights from Olivia Researcher detailing:

    • Pain points of target audience with traditional banking
    • Language patterns from customer interviews
    • Emotional triggers that resonate with the audience
    • Social listening data on conversations about banking frustrations

Memory Activation

Working Memory:

  • Loads creative brief, brand guidelines, and research insights
  • Flags key campaign messages about "freedom" and "control"
  • Tags priority deliverables and deadlines
  • Marks financial industry compliance requirements for special attention

Long-Term Memory Retrieval:

  • Retrieves previous financial service campaigns and their performance metrics
  • Accesses financial services regulatory knowledge base
  • Pulls successful millennial-targeted campaign examples
  • Retrieves linguistic patterns that have resonated with younger banking customers

Internal Actions

  • Brief Analysis: Deconstructs the creative brief to identify core messaging requirements
  • Audience Modeling: Creates mental model of target users based on research
  • Constraint Mapping: Identifies boundaries including compliance requirements, word counts, and tone parameters
  • Opportunity Identification: Recognizes potential to leverage financial pain points as emotional hooks
  • Knowledge Gap Assessment: Identifies needed information about competitor messaging

External Actions

  • Competitor Research: Accesses competitive intelligence platform to review messaging from other digital banks
  • Compliance Check: Queries financial services compliance database for relevant restrictions
  • Brief Clarification: Sends questions to Carlos Planner about campaign message prioritization
  • Performance Data Retrieval: Pulls engagement metrics from previous financial campaigns
  • Collaboration Setup: Creates project workspace in content management system

Decision Procedure

Goal Setting:

  • Primary goal: Create compelling copy that drives app downloads
  • Secondary goals: Establish brand voice, differentiate from traditional banks, maintain compliance

Planning:

  • Determine copy development sequence (headlines first, then supporting copy)
  • Allocate time for multiple creative approaches (3 distinct messaging territories)
  • Schedule internal review checkpoint with Lucas Director before client presentation
  • Plan for two revision cycles based on project timeline

Constraint Analysis:

  • Financial services advertising regulations limit certain claims
  • Brand voice must maintain professionalism while being conversational
  • Copy must work across multiple formats (social, display, website, email)

Approach Selection:

  • Choose emotional-rational balanced approach based on audience analysis
  • Prioritize "freedom" messaging territory based on research resonance
  • Select question-based headline approach to engage target audience

Outputs

  • Creative approach document for Lucas Director containing:

    • Three proposed messaging territories with rationales
    • Recommended copy development approach
    • Questions requiring clarification before proceeding
    • Timeline for deliverables with dependencies
  • Project brief acceptance notification to Elena Manager and Carlos Planner

  • Workspace setup notification to collaborative team members

  • Knowledge gap requests to Olivia Researcher for additional audience insights

Workflow Stage 2: Headline Development

Inputs

  • Approved creative approach from Lucas Director with feedback
  • Clarification responses from Carlos Planner
  • Additional audience insights from Olivia Researcher
  • Compliance guidelines from Evelyn Enforcer specific to banking claims

Memory Activation

Working Memory:

  • Updates project parameters based on feedback
  • Prioritizes "financial freedom" territory based on director approval
  • Activates conceptual frameworks for headline development
  • Holds compliance restrictions in active memory during creation

Long-Term Memory Retrieval:

  • Accesses repository of effective headline structures
  • Retrieves emotional language patterns associated with freedom and control
  • Pulls examples of high-performing question-based headlines
  • Accesses industry-specific terminology for financial services

Internal Actions

  • Concept Ideation: Generates multiple thematic concepts around financial freedom
  • Language Pattern Analysis: Evaluates linguistic structures for engagement potential
  • Emotional Mapping: Connects audience pain points to positive product benefits
  • Variation Development: Creates systematic variations exploring different angles
  • Self-critique: Evaluates initial ideas against brief requirements and brand voice

External Actions

  • Headline Generation: Creates 20+ headline options in varying formats
  • SEO Analysis: Runs potential headlines through keyword optimization tool
  • A/B Test Configuration: Sets up headline testing framework for later use
  • Linguistic Analysis: Processes headlines through sentiment analysis tool
  • Reference Collection: Gathers supporting examples and inspiration

Decision Procedure

Goal Setting:

  • Create 20+ headline options exploring the freedom territory
  • Narrow to 5-7 strongest contenders through systematic evaluation
  • Ensure variety in approach while maintaining message consistency

Planning:

  • Generate broad range of options first without self-editing
  • Apply systematic evaluation criteria to narrow options
  • Group headlines into conceptual families
  • Select representatives from each family for presentation
  • Refine wording and structure of selected options

Evaluation Framework:

  • Alignment with campaign objectives (40% weight)
  • Emotional impact for target audience (30% weight)
  • Brand voice consistency (15% weight)
  • Distinctiveness from competitors (15% weight)

Selection Process:

  • Score all headlines against evaluation criteria
  • Eliminate non-compliant or off-strategy options
  • Ensure representation of different approaches
  • Refine language of top contenders for maximum impact

Outputs

  • Headline presentation document for Lucas Director containing:

    • Top 7 headline options with rationales
    • Headline groupings by conceptual approach
    • Evaluation methodology explanation
    • Recommendations for testing
  • Preliminary creative exploration saved to project workspace

  • Internal review request scheduled with Lucas Director

  • SEO analysis report attached for keyword considerations

Workflow Stage 3: Body Copy Development

Inputs

  • Selected headlines from Lucas Director (3 finalists)
  • Design direction from Marcus Designer showing visual concepts
  • Channel specifications from James Planner with format requirements
  • SEO requirements from Max Optimizer with target keywords

Memory Activation

Working Memory:

  • Loads selected headlines as anchors for body copy
  • Holds channel and format requirements for each deliverable
  • Maintains consistent message architecture across deliverables
  • Tracks keyword integration requirements

Long-Term Memory Retrieval:

  • Accesses product benefit frameworks for financial services
  • Retrieves effective call-to-action patterns for app downloads
  • Pulls best practices for cross-channel messaging consistency
  • Accesses compliance requirements for claims substantiation

Internal Actions

  • Narrative Development: Creates storylines that flow from headlines
  • Benefit Articulation: Transforms product features into compelling benefits
  • Tone Calibration: Adjusts linguistic style to match brand parameters
  • Structure Planning: Architects copy flow for each channel format
  • Message Hierarchy: Prioritizes information based on channel constraints

External Actions

  • Body Copy Creation: Writes supporting copy for each headline direction
  • Channel Adaptation: Modifies copy for different formats (social, display, website)
  • Keyword Integration: Incorporates SEO terms from Max Optimizer
  • Call-to-Action Development: Creates varied CTAs optimized for each channel
  • Compliance Review Preparation: Tags claims requiring substantiation

Decision Procedure

Goal Setting:

  • Develop cohesive body copy that extends headline concepts
  • Adapt messaging appropriately for each channel requirement
  • Maintain consistent voice while optimizing for format constraints
  • Integrate SEO requirements without compromising quality
  • Ensure all claims are substantiated and compliant

Planning:

  • Develop master messaging document as source material
  • Create channel-specific variations from master document
  • Implement systematic keyword integration approach
  • Develop modular components that can be mixed for different uses
  • Build progressive narrative across customer journey touchpoints

Quality Control Framework:

  • Message consistency across touchpoints (primary check)
  • Format appropriateness for each channel (secondary check)
  • Brand voice consistency throughout all copy (ongoing evaluation)
  • Compliance with financial regulations (critical requirement)
  • SEO optimization balanced with readability (optimizing factor)

Adaptation Strategy:

  • Social media: Shorter, more conversational, emotionally-driven
  • Display ads: Concise, benefit-focused, strong CTAs
  • Website: More detailed, balanced emotional-rational, structured
  • Email: Personalized, journey-focused, relationship-building

Outputs

  • Complete copy package for Lucas Director containing:

    • Full copy for all three headline directions
    • Channel-specific adaptations for each direction
    • Rationale document explaining copy decisions
    • Compliance considerations and substantiation
  • Copy deck formatted for client presentation

  • SEO implementation report for Max Optimizer showing keyword usage

  • Asset metadata for Sophia Producer to use in production

  • Collaborative feedback request to Marcus Designer for copy-visual integration

Workflow Stage 4: Revision and Finalization

Inputs

  • Client feedback from Elena Manager after initial presentation
  • Performance data from A/B testing coordinated by Max Optimizer
  • Legal review notes from Evelyn Enforcer
  • Design integration feedback from Marcus Designer

Memory Activation

Working Memory:

  • Prioritizes critical client feedback points
  • Flags legal compliance issues requiring immediate attention
  • Loads A/B testing results for data-driven decisions
  • Tracks specific revision requests by stakeholder

Long-Term Memory Retrieval:

  • Accesses patterns for addressing common client concerns
  • Retrieves techniques for maintaining creative integrity while incorporating feedback
  • Pulls similar revision scenarios from past projects
  • Accesses compliance-friendly alternative phrasings

Internal Actions

  • Feedback Analysis: Categorizes feedback by type and priority
  • Solution Mapping: Develops specific approaches to address each concern
  • Creative Preservation: Identifies core elements to maintain despite changes
  • Alternative Development: Creates new options for problematic elements
  • Revision Strategy: Plans systematic approach to implementing changes

External Actions

  • Copy Revision: Implements changes based on consolidated feedback
  • Legal Consultation: Collaborates with Evelyn Enforcer on compliance solutions
  • Design Coordination: Works with Marcus Designer on copy-visual alignment
  • Version Control: Manages document versions in content management system
  • Stakeholder Communication: Updates team on revision approach

Decision Procedure

Goal Setting:

  • Address all critical client feedback while maintaining creative strength
  • Resolve 100% of legal compliance issues
  • Incorporate data insights from A/B testing
  • Maintain copy-visual integration despite changes
  • Deliver final assets ready for production

Planning:

  • Categorize revisions by complexity and impact
  • Address compliance issues first as non-negotiable changes
  • Implement data-driven optimizations from testing
  • Develop creative solutions for subjective feedback
  • Create comprehensive change documentation

Prioritization Framework:

  • Legal compliance (must address with no exceptions)
  • Client strategic concerns (high priority to resolve)
  • Performance data insights (implement where beneficial)
  • Stylistic preferences (address while maintaining voice)
  • Minor wording changes (implement as capacity allows)

Conflict Resolution Approach:

  • When feedback conflicts with best practices, provide educative context
  • When stakeholders disagree, prioritize client and legal requirements
  • When creative integrity is at risk, offer alternative solutions
  • When changes impact timeline, coordinate with Theo Scheduler

Outputs

  • Final copy assets delivered to Sophia Producer for production:

    • Approved headline and body copy for all channels
    • Copy formatted according to technical requirements
    • Metadata and usage guidelines
    • Version information and approval status
  • Client approval documentation for Elena Manager

  • Implementation specifications for campaign trafficking

  • Copy rationale document for client presentation support

  • Project retrospective notes for knowledge base and process improvement

Cross-Stage Memory Consolidation

After project completion, Nina Writer performs these knowledge management activities:

Long-Term Memory Updates

  • Episodic Memory: Records project history with timeline, stakeholders, and decisions
  • Semantic Memory: Updates financial services terminology database with new insights
  • Procedural Memory: Refines headline development process based on project learnings
  • Success Patterns: Tags effective approaches for future retrieval

Pattern Recognition

  • Identifies correlation between question-based headlines and higher engagement
  • Notes effective emotional triggers for financial services products
  • Maps successful compliance language patterns for future reference
  • Records client feedback patterns to anticipate in future projects

Knowledge Sharing

  • Contributes process improvements to Sophia Librarian
  • Shares financial services insights with other copywriters
  • Provides language pattern data to Iris Analyzer
  • Documents successful approaches for Noah Innovator

This complete workflow demonstrates how Nina Writer integrates all three CoALA cognitive components (memory, actions, and decision procedures) throughout a realistic copywriting assignment, showing specific inputs and outputs at each stage and the interlock with other agents in the Koya system.

What's inside

4 workflow stages (brief intake, headline development, body copy, revision) plus cross-stage memory consolidation, each with inputs, actions, decisions, and outputs

Change this for your project

  • Replace VeeDuvv/ai-native with your own repository name
  • Replace Vamsi Duvvuri with your own copyright holder name
  • Replace Nina Writer with your own agent name
  • Replace Refresh Financial and Freedom Banking with your own campaign details

Where it goes

Keep it in your repository where the agent or team that needs it will read it.

Worth borrowing

  • Separating internal actions (thinking) from external actions (tool use) makes agent behavior transparent
  • Explicit decision procedures with goal setting, planning, and evaluation criteria clarify how choices are made
  • Cross-stage memory consolidation turns project learnings into reusable knowledge for future work

Related Documents