site/AGENTS.md

AGENTS.md

Project purpose

This repository contains the public website for the Napper application ecosystem.

The site includes:

• the main napper.au landing site;
• the Hudra product site;
• the Lildra product site;
• the Pendra product site;
• shared legal, privacy, support and ecosystem content.

Source of truth

The repository is the source of truth, not individual conversations or AI sessions.

When an important architectural, deployment, naming or development decision is made:

1. update the appropriate repository documentation;
2. update this file when the guidance affects AI contributors;
3. avoid relying on undocumented conversational context.

Working principles

• Keep the site simple and maintainable.
• Prefer conventional web technologies over unnecessary frameworks.
• Avoid dependencies unless they provide a clear benefit.
• Preserve accessibility, responsive design and fast page loads.
• Reuse shared styles and components where practical.
• Keep each application page focused on what the application does.
• Do not describe Hudra as a general-purpose editor.
• Treat Hudra primarily as a presentation and slide-viewing system for QLearn.
• Do not expose secrets, credentials or server-specific private data.
• Keep deployment configuration documented and reproducible.

Expected workflow

1. Review existing documentation before changing architecture.
2. Make focused changes.
3. Test locally where possible.
4. Update documentation when behaviour or structure changes.
5. Commit using a clear, descriptive message.

Project structure

The final structure will be documented after the existing website is imported and audited.

Do not invent a new architecture before inspecting the existing site.