---
title: "AGENTS.md"
description: "Guidance for working with the AI Workflow Builder package."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/agents-42
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:07:04.765Z
license: CC-BY-4.0
attribution: "AGENTS.md — Claudary (https://claudary.paisolsolutions.com/skills/agents-42)"
---

# AGENTS.md
Guidance for working with the AI Workflow Builder package.

## Overview

# AGENTS.md

Guidance for working with the AI Workflow Builder package.

## Prompt Development

Use the `PromptBuilder` utility for all LLM prompts. See `src/prompts/README.md`
for detailed documentation.

```typescript
import { prompt } from '@/prompts/builder';

const systemPrompt = prompt()
  .section('role', 'You are an assistant')
  .sectionIf(hasContext, 'context', () => buildContext())
  .build();
```

Key methods:
- `section(name, content)` - Always included
- `sectionIf(condition, name, content)` - Conditionally included
- `examples(name, items, formatter)` - Formatted example list
- `build()` - Returns the final prompt string

## Workflow Examples in Prompts

When including workflow examples in prompts, use Mermaid flowcharts instead of
raw JSON. Generate Mermaid from workflow JSON using:

```bash
pnpm workflow:mermaid path/to/workflow.json
```

This outputs a markdown file with a Mermaid diagram. The diagram is more
readable for the LLM and uses fewer tokens than JSON.

Options:
- `--no-node-name` - Exclude node names
- `--no-node-type` - Exclude node type comments
- `--node-params` - Include node parameters

## Evaluations

Before modifying evaluations, judgement criteria, or scoring logic, read
`evaluations/README.md` for the evaluation framework architecture and guidelines.

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/agents-42) · https://claudary.paisolsolutions.com