editor

IMPORTANT: Analyze the task prompt to determine which guides you need. Read guides on demand based on your work: Domain & Service Logic: • Domain entities, aggregates, value objects, services, business logic • Guide: .claude/guides/backend/domain-service.md Data Persistence: • Repository interfaces/implementations, query optimization, tenant isolation • Guide: .claude/guides/backend/repository.md Database Migrations: • Schema changes, migrations, multi-tenant patterns, sql-migrate • Guide: .claude/guides/backend/migrations.md Presentation Layer: • Controllers, ViewModels, templates (Templ), auth guards, HTMX, form handling • Guide: .claude/guides/backend/presentation.md Internationalization: • Translation files (.toml), multi-language synchronization, validation • Guide: .claude/guides/backend/i18n.md Routing & Modules: • Module registration, route patterns, middleware, DI with di.H • Guide: .claude/guides/backend/routing.md Testing: • ITF framework, service tests, repository tests, controller tests, integration tests • Guide: .claude/guides/backend/testing.md Configuration: • Environment files, docker-compose, Makefile, documentation • Guide: .claude/guides/config.md When task scope is ambiguous: Use AskUserQuestion to clarify which domain(s) to work on before proceeding.

Domain Layer: modules//domain/aggregates/, modules//domain/entities/, modules//domain/value_objects/ Service Layer: modules//services/, modules//services/_test.go Repository Layer: • Interfaces in modules//domain//repository.go • Implementations in modules//infrastructure/persistence/ Presentation Layer: • Controllers in modules//presentation/controllers/ • ViewModels in modules//presentation/viewmodels/ • Templates in modules//presentation/templates//.templ • Translations in modules//presentation/locales/.toml Database Layer: migrations/*.sql, schema design Configuration: .env, compose*.yml, Makefile, README.md, docs/ Tests: All *_test.go files across all layers

• Determine layers involved: domain, service, repository, controller, ViewModel, template, migration, config • Read relevant guides based on task context (see Task-based guide routing above) • Map dependencies: aggregates, services, repository interfaces, auth requirements, organization vs tenant context • Plan test scenarios: happy path, error cases, edge cases, permissions • Use AskUserQuestion if task scope or approach is ambiguous

Follow patterns from guides: Domain Entities (see domain-service.md): • Functional options pattern • Immutability (return new instances from setters) • Business rules in entities • Interfaces, not structs Services (see domain-service.md): • DI with repository interfaces • Business logic and validation • Permission checks via sdkcomposables.CanUser() • Error wrapping: serrors.E(op, err) • Transaction coordination when needed Repositories (see repository.md): • Interfaces in domain layer with domain types • Implementations with composables.UseTx() and composables.UseTenantID() • Parameterized queries ($1, $2), SQL as constants • pkg/repo for dynamic queries • Tenant isolation (ALWAYS include tenant_id) Migrations (see migrations.md): • Check git status before editing: git log --oneline -- migrations/{filename} • Uncommitted: safe to edit | Committed: create new with date +%s • Up/Down sections, StatementBegin/StatementEnd for PL/pgSQL • Always include tenant_id for multi-tenant tables • Test reversibility (Up→Down→Up cycle) Controllers (see presentation.md): • Auth middleware via subRouter.Use() • DI with di.H for handler dependencies • composables.UseForm[DTO] for form parsing (CamelCase fields!) • pkg/htmx package (NEVER raw headers) • Permission checks early in handlers ViewModels (see presentation.md): • Located in modules/*/presentation/viewmodels/ • Pure transformation logic (no business logic) • Separate from Props (Props are component config, ViewModels are data transformation) • Map domain entities to presentation structures Templates (see presentation.md): • Use templ.URL() for dynamic URLs • Never @templ.Raw() with user input • CSRF tokens in forms: <input type="hidden" name="gorilla.csrf.Token" value={ ctx.Value("gorilla.csrf.Token").(string) }/> • CamelCase form field names (e.g., name="FirstName") • IOTA SDK components from github.com/iota-uz/iota-sdk/components • HTMX interactions via pkg/htmx package Translations (see i18n.md): • Update ALL 3 files: en.toml, ru.toml, uz.toml • Hierarchical keys (e.g., Module.Form.FieldName) • Avoid reserved keywords (OTHER → OTHER_STATUS, ID → ENTITY_ID) • Enum pattern: Module.Enums.EnumType.VALUE • Always run make check tr after changes Configuration (see config.md): • Environment files: .env.example (template), .env (local) • Docker configs: compose.dev.yml, compose.yml • Makefile: build targets, test commands, migration commands • Documentation: README.md, docs/