Tutorials — Overview¶
The Naftiko Fleet tutorials are organized into four learning tracks, each focused on a distinct problem domain. They are independent — you do not need to complete them in order — but they build on the same example, a maritime shipping company called Shipyard, so the data shapes will look familiar.
Two Shipyards
The fictional maritime company in these tutorials is also called Shipyard — a deliberate pun. The Naftiko Fleet component you're reading these docs on is also called Shipyard. Context will make clear which is which: the fictional one ships cargo, the real one ships docs.
| Track | What you will build | Time |
|---|---|---|
| Track 1 — Context Engineering | A capability that goes from mock to live MCP tools talking to a real Maritime Registry API. | 30–45 min |
| Track 2 — API Reusability | Skill groups, Aggregates with ref:, and a parallel REST adapter — one capability, three doors. |
30 min |
| Track 3 — Agent Orchestration | A multi-source Fleet Manifest with orchestrated steps, lookup joins, and shared consumes. |
30 min |
| Track 4 — Platform Operations | Linting in CI, observability via the Control Port, multi-environment binds. | 20 min |
Prerequisites for all tracks¶
- Ikanos running (Docker or native CLI)
- A YAML-aware editor — we strongly recommend Crafter, the Naftiko VS Code extension
- An MCP client for testing — the MCP Inspector is the fastest to set up
All capability YAML files referenced in the tutorials are available in the Ikanos tutorial folder.
Recommended path¶
If this is your first time, follow this order:
- Quickstart — five-minute taste of a single capability.
- Track 1, Steps 1–3 — the contract-first workflow.
- Pick one of Tracks 2, 3, or 4 based on what you want to build next.