Welcome to Naftiko Shipyard¶
Naftiko Shipyard is the documentation hub of the open-source platform for Spec-Driven Integration (SDI), a methodology that turns integration from a coding problem into a specification problem. Authored once in YAML, a capability runs on any spec-compliant engine and exposes the same domain through REST, MCP, Skill, and other adapters.
This site is the home of the documentation for the Naftiko Fleet — a family of components built around Spec-Driven Integration. It includes the open-source Ikanos engine and the open-source Polychro linter, together with Naftiko Crafter for VS Code, Naftiko Warden for Backstage, and Naftiko Skipper for Kubernetes.
Naftiko Shipyard itself will soon grow into a richer destination — a hosted Playground for running capabilities and an AI-assisted Ask Navi search across all the docs.
Draft
This documentation is a working draft and will be completed and refine as we prepare version 1.0 beta 1.
Why the Naftiko Fleet¶
| Pain | What the Fleet does about it |
|---|---|
| API sprawl across SaaS, microservices, and legacy systems | Declare integrations once as a capability — one spec, many transports |
| AI agents drift, hallucinate, and break contracts | Deterministic engine + linter ensure the spec executes exactly as written |
| Context fragmentation for AI tasks | Right-size MCP tools and resources directly in the capability spec |
| Boilerplate code for HTTP clients, auth, format conversion | Declarative consumes/exposes adapters cover the 90% case in YAML |
Where to start¶
| If you are… | Go to |
|---|---|
| New to Spec-Driven Integration | Overview → Spec-Driven Integration |
| Ready to install and try it | Getting Started → Installation |
| Looking for hands-on practice | Tutorials |
| Evaluating components | Fleet → Overview |
| Comparing Fleet editions | Fleet → Editions |
The Fleet components¶
| Component | Purpose | Status |
|---|---|---|
| Ikanos | The OSS capability engine — runs a Naftiko spec as a multi-protocol server | v1.0.0-alpha3 |
| Polychro | The OSS deterministic AI-era linter for YAML, JSON, and Markdown specs | v1.0.0-alpha3 |
| Crafter | The capability builder for VS Code and most AI IDEs — visual + spec-driven authoring | v1.0.0-alpha3 |
| Warden | Capability governance and policy enforcement for Backstage | v1.0.0-alpha3 |
| Skipper | Fleet-wide orchestration for Kubernetes, across teams, regions, and compliance domains | v1.0.0-alpha3 |
| Shipyard | Documentation hub — and soon a hosted Playground and AI-assisted search | This site |