๐งฉ Do not give an AI agent only a prompt. Give it a project map.
Use Markdown files as an inference harness: they help the agent understand the repository, make safer decisions, and verify its own work.
Claude Code automatically reads CLAUDE.md at the start of a session. Similar project instruction files can be used by other coding tools, but the filename and loading behavior may differ.
Create these files:
CLAUDE.md
architecture.md
decisions.md
backlog.md
verification.md
Rules:
- Read these files before editing code.
- Inspect the repository before making assumptions.
- Update only the relevant Markdown file after a decision.
- Never mark a task complete without verification.
- If requirements conflict, report the conflict first.
verification.md
# Verification
## Every feature must pass
- [ ] Happy-path test
- [ ] Invalid-input test
- [ ] Authentication and authorization test
- [ ] Error-handling test
- [ ] Database or API integration test
- [ ] Manual user-flow test
## Completion rule
A feature is complete only when:
1. The code works.
2. Tests pass.
3. The change matches the acceptance criteria.
4. Known limitations are documented.
๐ง Rare architect trick:
Do not ask AI, โIs this code correct?โ
Ask it to produce:
1. Implementation
2. Evidence
3. Failed tests
4. Remaining assumptions
5. Recommended next test
This changes AI from a code generator into a system that must provide evidence.
OpenRouter Routing Trick
Use OpenRouter when you want one application to access multiple models and providers. It supports provider routing, fallbacks, and structured JSON responses.
const response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.OPENROUTER_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "YOUR_PRIMARY_MODEL",
models: [
"YOUR_PRIMARY_MODEL",
"YOUR_BACKUP_MODEL"
],
messages: [
{
role: "user",
content: "Return a risk assessment for this software change."
}
],
provider: {
require_parameters: true,
allow_fallbacks: true
},
response_format: {
type: "json_object"
}
})
});๐ require_parameters: true is useful when tools or structured output are essential. Otherwise, a fallback provider may not support the same capability.
๐ Research:
OpenRouter Provider Routing
OpenRouter API Reference
OpenAI Harness Engineering
Anthropic Agent Evals
Core idea
Prompt = what the agent should do
Markdown files = what the agent must understand
Verification = how the agent proves it worked
OpenRouter = how your application selects and switches models
Claim your Free $5 Bonus Here:
https://bit.ly/3wUxw09
LinkedIn profile ๐
https://www.linkedin.com/in/subarno-roy-3b2251374
Join our WhatsApp Channel ๐
https://whatsapp.com/channel/0029VbAi27y0lwghBe9mE42i
WhatsApp Community Link ๐
https://chat.whatsapp.com/G8wPqAwwm1qHo1AdM8YPkM
1๏ธโฃ Web Development and Web Design
๐ Channel Link:
[ https://t.me/webdevelopment_official ]
---
2๏ธโฃ DevOps
๐ Channel Link:
[ https://t.me/DevOpsofficial ]
---
3๏ธโฃ Software Development
๐ Channel Link:
[ https://t.me/softwaredevelopmentofficial ]
---
4๏ธโฃ Data Science
๐ Channel Link:
[ https://t.me/datascience_official ]
Share with your College Whatsapp Groups & Friends too
All the best ๐๐