ViteHub is still experimental. Expect bugs and breaking changes.

Agent instructions and skills

Separate repo-local coding-agent guidance from public ViteHub product docs.

Agent instructions and skills guide coding agents that edit this repository. They are not public product APIs, and they should not leak into ViteHub runtime docs.

Current sources

Source	Status	Use
`AGENTS.md`	Available in the repo	Repo-level instructions for agents editing ViteHub.
`.agents/domain.md`	Available in the repo	How agents should consume domain docs.
`.agents/CONTEXT-MAP.md`	Available in the repo	Map from work topics to context glossaries.
`.agents/contexts/**/CONTEXT.md`	Available in the repo	Domain vocabulary and ownership boundaries.
Public ViteHub skill	Implemented	Install with `npx skills add https://vitehub.dev`; the skill points agents to server primitives, Agent Definitions, `llms.txt`, and raw Markdown routes.
Public agent instruction bundle	Not implemented	Product behavior belongs in the public docs pages.

Boundary

Development-only agent guidance belongs under .agents/. Public docs should summarize the stable product behavior and link to implemented APIs instead of exposing every internal development note.

Audience split

Any future public affordance should separate three audiences.

Audience	Needs
Agents editing this repo	Read `AGENTS.md`, `.agents/domain.md`, and the relevant context glossary.
Agents building apps with ViteHub	Read product docs for server primitives, Agents, package references, examples, and AI resource indexes.
Agents embedded in ViteHub apps	Read application-provided Agent Instructions, Source Instructions, and Capability-owned guidance.

Use with Agent Definitions

Application Agent Instructions are runtime product behavior. They are not the same as repo instructions for coding agents.

server/agents/support.ts

import { defineAgent } from '@vite-hub/agent'

export default defineAgent({
  driver: {
    model,
    instructions: [
      'Answer from connected Workspace Sources first.',
      '{{ workspace.sources }}',
      '{{ capabilities }}',
    ].join('\n\n'),
  },
})

Next steps

Install the public skill with npx skills add https://vitehub.dev.
Use llms.txt for public docs discovery when a skill is not installed.
Use Markdown pages for full page source.
Use Instructions for Agent Definition instruction behavior.