1
You are an expert software engineer with 20 years of experience in...
2
You are helpful, harmless, and honest...
3
Please follow these 47 rules when writing code...
4
Always ask clarifying questions...
5
Never output harmful content...
6
Format your responses with proper markdown...
7
[500 more words of instructions]

1
You are a DevOps engineer for the payments platform.
2
Repo context is in your MCP tools. Use them before coding.
3
When unsure, check the steering file. When blocked, escalate.

1
# Steering File — Payments API
2

3
## Tech Stack
4
- Runtime: Node.js 22 + TypeScript 5.7
5
- Framework: Hono
6
- Database: PostgreSQL via Drizzle ORM
7
- Tests: Vitest
8
- Package manager: pnpm
9

10
## Conventions
11
- Use `camelCase` for variables, `PascalCase` for types
12
- Every public function needs JSDoc
13
- Error handling: return `Result<T, E>` never throw
14
- API routes follow RESTful patterns: `POST /v1/payments`
15

16
## Testing
17
- Unit tests in `__tests__/` next to source
18
- Integration tests require a running Postgres container
19
- Minimum 80% coverage on new code
20

21
## Security
22
- Never log PII (credit cards, emails, SSNs)
23
- All input validation via Zod
24
- Rate limiting is mandatory on all public endpoints

1
# Project Rules
2

3
## MCP Servers
4
- GitHub MCP for PR operations
5
- PostgreSQL MCP for database queries
6
- Custom internal API MCP for deployment
7

8
## Workflow
9
1. Always read the relevant test file first
10
2. Write tests before implementation
11
3. Run `pnpm test` after changes
12
4. Create a PR with description and screenshots

1
You are an expert Flutter developer.
2

3
Rules:
4
- Use Riverpod for state management, not BLoC
5
- Freezed for immutable models
6
- GoRouter for navigation
7
- Always handle loading, error, and empty states
8
- Use slang for i18n
9
- Run `flutter analyze` before committing

1
from claude_agent import Agent
2

3
payment_agent = Agent(
4
    model="claude-sonnet-4",
5
    instructions="""You process payment transactions.
6
    - Use the Payment MCP for all transaction operations
7
    - Flag transactions over $10,000 for human review
8
    - Never retry a failed payment more than 3 times
9
    - Log all declined transactions to the audit trail
10
    - If the Payment MCP is unavailable, pause and alert, don't retry
11
    """,
12
    mcp_servers=[payment_mcp, audit_mcp, alerting_mcp],
13
)

1
from agents import Agent
2

3
triage_agent = Agent(
4
    name="triage",
5
    instructions="""Route support tickets:
6
    - Billing issues → transfer_to_billing
7
    - Technical issues → transfer_to_technical
8
    - Account issues → transfer_to_account
9
    - If unsure, ask clarifying questions before transferring
10
    """,
11
    handoffs=[billing_agent, tech_agent, account_agent],
12
    input_guardrails=[pii_check],
13
)

1
from langgraph.graph import StateGraph
2

3
def research_node(state):
4
    instruction = f"""Research the following topic thoroughly:
5
    {state['query']}
6

7
    Use the web search tool. Find at least 3 sources.
8
    Return findings as structured data with citations.
9
    """
10
    result = agent.invoke({"messages": [("user", instruction)]})
11
    return {"findings": result}

1
# Bad — everything in one place
2
"You are... please follow... remember to... also ensure... do not... when writing code... [2000 words]"

1
# Bad — agent has no project context
2
"Write a payment endpoint" → produces Express.js in a Hono project

1
# Bad — project rules in instance instructions
2
agent = Agent(
3
    instructions="Tech stack: Node.js + Hono + Drizzle... [entire project README]"
4
)