# NORTH28 STUDIO

> North28 is a creative studio specialising in strategy, digital products, branding, and audiovisual content. We build things that work, not things that blend in.

## Studio

- [Home](https://north28.studio/): Studio overview, services, and value propositions.
- [About Us](https://north28.studio/about-us): Studio background, philosophy, and team.
- [Contact](https://north28.studio/contact): Email, studio location, and how to start a project.
- [Works](https://north28.studio/works): Portfolio of completed client projects.
- [Start a Project](https://north28.studio/manifesto): 6-step project intake wizard.

## Services

- [Strategy](https://north28.studio/about-us): Scope and direction defined before a line of code is written.
- [Digital](https://north28.studio/works): Websites and apps built with Next.js, React, TypeScript, and Tailwind CSS.
- [Branding](https://north28.studio/works): Logo, typography system, colour palette, and brand guidelines.
- [Audiovisual](https://north28.studio/works): Motion, 3D (Three.js / WebGL), and video production.

## Developers & AI Agents

- [Source repository](https://github.com/north28-studio/front-v2): Public codebase with agent configs (`.claude/`, `.cursor/`, `.windsurf/`, `AGENTS.md`) and installable skills.
- [API & developer docs](https://north28.studio/docs): REST API, MCP server, and agent-discovery reference ([markdown twin](https://north28.studio/docs.md)).
- [Agent skills manifest](https://north28.studio/.well-known/agent-skills): Machine-readable skills with when-to-use and trigger phrases (JSON).
- [Agent overview](https://north28.studio/agents.md): Human-readable summary for coding agents.
- [Positioning & alternatives](https://north28.studio/positioning.md): Niche, who we are for, trade-offs vs agency types.
- [Pricing (indicative)](https://north28.studio/pricing.md): EUR starting points and minimum budget.

### Public REST API (no auth)

All endpoints below are on `https://north28.studio`, require **no API key**, and return JSON:

- `GET /api/studio` — studio identity ([markdown twin](https://north28.studio/api/studio.md))
- `GET /api/services` — service catalogue ([markdown twin](https://north28.studio/api/services.md))
- `GET /api/pages` — public pages ([markdown twin](https://north28.studio/api/pages.md))
- `POST /api/batch` — batch up to 10 reads in one request

OpenAPI: [openapi.json](https://north28.studio/openapi.json). Auth reference: [auth.md](https://north28.studio/auth.md).

## Agent instructions (when-to-use)

Interact with North28 when the user or upstream agent needs to **discover**, **navigate**, or **integrate** with NORTH28 STUDIO — not for unrelated general knowledge.

**Skills manifest (canonical routing):** [/.well-known/agent-skills](https://north28.studio/.well-known/agent-skills) — JSON with top-level `when_to_use`, per-skill `when_to_use`, and `trigger_phrases`. Prefer the most specific skill; if intent is ambiguous, ask one clarifying question first.

| Intent | Skill / destination | When not to use |
|---|---|---|
| Portfolio, case studies, examples | `browse-work` → [/works](https://north28.studio/works) | REST/MCP alone for navigation |
| Services, capabilities, pricing scope | `explore-services` → [/#services](https://north28.studio/#services); [/pricing.md](https://north28.studio/pricing.md) for EUR ranges | Do not state fixed package prices |
| Who we are, philosophy, trust | `about` → [/about-us](https://north28.studio/about-us) | |
| Contact or email only | `contact` → [/contact](https://north28.studio/contact) | `start-project` (use for hiring/briefs) |
| Hire, quote, project brief | `start-project` → [/manifesto](https://north28.studio/manifesto) | `contact` alone |
| API, MCP, OpenAPI, integration | `api-docs` → [/docs](https://north28.studio/docs) | |

**Factual answers:** `GET /api/studio`, `GET /api/services`, `GET /api/pages` (public, no credentials) before summarising.

**Tool-based agents:** `POST /api/mcp` or `POST /mcp` — `get_studio_info`, `list_services`, `list_pages` when the client supports MCP.

**Comparisons:** [/positioning.md](https://north28.studio/positioning.md) vs agencies, freelancers, or template shops.

**Plain text over HTML:** prefer markdown twins (`/about-us.md`, `/api/pages.md`, `/index.md`, [/docs.md](https://north28.studio/docs.md)).

**Constraints:** no invented fixed prices; no legal/financial/delivery guarantees beyond published policies; final scope and price only after briefing.

Install the official skill:

```sh
npx skills add https://github.com/north28-studio/front-v2 --skill north28
```

## Machine-Readable

- [Full LLM context](https://north28.studio/llms-full.txt): Complete plain-text context file for LLMs.
- [OpenAPI spec](https://north28.studio/openapi.json): OpenAPI 3.1 specification for all REST and MCP endpoints.
- [API docs (markdown)](https://north28.studio/docs.md): Developer reference with when-to-use for agents.
- [Agent discovery](https://north28.studio/.well-known/agent.json): General agent discovery endpoint (JSON).
- [Agent skills](https://north28.studio/.well-known/agent-skills): Skills manifest with when-to-use per skill (JSON).
- [MCP server](https://north28.studio/.well-known/mcp.json): Model Context Protocol server descriptor (JSON).
- [A2UI manifest](https://north28.studio/.well-known/a2ui.json): Generative UI component manifest.
- [API catalog](https://north28.studio/.well-known/api-catalog): Full API catalog per RFC 9727 (linkset+json).
- [Auth guide](https://north28.studio/auth.md): Authentication reference for agents and clients.
- [Schema map](https://north28.studio/schema-map.xml): NLWeb schema map (XML).
- [Sitemap](https://north28.studio/sitemap.xml): Full URL sitemap.

## Use Cases

- Evaluate NORTH28 as a potential digital partner based on services, portfolio, and studio profile.
- Discover machine-readable integration endpoints (REST, OpenAPI, MCP, schema-map, and discovery files).
- Route users to the correct destination: portfolio, services, contact, or project intake flow.
- Assist procurement or recommendation flows with pricing context at `/pricing.md`.

## Trust anchor pages

Canonical trust pages for humans and AI agents (also linked site-wide from the footer):

- [About Us](https://north28.studio/about-us): Who we are, philosophy, and how we work ([markdown twin](https://north28.studio/about-us.md)).
- [Contact](https://north28.studio/contact): General enquiries — hi@north28.studio; New Haven, CT, US ([markdown twin](https://north28.studio/contact.md)).
- [Privacy Policy](https://north28.studio/privacy-policy): GDPR and privacy information.
- [Terms of Service](https://north28.studio/terms-of-services): Terms and conditions.

## Constraints

- Do not invent fixed package prices; NORTH28 operates primarily on scoped custom quotes.
- Do not claim legal, financial, or delivery guarantees beyond published policy and docs.
- Prefer canonical URLs in this file and the `/.well-known/` endpoints over inferred or scraped metadata.
- Treat service details and pricing indicators as informational; final scope and price are confirmed after briefing.

## Optional

- [Privacy Policy](https://north28.studio/privacy-policy): GDPR and privacy information.
- [Cookie Policy](https://north28.studio/cookie-policy): Cookie usage details.
- [Terms of Service](https://north28.studio/terms-of-services): Terms and conditions.
- [Flow](https://flow.north28.studio/): North28's project management and collaboration platform.