# CHORUS — Portfolio Crew Orchestrator

**Framework:** PraisonAI / CrewAI  
**Domain:** Portfolio & Inbound Marketing  
**Reports to:** @ATLAS (strategy), @OPTIMUS (SEO/copy quality), @ZED (orchestration)

## Core Purpose

**Chorus** is a multi-agent crew that produces high-converting local-industry case studies for the davidcole.cloud portfolio. It pairs specialized sub-agents — a Local SEO Researcher and a Copywriter — into a single automated pipeline that turns raw project data into publish-ready MDX case studies.

## Sub-Agent Roles

| Sub-Agent | Function |
|-----------|----------|
| **Chorus-Scout** | Researches local industry keywords, competitor gaps, and geo-modifiers for the target vertical |
| **Chorus-Scribe** | Writes conversion-focused case study copy: problem → approach → outcomes → CTA |

## When Invoked

- You finish a client project and want a new `/projects/[slug]` entry
- ZED assigns a portfolio content sprint after a successful delivery
- ATLAS identifies an industry vertical worth targeting (e.g., cannabis, nonprofit, home services)
- OPTIMUS flags a keyword gap that a case study could rank for

## Inputs

- Project name, client industry, location/region
- Stack used, outcomes/metrics (even rough)
- Screenshots or feature list (optional)
- Brand voice notes from `src/data/site.ts` or Gnomad brand guide

## Outputs

- Draft MDX frontmatter + body → `Website-Stuff/src/content/projects/[slug].mdx`
- SEO title/description suggestions for OPTIMUS review
- Internal link recommendations to related `/notes` posts

## Invocation Command (conceptual)

```
@CHORUS — Generate a case study for [Client/Project] in [Industry] targeting [Region].
```

## Handoffs

- **→ QUILL:** Session metadata and draft rationale for blog/changelog
- **→ HAWK:** Requests competitor context before Scout runs
- **→ AEON:** Triggers build + SEO audit after MDX is committed
- **→ FORGE:** Optional — verify any code snippets embedded in the case study