# Seamline

> 

- Documentation: https://pr-1-7abef52380a8.thally.app
- GitHub: https://github.com/ekeneezee/seamlinedocs
- Full docs for LLMs: https://pr-1-7abef52380a8.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-1-7abef52380a8.thally.app/ai.txt
- Structured docs index (JSON): https://pr-1-7abef52380a8.thally.app/api/docs-index
- OpenAPI spec: https://pr-1-7abef52380a8.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-1-7abef52380a8.thally.app/api/docs/{page-id}
- Search API: https://pr-1-7abef52380a8.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-1-7abef52380a8.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-1-7abef52380a8.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-1-7abef52380a8.thally.app/api/mcp
- Agent readiness: https://pr-1-7abef52380a8.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://pr-1-7abef52380a8.thally.app/): Contract tooling for the seams of your stack — where your service meets the outside world and silent drift turns into outages.
- [Quickstart](https://pr-1-7abef52380a8.thally.app/quickstart): Install Specdiff and Envlock, run your first check, and see the result in under five minutes.

## Specdiff

### Overview

- [Specdiff](https://pr-1-7abef52380a8.thally.app/specdiff-overview): Breaking-change detection for JSON Schema and OpenAPI documents.

### Packages

- [Core API](https://pr-1-7abef52380a8.thally.app/specdiff-core-api): The diff engine, rule catalogue, formatters, and pointer helpers — zero runtime dependencies.
- [CLI](https://pr-1-7abef52380a8.thally.app/specdiff-cli): The specdiff command — compare documents, list rules, and gate CI on breaking changes.
- [MCP server](https://pr-1-7abef52380a8.thally.app/specdiff-mcp): A Model Context Protocol server that lets coding agents compare schemas and explain rules.

### Reference

- [Rules catalogue](https://pr-1-7abef52380a8.thally.app/specdiff-rules): All 45 Specdiff rules — the stable codes, default severities, and what each rule detects.

## Envlock

### Overview

- [Envlock](https://pr-1-7abef52380a8.thally.app/envlock-overview): Typed environment contracts for Node.js — validate, type, document, and diff your env variables.

### Packages

- [Schema & fields](https://pr-1-7abef52380a8.thally.app/envlock-schema-definition): Define your environment contract with defineEnv and the env builder: 10 field types with chain methods for defaults, secrets, and documentation.
- [Core API](https://pr-1-7abef52380a8.thally.app/envlock-core-api): Schema builders, validation, dotenv parsing, .env.example rendering, diff, redact, and describe — zero runtime dependencies.
- [CLI](https://pr-1-7abef52380a8.thally.app/envlock-cli): The envlock command — check, example, diff, inspect, and init.
- [MCP server](https://pr-1-7abef52380a8.thally.app/envlock-mcp): A Model Context Protocol server that lets coding agents validate env contracts, render examples, and explain issues.