Enterprise-quality consistency. Zero labor cost. No white backgrounds.
Getting Started | Agent Roster | Configuration | Documentation
The AI Agent Agency is a framework for organizing AI-assisted development around specialized agent personas. Instead of one general-purpose AI assistant, you build a team of specialists—each with defined roles, distinct personalities, file ownership, and automated audit protocols.
Think of it as staffing a virtual game studio where every agent has a desk in your penthouse suite, and they never approve white backgrounds.
| Traditional AI Use | Agent Agency Approach |
|---|---|
| One assistant for everything | Specialized experts per domain |
| Context resets each conversation | Persistent protocols and standards |
| Ad-hoc quality checking | Automated weekly audits |
| Unclear responsibilities | Explicit file ownership |
| Inconsistent enforcement | Codified rules with red flags |
| Agent | Role | Audit Day | Domain |
|---|---|---|---|
| Vidette | Chief Video & Image Display Integrity Officer | Monday | YouTube grids, playlists, aspect ratios, thumbnails |
| Bloggie | Chief Blog Page Design & Consistency Officer | Tuesday | Blog structure, tags, SEO, share buttons |
| GraphViz | Chief Visual Harmony & Theme System Architect | Wednesday | Color palettes, themes, glass effects, WCAG |
| GamerGirl | Chief Gaming Content & Game Page Integrity Officer | Thursday | Game pages, platform CTAs, hero sections |
| DivineDesign | Chief Site-Wide Design & Page Architecture Officer | Friday | Layout, UX/UI, visual hierarchy, spacing |
Friday PM: Implementation day—all agents collaborate to fix flagged issues.
See individual agent files in agents/ for complete profiles, validation checklists, and red flags.
git clone https://github.com/jenninexus/Agency.git
cd Agency
cp .config/mcp_agents.example.json .config/mcp_agents.jsoncp templates/AGENT-TEMPLATE.md agents/YourAgent.md@GraphViz.md - Review this CSS for theme compliance
@Bloggie.md - Check this blog post structure
@GamerGirl.md - Audit the game page layout
Open ai-agent-agency.code-workspace in VS Code for the full penthouse studio experience.
The workspace includes settings for the shalldie.background extension to display agent artwork behind your code.
- Install the recommended extension when prompted (or search
shalldie.background) - Update the image URL in the workspace file:
Or use a local absolute path:
"background.customImages": [ "https://raw.githubusercontent.com/jenninexus/Agency/main/agents/images/GraphViz.jpg" ]
file:///C:/Github/Agency/agents/images/GraphViz.jpg - Reload VS Code - you may see a "corrupted" warning (this is normal, click "Don't show again")
- Add more agent images to
agents/images/for a slideshow - the extension cycles every 30 seconds
All agent metadata, schedules, and coordination rules live in a single source of truth:
| File | Purpose |
|---|---|
.config/mcp_agents.json |
Master configuration—agents, schedules, rules |
.config/mcp_agents.example.json |
Template for new projects |
- No white backgrounds — Light mode uses lavender
#F9F3FB - CSS variables over hex — Theme-aware always
- No inline styles — All styling via CSS classes
- Test both themes — Light and dark mode verification
- Document changes — Update agent changelog
| Context | Allowed | Banned |
|---|---|---|
| Light Background | #F9F3FB |
#FFFFFF, #FAFAFA, #F8F9FA, #F7F7F7 |
| Dark Background | #121218 |
Pure black #000000 |
Agency/
├── README.md # You are here
├── ai-agent-agency.code-workspace # VS Code workspace config
│
├── .config/
│ ├── mcp_agents.json # Your master configuration
│ └── mcp_agents.example.json # Generic template
│
├── agents/ # Agent profiles
│ ├── Vidette.md
│ ├── Bloggie.md
│ ├── GraphViz.md
│ ├── GamerGirl.md
│ ├── DivineDesign.md
│ └── images/
│ └── GraphViz.jpg # Agent artwork
│
├── docs/ # Extended documentation
│ ├── AGENT-GUIDE.md # Character creation guide
│ ├── SCHEDULE.md # Weekly audit cadence
│ ├── PROMPTS.md # AI image generation prompts
│ └── OPTIMIZATION-IDEAS.md # IDE integration strategies
│
├── templates/
│ └── AGENT-TEMPLATE.md # Blank agent template
│
├── examples/
│ └── StyleGuard.md # Example working agent
│
├── scripts/ # Audit automation scripts
│ └── .gitkeep
│
└── audits/ # Generated audit reports
└── .gitkeep
| Document | Description |
|---|---|
docs/AGENT-GUIDE.md |
Character creation guide with AI image prompts |
docs/SCHEDULE.md |
Weekly audit schedule template |
docs/PROMPTS.md |
AI-generated character prompts for agent artwork |
docs/OPTIMIZATION-IDEAS.md |
VS Code & Claude integration workflows |
templates/AGENT-TEMPLATE.md |
Full agent profile template |
examples/StyleGuard.md |
Working example agent |
// @GRAPHVIZ: Theme compliance required - no white backgrounds
// @VIDETTE: Video grid requires 16:9 aspect ratio enforcement
// @GAMERGIRL: Game page needs hero section with platform CTAsgit commit -m "[GRAPHVIZ] Updated dark mode glass effects"
git commit -m "[BLOGGIE] Fixed tag system to use anchor tags"When multiple agents collaborate, use the coordination matrix in .config/mcp_agents.json to identify dependencies.
{
"label": "Run GraphViz Audit",
"type": "shell",
"command": "powershell -File scripts/audit-styles.ps1"
}on:
schedule:
- cron: '0 9 * * 1' # Monday 9am - Vidette's audit day
jobs:
audit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: ./scripts/audit-video-pages.shThe Agency framework works seamlessly with Claude Code (Anthropic's CLI) and similar AI coding assistants.
CLAUDE.md Integration:
Add agent references to your project's CLAUDE.md for automatic context:
## Agent Team
- 5 AI agents with weekly audit schedules
- Agent profiles: `agents/*.md`
- Master config: `.config/mcp_agents.json`
- Audit scripts: `scripts/audit-*.ps1`
- Audit results: `audits/AUDIT_*.md`Claude Code Skills (Slash Commands):
Create custom skills in .claude/commands/ for agent operations:
.claude/commands/
├── agent-supervisor.md # Full audit + health dashboard
├── agent-audit.md # Quick-run specific agent audit
└── agent-status.md # Status check without running audits
Direct Agent Invocation:
Read @GraphViz.md and audit src/styles/ for theme compliance
Run the Wednesday audit checklist from @GraphViz.md
@Vidette.md audit the video pages for duplicate script loads
Environment Variables:
Copy .env.example to .env and configure paths for your project:
cp .env.example .env
# Edit .env with your project pathsThe audit scripts use these paths automatically via _audit-common.ps1.
| Agent | Role | Status |
|---|---|---|
| Codex | Build System & DevOps | Planned |
| Tagster | Tag System Specialist | Planned |
| Metrica | Analytics & SEO | Planned |
| Linklord | External Links & APIs | Planned |
| Docster | Documentation Manager | Planned |
| Testrix | Testing & QA | Planned |
"Investors don't fund white backgrounds." — GraphViz
The AI Agent Agency isn't just organization—it's a mindset:
- Specialize — Create experts, not generalists
- Automate — Weekly audits catch drift before it compounds
- Document — Explicit rules beat implicit assumptions
- Coordinate — Clear ownership prevents conflicts
- Iterate — Add agents as your project grows
This framework is designed to be adapted:
- Create and share new agent templates
- Add audit script examples
- Improve documentation
- Share your agent team configurations
MIT License — Use freely, modify as needed.
Built for developers who demand professional quality on any budget.
We don't cut corners. We optimize them.