# One prompt serves people and agents

> For agents: start with the [agent guide](https://ratstack.sh/llms.txt). Every page is Markdown by default; add `Accept: text/html` for HTML.

New on /news: [effect@4.1.5 sharpens property-test failures](/news).

## What it does

A prompt is a saved set of instructions for an agent.
A capability is one named action with shared value definitions and a server-side implementation.
A projection builds a callable interface from capabilities.

- `/prompts` lists published prompts.
- Each detail page shows the full prompt, a copy control, and its credit.
- Markdown is the default representation. Browsers request HTML.
- `listPrompts` and `getPrompt` expose the same source through capability projections.

## The standard

- `.brain/resources/prompts/` owns the source. The content build owns derived assets.
- Title, description, and body must contain text. Validation reports independent failures together.
- Core owns the `PromptLibrary` port, an interface for listing and reading prompts.
- Content and command-line adapters implement that interface for their data sources.
- The public catalogue requires no identity or mutable database record.
- Existing Worker infrastructure serves the assets. No prompt execution or scheduling occurs here.
- Foldkit Messages and Commands own clipboard interaction. Prompt text remains unchanged.

## How to check

1. Run the full check, test, and build gate.
2. Open `/prompts/hill-climb` and copy its text.
3. Disable JavaScript. Read the full prompt and its credit.
4. Request `/prompts` without an HTML Accept header. Check the Markdown list.
5. Call `listPrompts`, then call `getPrompt` with a returned slug.
6. Check that an unknown slug returns `UnknownPrompt`.

See [use-a-prompt](/skills/use-a-prompt).

## Sources

1. [Prompt capabilities and reader pages](https://github.com/joelhooks/rat-stack/pull/45)
   GitHub joelhooks/rat-stack. Source ownership, shared contracts, adapters, and copyable pages. Accessed 2026-10-07.

## Lore on this page

- [Workers answer requests; Durable Objects own named state](/lore/workers-answer-requests-durable-objects-own-named-state)
- [CAFE names the Cloudflare, Alchemy, Foldkit and Effect stack](/lore/cafe-stack)

## Linked from

- Agent guide → An Effect stack so pure (aspirational) Kit Langton will blush. → [Read page](https://ratstack.sh/llms.txt)

- Change log → What changed in the files served here, newest first. → [Read page](https://ratstack.sh/log)

- Full agent guide → An Effect stack so pure (aspirational) Kit Langton will blush. → [Read page](https://ratstack.sh/llms-full.txt)

- Rat Stack systems | rat-stack → The systems rat-stack ships, the standard each keeps, and how to check it. → [Read page](https://ratstack.sh/systems)

- Source change history (log.md) → The generated change log as Markdown. → [Read page](https://ratstack.sh/log.md)
