# AGENTS.md

# Yellow Frames

AI Coding & Content Agent Instructions

---

## Project Overview

Yellow Frames is a creative production and digital marketing agency specializing in:

- AI Content Creation
- CGI & 3D Animation
- Photography
- Videography
- Branding
- Motion Graphics
- Website Development
- Social Media Marketing
- Post Production
- Creative Campaigns

The website showcases services, portfolio, blogs, and lead generation pages.

Primary Goal:

Generate qualified business leads through high-quality content, SEO, fast performance, and excellent user experience.

---

# Brand Voice

Always write content that is:

- Creative
- Professional
- Premium
- Human
- Modern
- Simple
- SEO Friendly
- Conversion Focused

Avoid:

- Corporate jargon
- Keyword stuffing
- Generic AI phrases
- Over-promotional language

---

# Target Audience

Primary:

- D2C Brands
- E-commerce Businesses
- Startups
- SMEs
- Enterprises

Industries:

- Fashion
- Beauty
- FMCG
- Healthcare
- Real Estate
- Food & Beverage
- Manufacturing
- Technology

---

# Services

Current Services include:

- Photography
- Videography
- CGI & AI Visuals
- 3D Animation
- Branding & Design
- Website Development
- Motion Graphics
- Social Media Marketing
- Post Production

Whenever generating new content:

Always connect benefits with business outcomes.

Example:

Instead of

"We create videos."

Use

"We create high-converting videos that improve engagement, increase brand recall, and drive sales."

---

# Website Structure

Home

About

Services

Portfolio

Photography

Videography

CGI & AI

3D Animation & Graphics

Blog

Contact

Privacy Policy

---

# SEO Guidelines

## Titles

50–60 characters

Include primary keyword

Include brand when possible

Example:

CGI Product Rendering Services | Yellow Frames

---

## Meta Descriptions

140–160 characters

Include:

- Primary keyword
- Business benefit
- CTA

---

## Heading Structure

One H1 only

Use H2 for sections

Use H3 for supporting content

Avoid skipping heading hierarchy.

---

## Keyword Usage

Primary keyword:

- First paragraph
- H1
- Meta title
- Meta description
- One H2
- URL slug (where applicable)

Use semantic keywords naturally.

---

# Image Guidelines

Every image must include:

## File Name

keyword-separated-with-hyphens.webp

Example

product-photography-mumbai.webp

## Alt Text

Describe the image naturally.

Good:

Luxury watch product photography for ecommerce brand

Bad:

image1

photo

watch

---

# Internal Linking

Always link to relevant pages.

Examples:

Photography → Videography

CGI → 3D Animation

Website Development → Branding

Blog → Related Services

---

# Blog Writing Rules

Word Count:

800–1500 words

Structure:

Introduction

Problem

Solution

Benefits

Examples

FAQs

Conclusion

CTA

Always include:

- Internal links
- FAQ section
- CTA

---

# CTA Style

Use action-oriented CTAs.

Examples:

Let's Build Your Brand

Book a Free Consultation

Start Your Creative Project

Talk to Our Experts

Get a Custom Quote

---

# Accessibility

Always ensure:

- Images have alt text
- Buttons have accessible labels
- Forms have labels
- Proper heading hierarchy
- Keyboard navigation
- WCAG compliance

---

# Performance

Prefer:

- WebP images
- Lazy loading
- Minified assets
- Responsive images
- Deferred JavaScript

Avoid:

- Large images
- Render-blocking scripts
- Unused CSS

---

# Code Standards

HTML

- Semantic HTML5
- Accessible markup
- Clean indentation

CSS

- Mobile First
- Reusable classes
- Avoid inline styles

JavaScript

- Modular
- Comment complex logic
- Avoid global variables

---

# Schema Markup

Use structured data where applicable:

- Organization
- Local Business
- Service
- Breadcrumb
- FAQ
- BlogPosting
- ImageObject
- VideoObject
- WebSite
- WebPage

Validate before deployment.

---

# Forms

Lead forms should include:

- Name
- Email
- Phone
- Service Selection
- Message

Validation:

- Required fields
- Accessible error messages
- Spam protection

---

# AI Content Rules

Never publish AI-generated content without human review.

Always:

- Fact-check
- Improve readability
- Add original insights
- Optimize for EEAT

---

# Content Principles

Every page should answer:

Who is this for?

What problem does it solve?

Why choose Yellow Frames?

How can visitors get started?

---

# Design Principles

Maintain:

- Minimal UI
- Premium look
- Strong typography
- High-quality visuals
- Consistent spacing
- Fast loading

---

# Git Commit Convention

feat:

fix:

docs:

style:

refactor:

perf:

seo:

content:

Example:

feat: add CGI service landing page

seo: optimize photography metadata

fix: improve contact form accessibility

---

# Pre-Deployment Checklist

- Meta title added
- Meta description added
- Canonical URL
- Open Graph tags
- Twitter tags
- Schema validated
- Images optimized
- Alt text added
- Internal links checked
- Accessibility tested
- Mobile responsive
- Core Web Vitals reviewed

---

# Agent Behavior

When generating content or code:

1. Prioritize SEO.
2. Maintain brand consistency.
3. Follow accessibility best practices.
4. Optimize for performance.
5. Produce production-ready output.
6. Never invent client testimonials or case studies.
7. Keep content human-first and conversion-focused.

---

End of AGENTS.md