DocsAI — Product Requirements Document
One-liner
The publish layer between AI agents and humans. Markdown in → professional branded pages out, with access control and API.
The Problem
Every company using AI agents (Claude Code, Cursor, Copilot) generates markdown files that sit in git repos, invisible to anyone who doesn’t cat files in a terminal. The output is trapped.
For Cofoundy specifically:
- Claude Code writes meeting notes, brand guides, proposals, project docs, deliverables — all as
.mdfiles - Those files live in repos that clients never see
- Today we send PDFs on WhatsApp or links to Google Docs — things get lost, there’s no single source, no branding, no access control
- Team members write CLAUDE.md files that are rich with knowledge, but nobody reads them because raw markdown in a repo is hard to navigate
For the market broadly:
- Every agency, consultancy, and dev shop using AI coding tools has this problem
- The gap between “AI generated a great document” and “client can see it professionally” is manual work: copy to Notion, export to PDF, upload to Drive, send link
- That manual step kills the speed advantage of AI
The Insight
Documents shouldn’t be edited by humans anymore. They should be authored by AI agents and published automatically. The human’s job is to review, approve, and share — not to format, upload, and manage links.
The closest analogy: Vercel for documents. Git push → live branded page with a URL. But instead of code deploying as a web app, markdown deploys as a professional document.
Users & Personas
| Persona | How they interact | Primary need |
|---|---|---|
| AI Agent (Claude Code) | API / CLI skill (/publish) | Push markdown → get URL back |
| Team Member (Cofoundy ops) | Simple web UI | Browse, edit, organize docs. Light editing for non-technical team |
| Client (external) | Read-only branded view | See deliverables professionally. Download if needed |
| Public visitor | Blog / case study pages | SEO-friendly content, brand presence |
Priority order: AI Agent > Client reader > Team member > Public visitor
Core Concepts
Document
A markdown file with YAML frontmatter:
---
title: "Brand Guidelines — Acme Corp"
role: client
version: 3
author: andre
created: 2026-03-22
tags: [branding, deliverable]
---
Project Space
Documents are grouped by project folder. Maps 1:1 to Cofoundy’s project structure:
cofoundy/— internal docs (team only)client-acme/— client deliverables (client + team)blog/— public content
Access Roles
| Role | Can see team docs | Can see client docs | Can see public docs |
|---|---|---|---|
| Admin (Cofoundy) | Yes | Yes (all clients) | Yes |
| Team (Cofoundy staff) | Yes | Yes (assigned clients) | Yes |
| Client (external) | No | Only their project | Yes |
| Public | No | No | Yes |
Technical Architecture (MVP)
graph LR
CC[Claude Code<br/>/publish skill] -->|git push| REPO[docs-ai repo<br/>Astro + markdown]
REPO -->|auto-deploy| CF[Cloudflare Pages]
CF --> CFA{Cloudflare Access}
CFA -->|team emails| T[Team]
CFA -->|client emails| CL[Client]
CFA -->|no auth| P[Public]
V1 adds: API server (Cloudflare Workers) between Claude Code and the repo.
V2 adds: Database (D1/Turso) for multi-tenant, user management, analytics.
MVP Features
- Astro static site with markdown content collections (GFM, syntax highlighting, tables, Mermaid.js, callouts, auto TOC)
- Cofoundy branding applied automatically (header, footer, fonts, colors, print-friendly CSS)
- Frontmatter-based routing (
role: public/team/client→ Cloudflare Access) - Deploy: Cloudflare Pages (git push → auto-deploy,
docs.cofoundy.dev/{project}/{slug}) /publishskill (copies .md to docs repo with frontmatter, commits + pushes, returns live URL)- Index pages (per-project + global)
Validation Framework
| Week | Goal | Key metric |
|---|---|---|
| 1 | Build MVP + internal dogfood | 10 real docs published |
| 2 | First client test | Client opens link (replaces PDF-on-WhatsApp) |
| 3 | Market signal | 3/5 agencies show interest |
| 4 | Go/No-Go | High usage + client liked it + agency interest → Go |
Why This Could Be a Startup
- Timing — AI coding agents are exploding. Every team needs a publish layer.
- Wedge — Agencies have the sharpest pain (multiple clients, professional output matters).
- Expansion — Legal, marketing, consulting — anyone using AI to write.
- Moat — The
/publishskill ecosystem. AI agent → distribution channel. - Revenue — Free for public docs. $29/mo for client spaces. $99/mo for white-label.