# Assets Folder Standard

## Overview

Each article uses an assets folder for working files. The main article file serves as a "card" moving through the pipeline, while actual content lives in assets.

## Frontmatter

Add to the main article file:

```yaml
assets_folder: assets/{slug}/
```

## Folder Structure

```
assets/{slug}/
├── outline.md        # Article structure (@architect)
├── text.md           # Article body (@writer → @editor → @seo)
├── seo-metadata.md   # SEO title, description, keywords (@seo)
├── log-chat.md       # Agent activity log (all agents)
├── hero.png|.jpg     # Cover image
└── images/           # Screenshots, diagrams, illustrations
```

## Agent Workflow

| Stage | Agent | Reads | Writes |
|-------|-------|-------|--------|
| Planning | @architect | main file | `outline.md` |
| Drafting | @writer | `outline.md` | `text.md` |
| Editing | @editor | `text.md`, `log-chat.md` | `text.md`, `log-chat.md` |
| SEO | @seo | `text.md`, `log-chat.md` | `text.md`, `seo-metadata.md`, `log-chat.md` |
| Images | @image-gen | `text.md` | image specs, `log-chat.md` |

## Main Article File

Contains metadata and links only — NO duplicated content:

```markdown
---
title: "Article Title"
author: henry-technical
status: drafting
assets_folder: assets/my-article/
---

# Outline
See [outline.md](assets/my-article/outline.md)

# Draft
See [text.md](assets/my-article/text.md)

# SEO
See [seo-metadata.md](assets/my-article/seo-metadata.md)

# Activity Log
See [log-chat.md](assets/my-article/log-chat.md)
```

## SEO Metadata Format

```markdown
# SEO Metadata

## Title
[60 chars max, primary keyword included]

## Meta Description
[155 chars max, compelling, keyword included]

## Target Keywords
- Primary: [main keyword]
- Secondary: [2-3 related]

## URL Slug
[short-descriptive-slug]
```

## Image Naming

```
images/
├── diagram-{topic}.png
├── screenshot-{description}.png
├── illustration-{topic}.png
└── comparison-{topic}.png
```

## Log Chat

See [log-chat-format.md](log-chat-format.md) for detailed format.

---

*Updated: 2025-01-07*