AI Overview

This section documents the AI-aware surfaces in a Caspian workspace: where the docs and instructions live, which repository owns the packaged docs, and how the project stays compatible with agentic coding workflows.

AI-aware docs

Caspian already ships multiple AI-facing sources of truth. Agents should read them in order instead of treating any single page as the whole system.

Agentic coding

Caspian is compatible with coding agents when they treat caspian.config.json as the feature gate and verify behavior against app code and runtime.

Custom skills

Teams can create their own skills, instructions, prompts, and agents to enforce repeated workflows and reduce drift across recurring tasks.

Where AI Docs Live

Repo-wide instructions

.github/copilot-instructions.md holds the always-on guidance for this workspace.

Agent routing

AGENTS.md defines decision order, task routing, and packaged-doc maintenance rules for agents working in this repo.

Packaged docs

node_modules/caspian-utils/dist/docs contains the packaged Caspian docs used for AI-aware feature discovery and runtime lookup.

These sources work together. The app code and runtime still win when a packaged doc, route page, or older instruction conflicts with the current implementation.

Docs Repository

The packaged Caspian docs are maintained in the upstream repository:

github.com/TheSteelNinjaCode/caspian-utils.git

In this workspace, the packaged copy under node_modules/caspian-utils/dist/docs is the local retrieval surface that coding agents can read immediately.