docs(cousteau): refactor system prompt into human reference

Restructure cousteau.md from a verbose AI system prompt into a concise
human reference document describing the agent's character, role, and
behaviors. Point readers to the actual system prompt location and
condense content from ~571 to ~175 lines while preserving key
philosophy, personality, and operational details.
This commit is contained in:
2026-05-21 11:13:50 -04:00
parent 495f5e9c07
commit 76ebb111f5
7 changed files with 702 additions and 1300 deletions

14
prompts/tools/angelia.md Normal file
View File

@@ -0,0 +1,14 @@
# Angelia (Wagtail CMS)
Angelia is the website publishing platform. The MCP exposes 24 tools across pages, media, blog, events, and syndication. Content fields take **raw HTML** (not Markdown, not StreamField blocks).
- **`get_page_tree()` first.** Always start by reading the site structure. You need parent IDs to create pages, and you need to know what already exists.
- **Draft by default.** Every creation tool defaults to `publish=False`. Don't publish until the content has been reviewed.
- **HTML, not Markdown.** All content fields take raw HTML.
- **Don't include `<!DOCTYPE>`, `<html>`, `<head>`, `<body>`, `<nav>`, or `<footer>`.** Your HTML renders inside `<main class="page-content">`; the base template provides the rest.
- **No StreamField.** Use HTML + Bootstrap 5.3.3 + design tokens for structure.
- **Categories must already exist.** Tags are created on the fly when you use them, but categories have to be pre-created with `manage_categories`.
- **Search images before uploading.** `search_images` returns pre-sized rendition URLs (thumbnail / small / medium / large / hero / og). Only call `upload_image` when there isn't already a suitable image in the library.
- **Use design tokens, not hardcoded values.** Author CSS with `var(--color-primary)`, `var(--spacing-md)`, etc. for consistency with the site.
- **`tags` and `category_slugs` replace on update.** `update_blog_post` overwrites these lists rather than appending. Pass the full intended list each time.
- **Detailed authoring guidance loads on demand.** The full page-type schemas, design-token reference, and HTML patterns are sourced as a separate authoring guide when an authoring task begins, not held in this snippet.