98 lines
2.1 KiB
Markdown
98 lines
2.1 KiB
Markdown
# 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*
|