Personal Website — Agent Instructions

Project-level operating guide for agents working in this repository.

Purpose

Build and maintain Jenny Hurn’s personal website with high-quality content, clear proof, and production-safe edits.

Start Here

Before making changes, read in this order:

1. README.md
2. next-steps.md
3. context/style-guide.md (then linked guides)
4. .agents/README.md and relevant files in .agents/skills/

Priorities

1. Accuracy and credibility of claims
2. Clear, concise, human voice
3. Accessibility and semantic correctness
4. Maintainable, minimal-change implementation

File Organization Rules

• Reusable agent guidance belongs in .agents/skills/.
• One-off run artifacts belong in work/.
• Context and standards belong in context/.
• Publish-ready site files stay in place (index.html, projects/, blog/, _posts/, _layouts/).

Execution Rules

• Make focused edits; avoid broad refactors unless requested.
• Do not move files as part of unrelated tasks.
• Preserve existing design system and style-guide constraints.
• If a claim cannot be verified, soften language rather than invent specifics.

Quality Checks

• Validate changed pages render and links work.
• Preserve keyboard access and visible focus states.
• Keep docs (decisions.md, next-steps.md) updated when decisions or execution state change.