Product Specification

AI-prompt-powered docs-as-code documentation system for SaaS APIs.

RepoDocs AI is a structured documentation system for SaaS and API teams that combines template libraries, metadata, prompt frameworks, diagrams, and validation into a repository-first workflow.

Target Market

Built for API-first engineering teams

  • Startup CTOs and heads of engineering
  • Developer relations leads
  • Technical writers working in Git repositories
  • SaaS organizations with 5 to 200 engineers

Product Goals

What the system must deliver

  1. Reduce time required to create API documentation
  2. Provide reusable documentation structure
  3. Enable AI-assisted documentation generation
  4. Support Git-based documentation workflows
  5. Enforce documentation quality standards

Repository Structure

The system is organized as a docs-as-code repository

repodocs-ai/
├── docs/
├── templates/
│   ├── api/
│   ├── product/
│   ├── features/
│   └── governance/
├── prompts/
├── diagrams/
├── validation/
├── schema/
└── examples/

Metadata

Frontmatter contract

  • title
  • description
  • service
  • component
  • owner
  • api_version
  • status
  • dependencies
  • last_reviewed
  • security_impact

Supported Stack

Repository and publishing targets

  • GitHub as the primary repository platform
  • Future GitLab and Bitbucket support
  • Docusaurus, MkDocs, GitBook, and Next.js docs sites
  • Markdown as the primary documentation format

Repository Source

The source Markdown spec stays in the repo.

The repository copy of the full specification lives at docs/product-specification.md. This HTML page exists so GitHub Pages users have a stable published URL instead of a broken link to Markdown outside the deployed site/ directory.