banatie-content/shared/assets-folder-standard.md

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:

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:

---
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

# 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 for detailed format.

---

Updated: 2025-01-07