Engineering
Q
"What auth provider are we on?"
→
Claude Code asks Halyard → Auth0 (per ADR-017, Sarah, Q3 2024). Firebase references are legacy.
ADR-017 · Notion#eng-decisions · SlackPR #412 · GitHub
Integrations · Claude Code
Halyard for Claude Code.
Point Claude Code at your team's real knowledge — Slack threads, PR decisions, meeting notes, docs — via one MCP server. Fewer hallucinations. Fewer "let me ask Sarah" round-trips. Citations inline.
01 · Install
Two commands.
The Halyard plugin is published to the halyard-labs marketplace. Add it, install it, authorise — you're grounded.
$ /plugin marketplace add halyard-labs/claude-plugin-marketplace
$ /plugin install ask-expert@halyard-labs
Plugin installed. Authorise via OAuth when prompted.
✓ halyard MCP server active
✓ connected to your Slack, Notion, GitHub
✓ claude can now use ask_expert + search_knowledge
Want every teammate to get this on their next session with zero manual setup? Drop the plugin into .claude/settings.json and commit — see the full docs.
02 · What Claude Code gains
Grounded answers,
not confident guesses.
Claude Code is great at writing code. Halyard makes sure it's writing code that matches what your team already decided.
Engineering
Q
"What's our rate-limiting pattern for auth endpoints?"
→
Fastify + @fastify/rate-limit with strict-auth preset. See fastify.config.ts.
fastify.config.ts#eng-decisions
Engineering
Q
"Who owns the payment service?"
→
Priya's team. Halyard routes via Slack if you want a real-time opinion.
#platform-paymentsTeam roster · Notion
03 · MCP tools available
Six tools. One server.
Halyard exposes a focused MCP surface. Claude Code chooses when to call which — no prompt engineering required.
→
search_knowledge
Hybrid (semantic + keyword + rank-fusion) retrieval across all your connected sources. Returns attributed answers with citations.
→
ask_expert
When the answer isn't in the knowledge base, Halyard routes the question to the right person in Slack and streams the reply back to Claude.
→
explore_knowledge
Graph traversal — "what else is related to this decision?" Returns supporting, superseding, and derived entries.
→
summarize_work
Claude captures a work summary back into the knowledge graph — attributed, indexed, queryable by the next agent.
→
list_team
Who's on the team? What are they the expert in? Claude Code calls this before ask_expert to pick a target.
→
upsert_contact · attach_mention
When Claude encounters a new person (customer, stakeholder), Halyard upserts them and links them to the conversation.
Make Claude Code actually know your stack.
Two commands, OAuth, and your agent stops guessing.