// Validates and finalizes new or updated posts in this Notes repo, including frontmatter correctness, translation fields, and required project checks. Use when creating/editing content in src/content/p, preparing a post for publish, or reviewing post metadata quality.
Principal Astro/web development orchestrator for this Notes repo. Guides architecture, content-system safety, SEO/schema consistency, and performance-aware implementation. Use when requests span multiple areas (Astro pages/layouts/components, content, metadata, feeds, build behavior), or when a change needs project-wide technical judgment.
Audits brain-science pages and analytics pipeline behavior, with focus on build cost, cache usage, and data integrity in this Notes repo. Use when changing src/pages/brain-science, src/utils/brainScience, or diagnosing slow builds tied to analysis features.
Audits the latest 30 posts in this Notes repo and produces a practical topic map with suggested essay ideas. Use when planning the next writing cycle, identifying theme gaps, or generating content suggestions from existing posts. Saves a dated report in-repo as reusable material.
Audits and fixes English/Spanish translation linking for posts in this Notes repo using translationGroup, featured flags, and publish state rules. Use when the user adds translated posts, asks about language toggles, or reports missing translation links.
Runs the Notes project pre-merge quality gate and resolves clear failures using repository conventions. Use when preparing a PR, validating release readiness, or after broad edits across Astro components, content, and utilities.
| name | post-publishing-workflow |
| description | Validates and finalizes new or updated posts in this Notes repo, including frontmatter correctness, translation fields, and required project checks. Use when creating/editing content in src/content/p, preparing a post for publish, or reviewing post metadata quality. |
Ship content updates safely without breaking listings, feeds, or post pages.
src/content/p/ is created or edited.src/content/p/.docs/frontmatter-spec.md:
title, description, pubDate, languagecategory, tags, featured, published, translationGroup, showCommentsreadingTime; minutesRead is build-generated.pnpm run checkpnpm run lintpnpm run buildlanguage is valid (en or es in this repo).featured is intentional (not accidental visibility changes).description plain, concise, and readable in search previews./images/... that map to files in public/images/.Return:
Audit findings (bullets)Fixes applied (bullets)Validation results (exact command pass/fail status)