Project Rules & Guidelines

Project Rules & Guidelines

  • Website Root & Build Tooling Separation:
    • Keep Markdown content files (_pages/), site configuration (_config.yml), layouts, styles, collections, and Gemfile in the workspace root for direct editing in Obsidian and seamless GitHub Pages builds.
    • Keep build tooling, Node dependencies (package.json), and Playwright visual regression tests (tests/, playwright.config.js) inside website/.
  • Deployment Verification:
    • Always wait for GitHub Actions workflows (deploy-pages and visual-regression) to complete and confirm live site status (https://matheusvxf.github.io/) before declaring completion.
  • Local Preview Server:
    • When asked to preview before committing or finishing, ensure a local server is running so the user can test pages in their browser.