project-conventions

name	project-conventions
description	Core conventions and patterns for this codebase
domain	project-conventions
confidence	medium
source	template

Context

This is a starter template. Replace the placeholder patterns below with your actual project conventions. Skills train agents on codebase-specific practices — accurate documentation here improves agent output quality.

Patterns

[Pattern Name]

Describe a key convention or practice used in this codebase. Be specific about what to do and why.

Error Handling

Testing

• Browser regression coverage for the blog archive lives in tests/playwright/BlogArchiveTests.cs and runs with cd tests/playwright && dotnet test.
• Playwright archive link locators should use GetByRole(..., new() { NameString = "...", Exact = true }) because archive titles can share prefixes and default accessible-name matching is substring-based.
• When validating archive regressions locally, use development config (_config_dev.yml copied to _config.yml), make sure the Jekyll server is serving http://127.0.0.1:4000/, then run dotnet test --filter "Crawl_Archive" for the focused regression check.

Code Style

File Structure

Examples

await page.GetByRole(AriaRole.Link, new() { NameString = "Danish Developer Conference 2012", Exact = true }).ClickAsync();
await page.WaitForURLAsync($"{baseUrl}/2012/02/danish-developer-conference-2012.html");

Anti-Patterns

• Partial Playwright archive link matches — Do not rely on default GetByRole name matching for archive titles, because substring collisions can make the crawl flaky as new posts are added.