Advisor Agent

A senior hospitality consultant, run as a Claude Code agent.

It reads from a curated knowledge vault of ~480 notes — concepts, sources, people, and properties from hospitality strategy, brand, RM, F&B, ops, capex, deals, asset management, tech, and culture — and gives grounded, citable advice to hotel owners.

Built on the WAT framework (Workflows, Agents, Tools): probabilistic AI handles reasoning, deterministic Python handles execution. See CLAUDE.md for the architecture.

What's in this repo

CLAUDE.md          # Agent instructions — Claude Code loads this on start
prompts/           # The advisor persona + first-conversation prompt
workflows/         # Markdown SOPs the agent follows (e.g. corpus build)
knowledge/         # Obsidian vault — concepts, sources, people, properties
corpus/            # Source inventory (CSV) the vault was built from
references/        # Curation log + paywalled-shopping list
tools/             # Python utilities for vault scaffolding, validation,
                   # graph index, status updates

Quick start with Claude Code

1. Clone this repo:

   git clone https://github.com/th1-ai/advisor-agent.git
   cd advisor-agent

2. Install Python deps (only needed if you want to run the helper scripts in tools/):

   pip install -r requirements.txt

3. (Optional) Copy the env template if you want the helper scripts to call Claude directly:

   cp .env.example .env
   # then edit .env with your ANTHROPIC_API_KEY

4. Open in Claude Code:

   claude

   Claude Code will pick up CLAUDE.md automatically and start operating as the Advisor.

5. (Optional) Open the vault in Obsidian so you can browse and edit notes by hand: File → Open vault → select the knowledge/ folder.

How to use it

Ask the agent any hospitality strategy question. It will:

• Read the relevant notes from knowledge/ (sources, concepts, properties, people)
• Cite anchored claims with the source they came from
• Hedge when a note is verified: false (drafted from training, not yet read against the source)
• Tell you what it doesn't know, and what would unblock it

It will also help you grow the vault. The build workflow lives at workflows/build_hospitality_corpus.md. Add a row to corpus/inventory.csv and the agent can scaffold the source note, draft it, and link it into the graph.

Customising the vault

The vault that ships with this repo is opinionated — it's the working corpus from one hospitality consultancy. You can:

• Use it as-is to get a domain-specific advisor out of the box
• Extend it by adding sources, concepts, properties, or people (templates are in knowledge/_templates/)
• Replace it with your own domain. The WAT pattern (CLAUDE.md + prompts + workflows + vault) is domain-agnostic — swap the contents of knowledge/, prompts/, and workflows/ for your field and you have a different specialist agent

Tools

Python utilities in tools/, all callable from Claude Code via Bash or directly:

Script	What it does
build_graph_index.py	Builds knowledge/_index/graph.json from wikilinks across the vault
graph_retrieval.py	Retrieval helpers — neighbours, related notes, MOC entries
scaffold_source_note.py	Creates a new source note from an inventory.csv row
scaffold_stubs.py	Reads typed sections of source notes, creates stub notes for any wikilinks that don't yet exist
validate_vault.py	Sanity-checks the vault — frontmatter, broken links, orphans
update_status.py	Updates verified status on source notes
write_inventory.py	Writes / updates corpus/inventory.csv
_vault.py	Shared helpers (frontmatter parsing, wikilink extraction)

Configuration

Models are configured via ADVISOR_MODEL in .env. The default is claude-opus-4-7. You can swap to any current Claude model.

License

Code: MIT (see below). Knowledge vault content (notes in knowledge/): the curated notes draw on public sources cited in each note's frontmatter and body. Reuse with attribution to the original sources, not to this repo.

---

MIT License — Copyright (c) th1.ai

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.