Agent Instructions

This is a multilingual (English/Portuguese) Hugo-based blog.

Security Note

Security headers are not a priority as there is no dynamic content or user data.

Environment & Commands

• Setup: mise install
• Dev: hugo server (http://localhost:1313)
• Build: hugo or hugo --minify --baseURL https://lucasew.github.io
• Format: dprint fmt
• Maintenance: ./update.sh (runs Python scripts prefixed with update_)

Architecture

• Structure: content/post/YYYYMMDD-slug/index.{en,pt}.md
• Dates: Derived from directory names via content/post/update_dates.py.
• Shortcodes: eval (dynamic Hugo templates), details (collapsible).
• Layouts: utils_base16 (theme browser), utils_home, slide.
• Base16: Themes generated via content/utils/base16/update_data.py.

Important Notes

• Hugo Version: Must match in mise.toml and vercel.json. mise.toml takes precedence.
• Goldmark: Unsafe mode is enabled for raw HTML.
• CI/CD: GitHub Actions (.github/workflows/gh-pages.yaml) runs ./update.sh weekly and on push.