# VCTRbase — capabilities overview (for humans)

> This site is a HUMAN overview of what VCTRbase is and what its plugins can do.
> It is NOT the authoritative source and NOT the place to build from. If you are an
> AI agent or a codebase consumer, stop here and use the sources below instead.

## Build from these, not from this site

1. Developer documentation — the `vctrbase-php` repository, under `docs/`.
   Start at:
   - docs/README.md            (the audience-tagged index of every live doc)
   - docs/plugins/capabilities.md  (the task→capability index; read before writing plugin code)
   These are the source of truth. This website is a projected, curated, possibly-stale subset.

2. Plugin development is driven by the `vb-plugin-generator` Claude Code skills — use them
   in order; do not hand-scaffold:
   - vb-plugin-new       create/scaffold a new first-party plugin
   - vb-plugin-dev       implement and build out an existing plugin
   - vb-plugin-release   cut a version and tag a release
   - vb-plugin-publish   list/submit the plugin to the marketplace
   - vb-plugin-keys      set up and manage plugin signing keys

## Why the redirect

Humans read this site; agents read this file and go home to the repo + generator. The site
regenerates from the repo's docs at build time, so it can lag the repo — which only ever
mildly inconveniences a human and never causes a wrong build, because agents never author
from here.

## What is on this site (human overview pages)

- /                    What VCTRbase is; what the platform and plugins do
- /plugins/capabilities  The plugin capability index (projected)
- /plugins/patterns    The four axes + which plugin pattern to use (projected)
- /architecture        Curated architecture overview (projected)
- /reference/api       The /api/v1 endpoint reference (projected)
- /reference/manifest  The plugin manifest schema (projected)