anclax-develop-feature

Category: Databases & Storage | Uploader: cloudcarver | Downloads: 0 | Version: v1.0（Latest）

Develop, review, or refactor Go services built with Anclax, including OpenAPI specs, handlers, service/business logic, database/sqlc changes, async tasks, and Wire dependency injection.

Changelog: Source: GitHub https://github.com/cloudcarver/anclax

Directory Structure

Current level: tree/main/skills/anclax-develop-feature/

📄 anclax-config.md 1.5 KB
📄 app-config.md 1.2 KB
📄 async-tasks.md 6.9 KB
📄 business-logic.md 714 B
📄 crud.md 3.1 KB
📄 database.md 1.3 KB
📄 dependency-injestion.md 791 B
📄 multi-service-repos.md 3.5 KB
📄 openapi-spec.md 998 B
📄 SKILL.md 2.3 KB

SKILL.md

---
name: anclax-develop-feature
description: Develop, review, or refactor Go services built with Anclax, including OpenAPI specs, handlers, service/business logic, database/sqlc changes, async tasks, and Wire dependency injection.
---

# Anclax Development Workflow

Use Anclax generated types as the contract between layers and keep specs/SQL as the source of truth.

## Design principles

- Singleton services with dependency injection.
- High cohesion, low coupling.

## Core flow

1. Inspect `anclax.yaml` to learn generation paths and enabled generators.
2. Update sources first:
   - OpenAPI: the matching `oapi-codegen` entry `path` (commonly `api/v1.yaml`)
   - Tasks: the matching `task-handler` entry `path` (commonly `api/tasks.yaml`)
   - DB schema: `sql/migrations`
   - Queries: `sql/queries`
3. Run `anclax gen` after any spec/SQL/Wire changes.
4. If you modify `examples/`, run `make gen` to refresh `cmd/anclax/initFiles` and normalize template-specific `go.mod` content.
5. Implement code against generated interfaces and types.
6. Add unit tests for service logic with mocks.

## Layering rules

- Handler: parse HTTP, call service, map errors to HTTP responses.
- Service: implement business logic, accept and return `apigen` types.
- Model: use `pkg/zcore/model` and sqlc-generated queries.
- Async tasks: define in the task spec configured under `task-handler` (commonly `api/tasks.yaml`), implement `taskgen.ExecutorInterface`, enqueue via `taskgen.TaskRunner`.

## References and Examples
  - [Config](./anclax-config.md): How to use `anclax.yaml` for generator inputs/outputs.
  - [CRUD operations](./crud.md): End-to-end CRUD flow and mapping examples.
  - [OpenAPI Spec](./openapi-spec.md): Conventions for OpenAPI specs in Anclax.
  - [Business Logic](./business-logic.md): Service-layer rules and error handling.
  - [Database](./database.md): SQL/schema rules and transaction helpers.
  - [Dependency Injection](./dependency-injestion.md): Wire DI conventions.
  - [Async Tasks](./async-tasks.md): Task definitions, execution, retries, and hooks.
  - [Example template generation](./template-generation.md): Updating `examples/` and regenerating `cmd/anclax/initFiles`, including `go.mod` normalization from `VERSION`.
  - [Multi-service repos](./multi-service-repos.md): Organizing multiple apps under `app/` with shared or service-specific modules.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

anclax-develop-feature

Directory Structure

SKILL.md

Report

Notice