AGPL-3.0-or-later · forever.

the corpus

Every workflow we ship, and why each one exists.

Three shelves. A path that teaches the language one idea at a time, the real jobs that prove it on work worth doing, and the skeletons a single command hands you. Every file here is spec-correct by construction: they are the same files the conformance gate runs on, read at the pin, never retyped.

  • 18teaching stepsin order
  • 27real jobsgate-passing
  • 14skeletonsone command away

the path

Thirteen steps, in order

Each step adds exactly one idea to the step before it, and running them in order is how the language teaches itself. Start at the smallest complete workflow there is and end at the paths a run takes when it breaks.

  1. 01Hello world — the smallest COMPLETE Nika workflow.01-hello.nika.yaml
  2. 02Parallel fan-out + merge — the core DAG pattern.02-parallel-fanout.nika.yaml
  3. 03exec pipeline — shell, a conditional gate, cleanup on every outcome.03-exec-pipeline.nika.yaml
  4. 04Structured output + retry — an LLM call you can index into.04-schema-retry.nika.yaml
  5. 05Fetch → bind → summarize, with a fallback that keeps the shape.05-fetch-chain.nika.yaml
  6. 06Code-review agent — a loop you do not write.06-code-review.nika.yaml
  7. 07for_each fan-out — one task, many items.07-for-each-locales.nika.yaml
  8. 08The deployment's knobs — one authority, two roles.08-config-values.nika.yaml
  9. 09Returns — the typed door on a task's output.09-returns-typed-door.nika.yaml
  10. 10Compose (the child) — a callable unit.10-compose-child.nika.yaml
  11. 10Compose — one workflow calls another.10-compose-pipeline.nika.yaml
  12. 11The lift — the one door through the taint.11-lift-the-door.nika.yaml
  13. 12Failure routing — the paths a run takes when it breaks.12-failure-routing.nika.yaml
  14. 13Extract facts, then the law — the model never writes the verdict.13-extract-then-law.nika.yaml
  15. 14Decide, then publish or abstain — the kernel, never the model.14-decide-publish.nika.yaml
  16. 15Compose self-check — the loop checks the draft, never runs it.15-compose-self-check.nika.yaml
  17. 16Inspect self — the run reads its own DAG.16-inspect-self.nika.yaml
  18. 17TTS self — the last named showcase debt.17-tts-self.nika.yaml

read at nika-spec@14bf49f43 · every file carries its own sha256