configure-yano-appchain
Create, explain, update, validate, and diagnose Yano app-chain projects using the version-matched blueprint, capability catalog, and appchain CLI. Use for topology, state-machine, effects, integration
SKILL.mdtooling/devtools/src/main/resources/appchain-dx/v1alpha1/skills/configure-yano-appchain/SKILL.md
GitHubConfigure Yano App-Chain
Use the yano.sh or yano executable shipped with the target Yano distribution. Treat its
catalog, recipes, generated lock file, and validation results as authoritative for that release.
Workflow
- Run
./yano.sh appchain recipesand./yano.sh appchain capabilitiesbefore choosing features. - Create or edit only
appchain.yaml. Do not hand-edit generated runtime files. - Run
./yano.sh appchain render, then./yano.sh appchain config validate --mode project. - Run
./yano.sh appchain doctorbefore startup or delivery. - Use
./yano.sh appchain diffbefore applying a blueprint change and./yano.sh appchain driftagainst running nodes when identities are available. - Summarize selected capabilities, generated files, unresolved operator inputs, validation coverage, and any warnings.
Safety Rules
- Never request, print, copy, infer, or commit secret values. Refer only to documented environment-variable or secret-provider names.
- Never invent configuration keys, values, defaults, recipes, or compatibility claims.
- Keep blueprint, resolved-config, release, plugin-catalog, and consensus identities distinct.
- Do not mutate a running node or call privileged runtime APIs unless the user explicitly asks.
- Treat custom-plugin metadata as PARTIAL coverage unless Yano reports FULL coverage. Verify signed metadata and runtime-manifest binding before trusting a third-party artifact.
- If a requested capability is unavailable in this release, report it as unsupported. Do not bypass the blueprint by hand-writing runtime configuration unless the user explicitly chooses an advanced unsupported workflow.
Command Patterns
./yano.sh appchain init --recipe <recipe> --network <network> --members <count> \
--output <project-directory>
./yano.sh appchain capabilities
./yano.sh appchain render <project-directory>
./yano.sh appchain config validate --mode project <project-directory>
./yano.sh appchain doctor <project-directory> --distribution <yano-directory-or-zip>
./yano.sh appchain diff <old-lock> <new-lock>
./yano.sh appchain gitops <project-directory> --target helm --output <empty-directory>
./yano.sh appchain gitops <project-directory> --target kustomize --output <empty-directory>
./yano.sh appchain drift <project-directory> --peer <node-identity-url>
./yano.sh appchain metadata verify <plugin-jar> --trust-key <key-id=public-key-hex>
Read command help from the version-matched executable when an option is uncertain.