Documentation Index Fetch the complete documentation index at: https://mintlify.com/msitarzewski/agency-agents/llms.txt
Use this file to discover all available pages before exploring further.
Understanding Agent Deliverables
Agency agents don’t just provide advice - they produce concrete, usable outputs that drive your project forward.
What Are Deliverables?
Deliverables are the tangible outputs an agent produces. Not vague guidance, but real artifacts you can use immediately.
Code & Implementation Production-ready code with tests and documentation
Documentation Architecture decisions, specifications, and guides
Analysis & Reports Data analysis, test results, and insights
Designs & Assets Design systems, components, and visual assets
Deliverable Categories
1. Code Deliverables
Production-ready code that solves real problems.
Frontend Developer
Backend Architect
DevOps Automator
Component Libraries // Modern React component with performance optimization
import React , { memo , useCallback } from 'react' ;
import { useVirtualizer } from '@tanstack/react-virtual' ;
interface DataTableProps {
data : Array < Record < string , any >>;
columns : Column [];
onRowClick ?: ( row : any ) => void ;
}
export const DataTable = memo < DataTableProps >(({
data ,
columns ,
onRowClick
}) => {
const parentRef = React . useRef < HTMLDivElement >( null );
const rowVirtualizer = useVirtualizer ({
count: data . length ,
getScrollElement : () => parentRef . current ,
estimateSize : () => 50 ,
overscan: 5 ,
});
const handleRowClick = useCallback (( row : any ) => {
onRowClick ?.( row );
}, [ onRowClick ]);
return (
< div
ref = { parentRef }
className = "h-96 overflow-auto"
role = "table"
aria-label = "Data table"
>
{ rowVirtualizer . getVirtualItems (). map (( virtualItem ) => {
const row = data [ virtualItem . index ];
return (
< div
key = { virtualItem . key }
className = "flex items-center border-b hover:bg-gray-50"
onClick = { () => handleRowClick ( row ) }
role = "row"
tabIndex = { 0 }
>
{ columns . map (( column ) => (
< div key = { column . key } className = "px-4 py-2 flex-1" role = "cell" >
{ row [ column . key ] }
</ div >
)) }
</ div >
);
}) }
</ div >
);
});
Includes :
TypeScript types
Performance optimization (virtualization)
Accessibility (ARIA labels, keyboard support)
Modern React patterns (hooks, memo)
Responsive design considerations
API Implementation // RESTful API with validation and error handling
import { Router } from 'express' ;
import { z } from 'zod' ;
import { authenticateToken , authorize } from '../middleware/auth' ;
import { TaskService } from '../services/task.service' ;
const router = Router ();
const taskService = new TaskService ();
// Validation schema
const createTaskSchema = z . object ({
title: z . string (). min ( 1 ). max ( 200 ),
description: z . string (). max ( 2000 ). optional (),
priority: z . enum ([ 'low' , 'medium' , 'high' ]),
dueDate: z . string (). datetime (). optional (),
});
// GET /api/tasks
router . get ( '/' ,
authenticateToken ,
async ( req , res , next ) => {
try {
const tasks = await taskService . findByUser ( req . user . id );
res . json ({ data: tasks });
} catch ( error ) {
next ( error );
}
}
);
// POST /api/tasks
router . post ( '/' ,
authenticateToken ,
async ( req , res , next ) => {
try {
const validated = createTaskSchema . parse ( req . body );
const task = await taskService . create ({
... validated ,
userId: req . user . id ,
});
res . status ( 201 ). json ({ data: task });
} catch ( error ) {
next ( error );
}
}
);
export default router ;
Includes :
Input validation (Zod)
Authentication & authorization
Error handling
RESTful conventions
TypeScript types
CI/CD Pipeline # GitHub Actions workflow
name : CI/CD Pipeline
on :
push :
branches : [ main , develop ]
pull_request :
branches : [ main ]
jobs :
test :
runs-on : ubuntu-latest
steps :
- uses : actions/checkout@v3
- name : Setup Node.js
uses : actions/setup-node@v3
with :
node-version : '18'
cache : 'npm'
- name : Install dependencies
run : npm ci
- name : Run linter
run : npm run lint
- name : Run tests
run : npm run test:ci
- name : Check coverage
run : npm run test:coverage
- name : Build
run : npm run build
deploy :
needs : test
if : github.ref == 'refs/heads/main'
runs-on : ubuntu-latest
steps :
- uses : actions/checkout@v3
- name : Deploy to production
run : |
echo "Deploying to production..."
# Add deployment commands here
Includes :
Automated testing
Code quality checks
Build verification
Conditional deployment
Environment-specific workflows
2. Design Deliverables
Visual and interaction design assets.
Whimsy Injector - Micro-Interaction System
/* Delightful Button Interactions */
.btn-whimsy {
position : relative ;
overflow : hidden ;
transition : all 0.3 s cubic-bezier ( 0.23 , 1 , 0.32 , 1 );
&::before {
content : '' ;
position : absolute ;
top : 0 ;
left : -100 % ;
width : 100 % ;
height : 100 % ;
background : linear-gradient (
90 deg ,
transparent ,
rgba ( 255 , 255 , 255 , 0.2 ),
transparent
);
transition : left 0.5 s ;
}
& :hover {
transform : translateY ( -2 px ) scale ( 1.02 );
box-shadow : 0 8 px 25 px rgba ( 0 , 0 , 0 , 0.15 );
&::before {
left : 100 % ;
}
}
& :active {
transform : translateY ( -1 px ) scale ( 1.01 );
}
}
/* Progress Celebration */
.progress-celebration {
position : relative ;
&. completed ::after {
content : '🎉' ;
position : absolute ;
top : -10 px ;
left : 50 % ;
transform : translateX ( -50 % );
animation : celebrate 1 s ease-in-out ;
font-size : 24 px ;
}
}
@keyframes celebrate {
0% {
transform : translateX ( -50 % ) translateY ( 0 ) scale ( 0 );
opacity : 0 ;
}
50% {
transform : translateX ( -50 % ) translateY ( -20 px ) scale ( 1.5 );
opacity : 1 ;
}
100% {
transform : translateX ( -50 % ) translateY ( -30 px ) scale ( 1 );
opacity : 0 ;
}
}
Purpose : Add delight while maintaining usabilityMetrics : 40% reduction in task completion anxiety
Brand Guardian - Brand Identity Framework
# Brand Identity Framework
## Visual Identity
### Color Palette
**Primary** : #2563EB (Blue 600)
- Use: CTAs, primary actions, brand elements
- Accessibility: AA compliant with white text
**Secondary** : #7C3AED (Purple 600)
- Use: Accents, highlights, secondary actions
- Pairs well with primary for contrast
**Neutral** : #64748B (Slate 500)
- Use: Body text, secondary content
- Provides professional, readable base
### Typography
**Headings** : Inter, sans-serif
- Bold weight for impact
- Clear hierarchy (H1: 48px, H2: 36px, H3: 24px)
**Body** : Inter, sans-serif
- Regular weight for readability
- 16px base size, 1.5 line height
## Brand Voice
### Personality
- **Professional** but approachable
- **Confident** but not arrogant
- **Helpful** but not condescending
- **Innovative** but grounded
### Tone Guidelines
**Do** : "Let's build something amazing together"
**Don't** : "We're the best, everyone else is wrong"
**Do** : "Here's how to solve that problem"
**Don't** : "Obviously, you should do this"
Purpose : Ensure brand consistency across all touchpoints
UI Designer - Component Library
Design system with reusable components:
Buttons : Primary, secondary, ghost, danger variants
Forms : Input fields, textareas, selects, checkboxes, radios
Cards : Content cards, profile cards, stat cards
Navigation : Headers, sidebars, breadcrumbs, tabs
Feedback : Alerts, toasts, modals, tooltips
Data Display : Tables, lists, badges, avatars
Each component includes:
Figma design file
Code implementation
Usage guidelines
Accessibility notes
Responsive behavior
3. Analysis & Report Deliverables
Data-driven insights and assessments.
# Integration Agent Reality-Based Report
## 🔍 Reality Check Validation
**Commands Executed** :
- ls -la resources/views/
- grep -r "premium" . --include="*.html"
- ./qa-playwright-capture.sh http://localhost:8000
**Evidence Captured** :
- 12 screenshots (desktop, tablet, mobile)
- 8 interaction sequences (before/after)
- test-results.json with performance metrics
## 📸 Complete System Evidence
**Visual Documentation** :
- responsive-desktop.png: 1920x1080 full page
- responsive-tablet.png: 768x1024 full page
- responsive-mobile.png: 375x667 full page
- nav-before-click.png / nav-after-click.png
- form-empty.png / form-filled.png
**What System Actually Delivers** :
- Basic dark theme implementation (not "luxury" as claimed)
- Responsive layout works on desktop and tablet
- Mobile layout breaks at 375px width
- Navigation smooth scroll functions correctly
- Contact form accepts input but lacks validation feedback
## 🧪 Integration Testing Results
**End-to-End User Journeys** : PARTIAL PASS
- Homepage load: PASS (1.2s load time)
- Navigation: PASS (smooth scroll works)
- Mobile responsive: FAIL (broken layout < 400px)
- Form submission: NEEDS WORK (no validation feedback)
## 📊 Comprehensive Issue Assessment
**Issues from QA Still Present** :
1. Mobile layout broken on iPhone SE (375px width)
2. Form validation feedback missing
3. Accordion animation jerky on mobile
**New Issues Discovered** :
1. Footer links not keyboard accessible (missing focus states)
2. Color contrast fails WCAG AA on secondary buttons
**Critical Issues** : 1 (mobile layout)
**Medium Issues** : 4 (accessibility, validation)
## 🎯 Realistic Quality Certification
**Overall Quality Rating** : B-
**Design Implementation Level** : Good (not luxury)
**System Completeness** : 85% of spec implemented
**Production Readiness** : NEEDS WORK
## 🔄 Deployment Readiness Assessment
**Status** : NEEDS WORK
**Required Fixes Before Production** :
1. Fix mobile layout for < 400px viewports (screenshot: responsive-mobile.png)
2. Add form validation feedback (screenshot: form-filled.png shows no feedback)
3. Add keyboard focus states for footer links (accessibility requirement)
**Timeline for Production Readiness** : 2-3 days
**Revision Cycle Required** : YES (expected for quality improvement)
---
**Integration Agent** : RealityChecker
**Assessment Date** : 2026-03-04
**Evidence Location** : public/qa-screenshots/
**Re-assessment Required** : After fixes implemented
Characteristics :
Evidence-based (screenshots, data)
Realistic ratings (B- not A+)
Specific issues with visual proof
Clear path to production
# Analytics Performance Report
## Week of March 4, 2026
## 📈 Key Metrics
| Metric | Current | Previous | Change | Target |
|--------|---------|----------|--------|--------|
| Daily Active Users | 12,450 | 11,200 | +11.2% | 15,000 |
| Weekly Active Users | 34,890 | 32,100 | +8.7% | 40,000 |
| Avg Session Duration | 8m 34s | 7m 12s | +19.1% | 10m |
| Bounce Rate | 42% | 48% | -12.5% | <40% |
| Conversion Rate | 3.8% | 3.2% | +18.8% | 5% |
## 🔥 Top Performing Features
1. **Task Dashboard** (45% of sessions)
- 12m avg session duration
- 2.3 tasks created per session
- 89% return rate
2. **Collaboration** (32% of sessions)
- 3.4 team members invited per session
- Viral coefficient: 1.4
- 72% activation rate
3. **Mobile App** (28% of traffic)
- 15m avg session (75% higher than web)
- 4.5 / 5 star rating
- 68% daily retention
## 🚨 Areas Needing Attention
1. **Onboarding Drop-off**
- 35% abandon at step 2
- Recommend: Simplify initial setup
- A/B test: Skip optional fields
2. **Search Functionality**
- 18% of searches return 0 results
- 52% of users abandon after failed search
- Action: Improve search algorithm
## 📊 Growth Trends
- User acquisition: +15% MoM
- Organic traffic: 62% of new users
- Referral traffic: 24% of new users
- Paid acquisition: 14% of new users
**Recommendation** : Increase investment in referral program
Characteristics :
Actionable insights
Trend analysis
Clear recommendations
Data visualization ready
# Performance Benchmark Report
## ⏱️ Load Time Analysis
| Page | P50 | P95 | P99 | Target | Status |
|------|-----|-----|-----|--------|--------|
| Homepage | 1.2s | 2.1s | 3.4s | <2.5s | ✅ PASS |
| Dashboard | 1.8s | 3.2s | 4.8s | <2.5s | ❌ FAIL |
| Task Detail | 0.9s | 1.6s | 2.1s | <2.5s | ✅ PASS |
| Settings | 1.1s | 1.9s | 2.4s | <2.5s | ✅ PASS |
## 🚀 Core Web Vitals
**Largest Contentful Paint (LCP)** :
- Desktop: 1.8s (✅ Good)
- Mobile: 2.9s (🟡 Needs Improvement)
- Target: <2.5s
**First Input Delay (FID)** :
- Desktop: 45ms (✅ Good)
- Mobile: 78ms (✅ Good)
- Target: <100ms
**Cumulative Layout Shift (CLS)** :
- Desktop: 0.05 (✅ Good)
- Mobile: 0.12 (❌ Poor)
- Target: <0.1
## 🔧 Optimization Recommendations
1. **Dashboard Performance** (Priority: HIGH)
- Issue: Large data table causing 3.2s P95 load time
- Fix: Implement virtualization (react-virtual)
- Expected improvement: -60% load time
2. **Mobile LCP** (Priority: MEDIUM)
- Issue: Hero image 2.4MB unoptimized
- Fix: Convert to WebP, add responsive srcset
- Expected improvement: -40% LCP
3. **Mobile CLS** (Priority: HIGH)
- Issue: Font loading causes layout shift
- Fix: Use font-display: swap, add size-adjust
- Expected improvement: CLS < 0.1
## 📄 Load Testing Results
**Concurrent Users** : 1,000
**Duration** : 10 minutes
**Results** :
- Success rate: 99.8%
- Avg response time: 145ms
- P95 response time: 320ms
- Error rate: 0.2%
**Status** : ✅ PASS (meets 10x current traffic requirement)
Characteristics :
Specific measurements
Clear pass/fail criteria
Actionable recommendations
Expected improvements quantified
4. Strategic Deliverables
High-level plans and frameworks.
Growth Hacker - Acquisition Strategy
# User Acquisition Strategy
## Objective
Grow from 10K to 50K users in 90 days
Budget: $50K ($16.7K/month)
Target CAC: <$20
## Channel Strategy
### 1. Organic Social (40% budget)
**Platforms** : Twitter, LinkedIn, Reddit
**Tactics** :
- Daily thought leadership content
- Value-first Reddit engagement in 10 subreddits
- LinkedIn articles (2x/week)
- Twitter threads (3x/week)
**Expected** :
- 15K users
- CAC: $5.33
- Timeline: Ongoing
### 2. Content Marketing (30% budget)
**Tactics** :
- SEO-optimized blog posts (4x/week)
- Ultimate guides (2x/month)
- Guest posts on industry sites (4x/month)
- YouTube tutorials (2x/week)
**Expected** :
- 12K users
- CAC: $8.75
- Timeline: 60-90 days (SEO lag)
### 3. Referral Program (20% budget)
**Mechanics** :
- Give $10 credit, get $10 credit
- Viral coefficient target: 1.4
- Built-in sharing at key moments
**Expected** :
- 10K users
- CAC: $7.00
- Timeline: 30-90 days
### 4. Paid Acquisition (10% budget)
**Platforms** : Google Ads, Facebook, LinkedIn
**Tactics** :
- Retargeting campaigns
- Lookalike audiences
- High-intent keywords
**Expected** :
- 3K users
- CAC: $16.67
- Timeline: Immediate
## Success Metrics
- Total new users: 40K (80% of goal)
- Blended CAC: $12.50 (37.5% under target)
- Activation rate: >60%
- 30-day retention: >40%
## Risk Mitigation
- Test all channels at 10% budget first
- Pivot budget to best-performing channels weekly
- Monitor CAC daily, pause if exceeds $25
Sprint Prioritizer - Product Roadmap
# Q2 2026 Product Roadmap
## Sprint 1-2 (Weeks 1-4): Core Functionality
### Must Have (100% delivery)
1. User authentication (SSO + email)
- Impact: 10, Effort: 5, RICE: 100
2. Task CRUD operations
- Impact: 10, Effort: 3, RICE: 167
3. Basic dashboard
- Impact: 8, Effort: 4, RICE: 100
### Should Have (80% delivery)
4. Task filtering and search
- Impact: 7, Effort: 3, RICE: 117
5. Mobile responsive design
- Impact: 9, Effort: 5, RICE: 90
## Sprint 3-4 (Weeks 5-8): Collaboration
### Must Have
1. Team workspaces
- Impact: 9, Effort: 6, RICE: 75
2. Task assignments
- Impact: 8, Effort: 3, RICE: 133
3. Real-time updates
- Impact: 7, Effort: 7, RICE: 50
### Should Have
4. Comments and mentions
- Impact: 6, Effort: 4, RICE: 75
5. Activity feed
- Impact: 5, Effort: 3, RICE: 83
## Sprint 5-6 (Weeks 9-12): Growth
### Must Have
1. Referral system
- Impact: 10, Effort: 5, RICE: 100
2. Onboarding flow optimization
- Impact: 9, Effort: 3, RICE: 150
### Could Have
3. Integrations (Slack, email)
- Impact: 6, Effort: 6, RICE: 50
4. Advanced analytics
- Impact: 5, Effort: 5, RICE: 50
## Feature Parking Lot (Won't Have This Quarter)
- Custom workflows
- API access
- White-labeling
- Mobile apps (native)
Evaluating Deliverable Quality
Quality Checklist
Completeness
All required components included
Documentation provided
Examples and usage guidelines
Edge cases considered
Usability
Can be used immediately
No missing dependencies
Clear instructions
Works as expected
Quality
Follows best practices
Includes tests (where applicable)
Handles errors gracefully
Accessible and inclusive
Context
Explains why decisions were made
Documents trade-offs
Provides alternatives considered
Links to relevant resources
Red Flags
Watch out for these signs of poor deliverables:
Vague outputs : “I’ll help you with that” without concrete artifacts
Pseudo-code : Code that won’t actually run
Missing context : No explanation of decisions or trade-offs
No verification : Can’t prove it works or meets requirements
Incomplete : Missing key components or documentation
Next Steps
Workflows How agents produce deliverables
Agent Design Overall design philosophy
Use Cases See deliverables in action
Creating Agents Build agents with great deliverables