diff --git a/AGENTS.md b/AGENTS.md index 71f05ba..c77b886 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,8 +5,12 @@ This document provides guidelines for AI agents working with the SuperPlane docu ## Repository Overview This repository contains the documentation for -[SuperPlane](https://github.com/superplanehq/superplane), an open source DevOps -control plane. The documentation site is built with +[SuperPlane](https://github.com/superplanehq/superplane), an open source AI +software factory for engineering teams. SuperPlane coordinates agents and +deterministic workflows to turn high-confidence routine work into verified, +review-ready pull requests. Workflows define scope, checks, approvals, +feedback, and escalation; agents perform the work within those guardrails. +The documentation site is built with [Starlight](https://starlight.astro.build), a documentation framework built on [Astro](https://astro.build). diff --git a/README.md b/README.md index a7a1a6c..bfd1267 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # SuperPlane Documentation -This repository contains the documentation for [SuperPlane](https://github.com/superplanehq/superplane), the open source DevOps control plane. +This repository contains the documentation for [SuperPlane](https://github.com/superplanehq/superplane), an open source AI software factory for engineering teams. SuperPlane coordinates AI agents, source control, continuous integration (CI), review, approvals, and feedback to move high-confidence routine work from the backlog to verified, review-ready pull requests. + +Agents perform the work. Workflows define the allowed scope, required checks, review policies, approval points, and escalation paths. This keeps control and verification in the workflow instead of depending on a specific model or agent. ## About diff --git a/scripts/generate-llms.mjs b/scripts/generate-llms.mjs index 72218b2..8497aeb 100644 --- a/scripts/generate-llms.mjs +++ b/scripts/generate-llms.mjs @@ -147,7 +147,7 @@ function buildLlmsTxt(sections) { const lines = [ "# SuperPlane Docs", "", - "> SuperPlane documentation for building and operating event-driven DevOps workflows.", + "> SuperPlane documentation for building and operating AI agent workflows that one-shot routine engineering work.", "", "This file provides a structured index of documentation pages for LLM-based tools.", "", @@ -166,7 +166,7 @@ function buildLlmsFullTxt(sections) { "", "> Comprehensive companion to `/llms.txt` with full page content for the current docs table of contents.", "", - "SuperPlane is an open source DevOps control plane for long-lived, event-driven workflows.", + "SuperPlane is an open source AI software factory that lets AI agents fully automate routine development work through long-lived, event-driven workflows.", "", ];