Update WriteUp.md

Author: shupandee

Automated_breif_Pipeline/WriteUp.md

@@ -1,65 +1,232 @@
 # AI Content Pipeline Agent
-AI Automation Intern Assignment – Scrollhouse
+AI Automation Intern Assignment — Scrollhouse
 
-This project builds an **AI agent that automates the Content Brief → Script Pipeline** for Scrollhouse, a short-form video content company.
+Author: Deepanshu  
+Problem Chosen: Content Brief → Script Pipeline
 
-The agent automatically converts a **client brief into a structured internal brief and script draft**, eliminating the manual rewriting step currently done by the operations team.
+---
+
+# 1. Why I Picked This Problem
+
+I chose the **Content Brief → Script Pipeline** problem because it is the most suitable task for automation and offers immediate operational impact.
+
+From the operations manager's description:
+
+- 40–60 briefs are processed every month
+- Each brief takes 20–30 minutes to rewrite manually
+
+Using an average estimate:
+
+50 briefs × 25 minutes per brief  
+= **1250 minutes per month**
+
+That equals **~21 hours of manual work every month** spent simply rewriting briefs.
+
+This work does not require creative decision making — it is mostly **reformatting and structuring information**, which makes it an ideal task for an AI system.
+
+Automating this step removes repetitive work from the team and allows them to focus on more valuable creative tasks.
+
+---
+
+# 2. How the Solution Works
+
+I built an **AI Content Pipeline Agent** that converts a raw client brief into Scrollhouse's internal brief format and generates a first script draft for the scriptwriter.
+
+The agent replaces the manual rewriting step currently done by a team member.
 
 ---
 
-# Problem Selected
+## System Flow
+
+Client submits brief  
+↓  
+AI Agent processes the brief  
+↓  
+Structured internal brief generated  
+↓  
+Script draft generated  
+↓  
+Output ready for scriptwriter
 
-## Content Brief → Script Pipeline
+---
 
-Current workflow at Scrollhouse:
+# Example Workflow
 
-1. Client fills a Google Form with their content brief
-2. A team member reads the form
-3. They manually rewrite it into the internal Notion brief format
-4. The brief is sent to the scriptwriter
+## Input (Client Brief)
 
-This process takes **20–30 minutes per brief** and is purely manual.
+Example brief submitted by a client:
 
-The operations manager described this task as **“soul-destroying” repetitive work**.
+Brand: GymFuel  
+Product: Protein Shake  
+Platform: Instagram Reel  
+Audience: Fitness beginners  
+Tone: Motivational  
+Goal: Product awareness
 
 ---
 
-# Why I Chose This Problem
+## AI Processing
 
-I evaluated the four problems in the scenario and selected the one with:
+The AI agent analyzes the brief and restructures the information into Scrollhouse's internal brief format.
 
-• High automation potential  
-• Low engineering complexity  
-• Immediate operational impact  
+It also generates a script outline so the scriptwriter can start working immediately.
+
+---
 
-### Time Cost Analysis
+## Output (Generated by the Agent)
+
+Internal Content Brief
+
+Hook  
+"Still skipping protein after your workouts?"
+
+Key Message  
+GymFuel protein helps beginners recover faster.
+
+Script Outline
+
+Scene 1 — Person finishing a workout  
+Scene 2 — Talking about recovery importance  
+Scene 3 — Product introduction  
+Scene 4 — Call to action
+
+Call to Action  
+Start your fitness journey with GymFuel.
+
+---
+
+# 3. Architecture
+
+The system was intentionally designed to be simple and easy to maintain.
+
+Architecture Overview:
+
+Client Brief Input  
+↓  
+Python Automation Script  
+↓  
+Gemini API (AI reasoning + formatting)  
+↓  
+Structured Brief + Script Output
+
+---
+
+# Tech Stack
+
+Development: Python  
+Editor: VS Code  
+AI Model: Gemini API  
+Data Input: Form-style structured text (simulating Google Form response)
+
+This design avoids unnecessary complexity and focuses on the core automation.
+
+---
 
-From the operations manager:
+# Error Handling
 
-- 40–60 briefs processed per month
-- 20–30 minutes per brief
+The agent includes basic safeguards for common issues:
+
+• Missing information in briefs  
+• Poorly structured inputs  
+• API request failures  
+
+The AI model attempts to infer missing context where possible.
+
+---
+
+# 4. What It Replaces
+
+Current process:
+
+1. Team member reads Google Form response  
+2. Rewrites the brief into internal format  
+3. Sends it to the scriptwriter
+
+This process takes **20–30 minutes per brief**.
+
+---
+
+# 5. Time Saved
 
 Average calculation:
 
-50 briefs × 25 minutes  
-= **1250 minutes per month**
+50 briefs per month  
+× 25 minutes per brief
+
+= **1250 minutes**
+
+= **~21 hours saved per month**
+
+The automation reduces the processing time to approximately **10–20 seconds per brief**.
+
+This allows the team member to focus on higher-value tasks such as improving script quality or developing creative ideas.
+
+---
+
+# 6. Limitations
 
-= **~21 hours of manual work per month**
+This is an MVP built within the assignment time limit.
 
-This task involves **reformatting and rewriting information**, which is exactly the type of work large language models perform well.
+Some features that would be added in a production system include:
+
+• Direct integration with Google Forms  
+• Automatic writing to Notion  
+• Automatic assignment to scriptwriters  
+• Logging and monitoring
+
+---
+
+# 7. What I Would Build Next
+
+If I joined Scrollhouse and had two weeks, I would automate the **Content Approval Loop**.
+
+Currently scripts are sent through email or WhatsApp and there is no centralized tracking.
+
+This causes:
+
+• Missed approvals  
+• Delayed feedback  
+• Missed deadlines
 
 ---
 
-# Solution
+## Proposed Solution
+
+Build a **Script Approval Tracker Agent** that:
+
+• Tracks all scripts in a central system  
+• Sends reminders to clients automatically  
+• Updates script status (Approved / Rejected / Pending)  
+• Provides a dashboard for the team
 
-I built an **AI Content Pipeline Agent** that automatically:
+Example dashboard:
 
-1. Reads a client brief
-2. Converts it into Scrollhouse's internal structured brief format
-3. Generates a script draft for the scriptwriter
+Client | Script | Status  
+Brand A | Reel 12 | Waiting for Approval  
+Brand B | Reel 8 | Approved  
+Brand C | Reel 5 | Revision Requested  
 
-The system removes the manual middle step entirely.
+This would significantly improve operational visibility and reduce missed deadlines.
 
 ---
 
-# System Workflow
+# 8. Demo Recording
+
+The screen recording demonstrates:
+
+1. Inputting a client brief
+2. Running the AI agent
+3. Generating the internal brief
+4. Generating the script output
+
+Note: Due to **Gemini API credit limits**, the full run of the automation is shown once in the demo recording. The code remains fully functional and can process additional briefs once API credits are available.
+
+---
+
+# Summary
+
+The **AI Content Pipeline Agent** automates the transformation from:
+
+Client Brief → Internal Brief → Script Draft
+
+This removes repetitive manual work, saves approximately **21 hours per month**, and improves the efficiency of the content production pipeline.