Agent Guidelines

This landing page collects the core resources for AI agents working on the Ethotechnics codebase. Each topical guide is short and focused so you can jump straight to what you need.

Project Philosophy

Ethotechnics centers care-centered system design—intentional maintenance, resilient and inclusive experiences, and approachable HTML/CSS/JS. Read the philosophy overview for design commitments and references.

Pre-flight Checklist

Before making changes, review the workflow checklist to confirm you understand the build system, content workflow, and existing patterns.

Required Commands

Use the required commands to align with CI. bun run verify runs linting, build, and tests in sequence.

Agent Skills

Follow agent skills to reuse audit scripts and task-specific runbooks stored in .agent/skills/.

Code Style and Conventions

Follow the code conventions for CSS tokens, semantic HTML, modular JavaScript, and file organization.

Build System Details

See the workflow guide for build scripts, development tooling, and preview commands.

Testing Requirements

Expectations and locations for smoke, E2E, and worker/content tests are outlined in the testing requirements.

Localization

Site copy editing steps, template usage, and tone guidance are captured under Workflow.

Common Pitfalls

Review the pitfalls checklist to avoid common mistakes and keep selectors, tokens, and accessibility on track.

Deployment

The deployment checklist covers pre-deploy validations and the bunx wrangler deploy command.

Getting Help

Troubleshooting steps and diagnostics live in the Getting Help section, with focused fixes in the troubleshooting playbook.

Troubleshooting

Jump to the troubleshooting playbook for build, test, performance, and workflow fixes.

Summary

Use tokens and established patterns, run required commands, maintain accessibility, and keep changes simple and well tested. Each topical guide above contains the detailed steps.