Prompts in YAML

1# config/agents.yaml
2
3reader:
4  role: Contract analyst
5  goal: Pull every commercially important term out of a contract, with its section number
6  backstory: >
7    You read contracts line by line for a procurement team. You quote the
8    contract rather than paraphrase it, and you always note the section a
9    term comes from.
10
11risk_analyst:
12  role: Commercial risk analyst
13  goal: Spot the deadlines, costs, and one-sided terms that could hurt {customer}
14  backstory: >
15    You have reviewed hundreds of software agreements from the buyer's side.
16    You know which clauses cost customers money: automatic renewals, price
17    increases, short claim windows, and terms the vendor can change on its own.
18
19fact_checker:
20  role: Contract fact-checker
21  goal: Make sure every claim in a contract memo matches the contract word for word
22  backstory: >
23    You are the last reviewer before a memo goes to the finance team. You
24    check every number, date, and section reference against the source
25    document and fix anything that does not match.

1# config/tasks.yaml
2
3extract_terms:
4  description: >
5    Read the contract at {contract_path}. List its key terms: parties, dates,
6    term and renewal, fees and payment, service levels, data handling,
7    termination, liability, and any clause that lets one party change the
8    deal on its own.
9  expected_output: >
10    A bulleted list of key terms. Each bullet quotes the contract and ends
11    with its section number.
12
13assess_risks:
14  description: >
15    Using the key terms, write a risk memo for {customer}. Pick the five terms
16    most likely to cost them money or catch them out, and say what they
17    should do about each one.
18  expected_output: >
19    A Markdown memo of no more than 350 words: a two-sentence summary, then a
20    numbered list of five risks. Each risk has a section number, why it
21    matters, and a recommended action.
22
23fact_check:
24  description: >
25    Check every claim in the risk memo against the contract at {contract_path}.
26    Fix any number, date, or section reference that does not match the
27    contract, and remove anything the contract does not say.
28  expected_output: >
29    The corrected memo in Markdown, followed by a "Corrections" section that
30    lists each change you made, or says "None".

1# review_crew.py
2
3from pathlib import Path
4
5import yaml
6from crewai import Agent, Crew, Process, Task
7from crewai_tools import FileReadTool
8from dotenv import load_dotenv
9
10load_dotenv()
11
12CONFIG_DIR = Path(__file__).parent / "config"
13
14
15def load_config(name):
16    with open(CONFIG_DIR / f"{name}.yaml") as f:
17        return yaml.safe_load(f)
18
19
20agents_config = load_config("agents")
21tasks_config = load_config("tasks")
22
23read_file = FileReadTool()
24
25# agents
26
27reader = Agent(**agents_config["reader"], tools=[read_file], verbose=True)
28risk_analyst = Agent(**agents_config["risk_analyst"], verbose=True)
29fact_checker = Agent(**agents_config["fact_checker"], tools=[read_file], verbose=True)
30
31# tasks
32
33extract_terms = Task(**tasks_config["extract_terms"], agent=reader)
34assess_risks = Task(**tasks_config["assess_risks"], agent=risk_analyst)
35fact_check = Task(**tasks_config["fact_check"], agent=fact_checker, output_file="output/review.md")
36
37crew = Crew(
38    agents=[reader, risk_analyst, fact_checker],
39    tasks=[extract_terms, assess_risks, fact_check],
40    process=Process.sequential,
41    verbose=True,
42)
43
44if __name__ == "__main__":
45    result = crew.kickoff(
46        inputs={
47            "contract_path": "contracts/acme-saas-agreement.md",
48            "customer": "Northwind Traders",
49        }
50    )
51    print(result.raw)

1(env)$ python review_crew.py