Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

chore(blog): normalize metadata + resurrect 3 broken posts

Genera6adf9ee3a64
diff --git a/AGENTS.md b/AGENTS.md
index 3630decb0..71fc3c148 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -90,6 +90,20 @@ isNotNull(agentTaskQueue.sessionId)
.set({ attempts: sql`${verificationCode.attempts} + 1` })
```
+## Blog posts
+
+Posts live in `src/web/src/content/<slug>.mdx`; images live in `src/web/public/blog/<slug>/`.
+
+### Frontmatter
+Use `export const metadata = { ... }` — NOT YAML `---` frontmatter. The loader does a dynamic import and reads `mod.metadata`; MDX config has no `remark-frontmatter` plugin, so YAML blocks render as literal text and the post disappears from the listing.
+
+Required fields (see `src/web/src/lib/blog/types.ts`): `slug`, `title`, `date`, `author`, `excerpt`, `readingTime`. Missing any → post is skipped with a warning.
+
+### Images
+- Path: `src/web/public/blog/<slug>/<name>.<ext>`, referenced from MDX as `/blog/<slug>/<name>.<ext>`.
+- Naming: short semantic names (`hero.png`, `timeline.png`, `workflow-1-dev-team-pipeline.svg`). No date prefix. Don't repeat the slug — the parent directory already carries it.
+- Format: `png` for photos/screenshots, `svg` for diagrams, `webp` when compression matters. Pick one; don't mix formats for the same purpose in one post.
+
## Scrollbar
Always use the `thin-scrollbar` class alongside `overflow-y-auto` or `overflow-x-auto`. Never use bare overflow-auto without it.
diff --git a/src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-comparison.png b/src/web/public/blog/personal-ai-company/comparison.png
similarity index 100%
rename from src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-comparison.png
rename to src/web/public/blog/personal-ai-company/comparison.png
diff --git a/src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-org-chart.png b/src/web/public/blog/personal-ai-company/hero.png
similarity index 100%
rename from src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-org-chart.png
rename to src/web/public/blog/personal-ai-company/hero.png
diff --git a/src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-timeline.png b/src/web/public/blog/personal-ai-company/timeline.png
similarity index 100%
rename from src/web/public/blog/personal-ai-company/2026-06-10-personal-ai-company-timeline.png
rename to src/web/public/blog/personal-ai-company/timeline.png
diff --git a/src/web/src/content/ai-agent-orchestration.mdx b/src/web/src/content/ai-agent-orchestration.mdx
index 77c4d3d77..349722b6c 100644
--- a/src/web/src/content/ai-agent-orchestration.mdx
+++ b/src/web/src/content/ai-agent-orchestration.mdx
@@ -1,12 +1,12 @@
----
-title: "AI Agent Orchestration: What It Actually Is"
-description: "Multiple AI agents working together on tasks. Here's what works after 6 months of building these systems."
-author: "Alook Team"
-date: "2026-06-03"
-slug: "ai-agent-orchestration"
-keywords: ["AI agent orchestration", "multi-agent systems", "workflow automation", "agent coordination", "alook"]
-image: "/blog/ai-agent-orchestration/hero.png"
----
+export const metadata = {
+ slug: "ai-agent-orchestration",
+ title: "AI Agent Orchestration: What It Actually Is",
+ date: "2026-06-03",
+ author: "Alook Team",
+ excerpt:
+ "Multiple AI agents working together on tasks. Here's what works after 6 months of building these systems.",
+ readingTime: "4 min read",
+};
# AI Agent Orchestration: What It Actually Is
diff --git a/src/web/src/content/ai-agent-team.mdx b/src/web/src/content/ai-agent-team.mdx
index 4f4ae4cd0..64b4e106b 100644
--- a/src/web/src/content/ai-agent-team.mdx
+++ b/src/web/src/content/ai-agent-team.mdx
@@ -6,7 +6,6 @@ export const metadata = {
excerpt:
"Create your AI agent team without coding. Learn how managers can build, deploy, and orchestrate autonomous agents for sales, support, and operations.",
readingTime: "7 min read",
- image: "/blog/ai-agent-team/hero.png",
};
# Building Your AI Agent Team Without Code: A Manager's Guide
diff --git a/src/web/src/content/ai-agent-vs-chatbot.mdx b/src/web/src/content/ai-agent-vs-chatbot.mdx
index e0742dd48..d1c0ef769 100644
--- a/src/web/src/content/ai-agent-vs-chatbot.mdx
+++ b/src/web/src/content/ai-agent-vs-chatbot.mdx
@@ -1,12 +1,12 @@
----
-title: "AI Agent vs Chatbot: The Actual Difference"
-description: "Chatbots respond when you ask. Agents work while you sleep. Here's what I learned using both for 6 months."
-author: "Alook Team"
-date: "2026-06-03"
-slug: "ai-agent-vs-chatbot"
-keywords: ["AI agent vs chatbot", "AI agents", "chatbots", "automation", "alook"]
-image: "/blog/ai-agent-vs-chatbot/hero.png"
----
+export const metadata = {
+ slug: "ai-agent-vs-chatbot",
+ title: "AI Agent vs Chatbot: The Actual Difference",
+ date: "2026-06-03",
+ author: "Alook Team",
+ excerpt:
+ "Chatbots respond when you ask. Agents work while you sleep. Here's what I learned using both for 6 months.",
+ readingTime: "4 min read",
+};
# AI Agent vs Chatbot: The Actual Difference
diff --git a/src/web/src/content/claude-code-dynamic-workflow-alternative.mdx b/src/web/src/content/claude-code-dynamic-workflow-alternative.mdx
index 63c867eaa..e358e6f48 100644
--- a/src/web/src/content/claude-code-dynamic-workflow-alternative.mdx
+++ b/src/web/src/content/claude-code-dynamic-workflow-alternative.mdx
@@ -6,8 +6,6 @@ export const metadata = {
excerpt:
"Claude Code's dynamic workflows orchestrate 100+ agents from JavaScript. Powerful for one-shot tasks. But what if you need team coordination, persistent memory, or multi-day workflows? Compare script orchestration vs email-based coordination.",
readingTime: "4 min read",
- keywords: ["claude code alternative", "dynamic workflow", "open source", "agent orchestration", "email coordination", "alook"],
- image: "/blog/claude-code-dynamic-workflow-alternative/seo-team.png",
};
Claude Code shipped dynamic workflows last week. Write JavaScript, run 100+ agents, keep working.
diff --git a/src/web/src/content/how-to-delegate-tasks-to-ai-agents.mdx b/src/web/src/content/how-to-delegate-tasks-to-ai-agents.mdx
index 863332318..535962b99 100644
--- a/src/web/src/content/how-to-delegate-tasks-to-ai-agents.mdx
+++ b/src/web/src/content/how-to-delegate-tasks-to-ai-agents.mdx
@@ -1,12 +1,12 @@
----
-title: "How to Delegate Tasks to AI Agents (Actually)"
-description: "I delegate 43 tasks to AI agents. They run every week without me. Here's exactly how to set yours up."
-author: "Alook Team"
-date: "2026-06-03"
-slug: "how-to-delegate-tasks-to-ai-agents"
-keywords: ["delegate tasks to AI agents", "AI automation", "task delegation", "workflow automation", "alook"]
-image: "/blog/how-to-delegate-tasks/hero.png"
----
+export const metadata = {
+ slug: "how-to-delegate-tasks-to-ai-agents",
+ title: "How to Delegate Tasks to AI Agents (Actually)",
+ date: "2026-06-03",
+ author: "Alook Team",
+ excerpt:
+ "I delegate 43 tasks to AI agents. They run every week without me. Here's exactly how to set yours up.",
+ readingTime: "5 min read",
+};
# How to Delegate Tasks to AI Agents (Actually)
diff --git a/src/web/src/content/multi-agent-workflow-patterns.mdx b/src/web/src/content/multi-agent-workflow-patterns.mdx
index f054218c4..641c8b5f9 100644
--- a/src/web/src/content/multi-agent-workflow-patterns.mdx
+++ b/src/web/src/content/multi-agent-workflow-patterns.mdx
@@ -1,10 +1,10 @@
export const metadata = {
- slug: 'multi-agent-workflow-patterns',
- title: '7 Multi-Agent Workflows: Turn Your AI Coding Agents Into a Real Team',
- date: '2026-06-11',
- author: 'Donia',
- excerpt: 'Stop copy-pasting between AI coding agents. Learn multi-agent workflows that turn Claude Code, Cursor, and Codex into an autonomous team that saves 20+ hours weekly.',
- readingTime: '7 min read'
+ slug: "multi-agent-workflow-patterns",
+ title: "7 Multi-Agent Workflows: Turn Your AI Coding Agents Into a Real Team",
+ date: "2026-06-11",
+ author: "Donia",
+ excerpt: "Stop copy-pasting between AI coding agents. Learn multi-agent workflows that turn Claude Code, Cursor, and Codex into an autonomous team that saves 20+ hours weekly.",
+ readingTime: "7 min read",
};
# 7 Multi-Agent Workflows: Turn Your AI Coding Agents Into a Real Team
diff --git a/src/web/src/content/personal-ai-company.mdx b/src/web/src/content/personal-ai-company.mdx
index 4e03e4452..acd40d6ae 100644
--- a/src/web/src/content/personal-ai-company.mdx
+++ b/src/web/src/content/personal-ai-company.mdx
@@ -8,7 +8,7 @@ export const metadata = {
readingTime: "5 min read",
};
-![Personal AI Company Organizational Chart](/blog/personal-ai-company/2026-06-10-personal-ai-company-org-chart.png)
+![Personal AI Company Organizational Chart](/blog/personal-ai-company/hero.png)
Running a company alone used to mean choosing between growth and sanity. That tradeoff is dissolving. If you're a solopreneur looking for AI tools to scale without hiring, or a small business owner exploring AI agents for the first time, this is how it works.
@@ -39,7 +39,7 @@ Five agents deliver most of the value. Start with whichever matches your biggest
**Project coordinator agent.** Tracks tasks, sends reminders, maintains schedules. Removing the "what do I need to do next" mental load frees real capacity for strategic work.
-![Personal AI Company Development Timeline](/blog/personal-ai-company/2026-06-10-personal-ai-company-timeline.png)
+![Personal AI Company Development Timeline](/blog/personal-ai-company/timeline.png)
## Best AI tools for solopreneurs (2026 stack)
@@ -71,7 +71,7 @@ Agents working as a team, with shared context and communication channels, compou
That coordination layer is the actual product. Individual AI agents are commodities. The orchestration is what turns them into a workforce.
-![Traditional vs Personal AI Company Comparison](/blog/personal-ai-company/2026-06-10-personal-ai-company-comparison.png)
+![Traditional vs Personal AI Company Comparison](/blog/personal-ai-company/comparison.png)
## Start building