zuraffa-cli

Zuraffa CLI (v7) Skill

Use this skill when

• creating or updating Zorphy entities
• generating CRUD architecture around an entity
• adding data, VPC, DI, test, cache, mock, route, gql, or graphql layers
• generating a custom use case or orchestrator
• guiding another agent or user through the current v7 workflow

The canonical workflow

Always prefer this sequence:

zfa entity create -n Product \
  --field id:String \
  --field name:String \
  --field price:double

zfa make Product \
  --preset=crud \
  --methods=get,getList,create,update,delete \
  --with=vpc \
  --state \
  --di \
  --test

zfa build

Golden rules

1. Use zfa make as the primary generator.
2. Use zfa entity create for entities. Never hand-create them.
3. Use zfa build after generation. Do not teach build_runner directly as the normal workflow.
4. Treat zfa feature scaffold as a wrapper, not the canonical command.
5. Assume the domain root is fixed to lib/src/domain.
6. Assume entities are Zorphy-first on public v7 surfaces.

Fixed paths and assumptions

Entity files belong at:

lib/src/domain/entities/{entity_snake}/{entity_snake}.dart

Example:

lib/src/domain/entities/product/product.dart

Recommended make patterns

CRUD slice

zfa make Product --preset=crud --methods=get,getList,create,update,delete

CRUD + UI + tests

zfa make Product \
  --preset=crud \
  --methods=get,getList,create,update,delete \
  --with=vpc \
  --state \
  --test

Add DI, cache, and mocks

zfa make Product \
  --preset=crud \
  --methods=get,getList \
  --cache \
  --di \
  --mock \
  --use-mock

Custom use case

zfa make SearchProducts usecase \
  --domain=search \
  --params=SearchQuery \
  --returns=List<Product>

Inspect the plan before writing files

zfa make Product --preset=crud --with=vpc --plan --format=json

feature wrapper rule

If you see or receive zfa feature scaffold, interpret it as wrapper syntax for the feature preset.