Cat-Factory
Home
  • Introduction
  • Core Concepts
  • Quick Start
  • Designing Your Board
  • Shared Services
  • Requirements
  • Running Pipelines
  • Recurring Pipelines
  • Pull Requests & Merging
  • Repositories
  • Issue & Document Sources
  • Budgets & Spend
  • Prompt Fragments
  • Deploy to Cloudflare
  • Deploy to Node.js
  • Configuration
  • Self-Hosted Runner Pools
  • Ephemeral Environments
  • Architecture
  • Integration Manifests
  • Packages & Repository Layout
GitHub
Home
  • Introduction
  • Core Concepts
  • Quick Start
  • Designing Your Board
  • Shared Services
  • Requirements
  • Running Pipelines
  • Recurring Pipelines
  • Pull Requests & Merging
  • Repositories
  • Issue & Document Sources
  • Budgets & Spend
  • Prompt Fragments
  • Deploy to Cloudflare
  • Deploy to Node.js
  • Configuration
  • Self-Hosted Runner Pools
  • Ephemeral Environments
  • Architecture
  • Integration Manifests
  • Packages & Repository Layout
GitHub
  • Get Started

    • Introduction
    • Core Concepts
    • Quick Start
  • Using Cat-Factory

    • Designing Your Board
    • Shared Services
    • Requirements
    • Running Pipelines
    • Recurring Pipelines
    • Pull Requests & Merging
    • Repositories
    • Issue & Document Sources
    • Budgets & Spend
    • Prompt Fragments

Prompt Fragments

Prompt fragments are reusable, version-controlled guidelines that agents pull into their prompts at run time. Encode your team's standards once - coding conventions, review checklists, security rules - and apply them everywhere.

The three scopes

Fragments are organized in a tenant-scoped library with three tiers. Lower tiers layer on top of higher ones:

ScopeApplies toUse it for
Built-inEveryoneBest practices shipped with the platform.
AccountAll workspaces in your accountOrganization-wide standards.
WorkspaceA single boardPer-project customization.

You can also source fragments from a repository so they live under version control alongside your code.

How agents use them

Agents select the applicable fragments per run, based on the pipeline configuration. The right guidelines are injected for the right step - a code-style fragment for the coder, a review checklist for the reviewer - without you re-pasting them each time.

Versioning

Fragments are version-controlled, and a specific version can be selected per run. This gives you:

  • A stable history of how guidance has changed.
  • The ability to pin a run to a known fragment version.
  • A clean way to evolve standards without disrupting in-flight work.

Putting it together

Built-in defaults
   └─ + Account standards
        └─ + Workspace tweaks
             └─ selected per-run, per-step  →  agent prompt

Start small

Begin with one or two account-level fragments (a coding-style guide and a review checklist), then add workspace fragments only where a specific board needs to differ.


That completes the usage guides. For operating the platform, head to Deploy & Operate, or browse the Reference.

Edit this page on GitHub
Last Updated: 6/20/26, 6:44 PM
Prev
Budgets & Spend