第二号 Production Harness

Use this repository as the source of truth for producing and maintaining the site.

Roles

• Hermes schedules work and chooses the relevant project-local skill.
• Codex executes repository changes, validation, browser checks, search indexing, and git hygiene.
• The codebase owns the current architecture and production contract.

Project-Local Skills

• Daily/media workflow: docs/agents/skills/daily-digest-media-fetch/
• Daily/research report workflow: docs/agents/skills/ai-news-research-report/
• Harness architecture: docs/agents/architecture.md
• Structured contracts: docs/agents/contracts/

Prefer these files over any global Hermes skill copy, because they match the current shared CSS, Pagefind, masonry, and validation harness.

Stable Commands

npm run site:update
npm run site:validate
npm run build:search
bash .github/style-check.sh .

Python entrypoints must run through scripts/python.sh or the NPM scripts above, not bare python3.

Production Rules

• Content pages use shared docs/styles.css, docs/search.js, and docs/site.js.
• Daily Builder blocks use .vlist-2col / masonry-friendly markup and local images with intrinsic dimensions.
• Research reports use the shared bento design system and include source attribution.
• Homepage and archive pages are generated by scripts/site_harness.py.
• Browser validation is required for changed pages when layout, media, search, or diagrams are touched.