Welcome to Naftiko Shipyard¶
Naftiko Shipyard is the documentation hub for the Naftiko Fleet — a family of components built around Spec-Driven Integration, a methodology that elevates AI integration from a coding project to a specification task. It includes the open-source Ikanos engine and the open-source Polychro linter, together with Naftiko Crafter for VS Code editing and linting, Naftiko Warden for Backstage scaffolding and cataloguing, and Naftiko Skipper for Kubernetes delivery and operations.
Naftiko Shipyard itself will soon grow into a richer destination — a hosted Playground for running capabilities.
Draft
This documentation is a working draft and will be completed and refine as we prepare version 1.0 GA.
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 |
| Agents unreliability | Deterministic engine + linter ensure the spec executes exactly as written - limiting drift, hallucinations, and contract breakings |
| Context bloat 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 | Quickstart |
| 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-alpha4 |
| Polychro | The OSS deterministic AI-era linter for YAML, JSON, and Markdown specs | v1.0.0-alpha4 |
| Crafter | The capability builder for VS Code and most AI IDEs — visual + spec-driven authoring | v1.0.0-alpha4 |
| Warden | Capability governance and policy enforcement for Backstage | v1.0.0-alpha4 |
| Skipper | Fleet-wide orchestration for Kubernetes, across teams, regions, and compliance domains | v1.0.0-alpha4 |
| Shipyard | Documentation hub — and soon a hosted Playground and AI-assisted search | This site |