Rewrite the site as Connect-only docs against the live REST and MCP contract.

Author: Paulo Castellano

AGENTS.md

@@ -1,33 +1,15 @@
-> **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project.
-> For Mintlify product knowledge (components, configuration, writing standards),
-> install the Mintlify skill: `npx skills add https://mintlify.com/docs`
+# TryPost Connect Docs
 
-# Documentation project instructions
+Mintlify documentation for **TryPost Connect** — B2B publishing infrastructure at [connect.trypost.it](https://connect.trypost.it).
 
-## About this project
+## Product
 
-- This is a documentation site built on [Mintlify](https://mintlify.com)
-- Pages are MDX files with YAML frontmatter
-- Configuration lives in `docs.json`
-- Run `mint dev` to preview locally
-- Run `mint broken-links` to check links
+Connect is not the TryPost scheduler. There is no calendar, no asset library, no self-host, no workspaces. Media is pass-through: `POST /medias/presign` → `PUT` → `media[].url` = `public_url`. Connect accounts via `GET /social-accounts/connect/{platform}?redirect_url=` (`{url,state}`; browser redirect to the client). MCP is `https://connect.trypost.it/mcp` (OAuth, no API keys, no connect tool).
 
-## Terminology
+Source of truth for the contract is `~/Herd/trypost-connect` (`routes/api.php`, `app/Mcp/Servers/TryPostServer.php`).
 
-{/* Add product-specific terms and preferred usage */}
-{/* Example: Use "workspace" not "project", "member" not "user" */}
+## Style
 
-## Style preferences
-
-{/* Add any project-specific style rules below */}
-
-- Use active voice and second person ("you")
-- Keep sentences concise — one idea per sentence
-- Use sentence case for headings
-- Bold for UI elements: Click **Settings**
-- Code formatting for file names, commands, paths, and code references
-
-## Content boundaries
-
-{/* Define what should and shouldn't be documented */}
-{/* Example: Don't document internal admin features */}
+- Active voice, second person
+- Sentence case headings
+- Do not document the old scheduler (signatures, labels, repurposes, assets, self-hosting)

CLAUDE.md

@@ -1,34 +1,7 @@
-> **Customize this file**: Tailor this template to your project by noting specific contribution types you're looking for, adding a Code of Conduct, or adjusting the writing guidelines to match your style.
+# Contributing
 
-# Contribute to the documentation
+This repository is the Mintlify site for **TryPost Connect**.
 
-Thank you for your interest in contributing to our documentation! This guide will help you get started.
-
-## How to contribute
-
-### Option 1: Edit directly on GitHub
-
-1. Navigate to the page you want to edit
-2. Click the "Edit this file" button (the pencil icon)
-3. Make your changes and submit a pull request
-
-### Option 2: Local development
-
-1. Fork and clone this repository
-2. Install the Mintlify CLI: `npm i -g mint`
-3. Create a branch for your changes
-4. Make changes
-5. Navigate to the docs directory and run `mint dev`
-6. Preview your changes at `http://localhost:3000`
-7. Commit your changes and submit a pull request
-
-For more details on local development, see our [development guide](development.mdx).
-
-## Writing guidelines
-
-- **Use active voice**: "Run the command" not "The command should be run"
-- **Address the reader directly**: Use "you" instead of "the user"
-- **Keep sentences concise**: Aim for one idea per sentence
-- **Lead with the goal**: Start instructions with what the user wants to accomplish
-- **Use consistent terminology**: Don't alternate between synonyms for the same concept
-- **Include examples**: Show, don't just tell
+- Work on `main`.
+- Match the live contract in `~/Herd/trypost-connect` (`routes/api.php`, MCP server).
+- Preview with `mint dev`. Check links with `mint broken-links`.

CONTRIBUTING.md

@@ -1,40 +1,28 @@
-# TryPost Docs
+# TryPost Connect Docs
 
-Documentation for [TryPost](https://github.com/trypost-it/trypost) — open source social media scheduling.
+Documentation for [TryPost Connect](https://connect.trypost.it) — social publishing infrastructure (REST + MCP). Built with [Mintlify](https://mintlify.com).
 
-## Development
+This is **not** the old TryPost scheduler docs.
 
-Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview changes locally:
+## Development
 
 ```bash
 npm i -g mint
-```
-
-Run at the root of the project:
-
-```bash
 mint dev
 ```
 
 Preview at `http://localhost:3000`.
 
 ## Publishing
 
-Changes pushed to the `main` branch are deployed automatically via the [Mintlify GitHub app](https://dashboard.mintlify.com/settings/organization/github-app).
+Pushes to `main` deploy via the [Mintlify GitHub app](https://dashboard.mintlify.com/settings/organization/github-app).
 
 ## Structure
 
 ```
-├── getting-started/    # Installation, configuration, first steps
-├── platforms/          # LinkedIn, X, Facebook, Instagram, TikTok, YouTube, Threads, Pinterest, Bluesky, Mastodon
-├── features/           # Scheduling, workspaces, team management
-├── self-hosting/       # Requirements, production, Docker
-├── contributing.mdx    # Contributing guide
-└── docs.json           # Mintlify configuration
+├── getting-started/   # Auth, first publish
+├── guides/            # Connect, media, posts, sets, webhooks, MCP, billing
+├── platforms/         # Per-network content types and limits
+├── api-reference/     # REST endpoints
+└── docs.json
 ```
-
-## Links
-
-- [TryPost](https://github.com/trypost-it/trypost)
-- [Issues](https://github.com/trypost-it/trypost/issues)
-- [Discussions](https://github.com/trypost-it/trypost/discussions)