com.doji.package-authoring AGENTS.md

AGENTS.md

Project Intent

This repository is a Unity 6.3 template project centered on editor tooling for creating reusable Unity packages and companion sample or test projects.

Source Of Truth

Prefer these locations:

• com.doji.package-authoring/: local package under development
• .codex/skills/: project-specific skills; when a task matches one, read and follow the relevant SKILL.md
• .codex/project-memory.md: durable project memory and agent-oriented project context

Prefer working in existing package folders when functionality is package-owned.

Project Memory

Keep durable project memory in .codex/project-memory.md.

Do not create or maintain a second long-lived project memory file under docs/.

Conventions

When adding code:

• keep editor-only code in Editor folders or editor-only assemblies
• use asmdefs deliberately and keep assembly references explicit
• keep namespaces, folders, and asmdef boundaries coherent for Unity and Rider
• preserve .meta files when moving Unity assets or scripts

C# Style (Unity)

• No raw public fields.
• Prefer properties over public fields.
• Use [field: SerializeField] public TYPE Name { get; private set; } when inspector/serializer input should be externally read-only.
• Use [field: SerializeField] public TYPE Name { get; set; } for serialized data objects/DTOs that are intentionally edited through tooling code.
• Use [SerializeField] private TYPE name; for private Inspector fields.
• Private instance fields use _camelCase.
• Private computed properties may use PascalCase when they read like derived values rather than stored state.
• Private static readonly shared collections/values may use PascalCase when treated as internal constants/shared state.
• Place multiple attributes on separate lines.
• Prefer property-based public APIs; keep backing fields private or compiler-generated.
• Follow Unity conventions for MonoBehaviour and EditorWindow methods; do not add unnecessary Update() or FixedUpdate().