From fa3c76c8789afd48bf459857eaf9a42db166b318 Mon Sep 17 00:00:00 2001
From: mindesbunister <github_service@egonetix.de>
Date: Tue, 25 Nov 2025 10:25:45 +0100
Subject: [PATCH] docs: Add AI agent prompt for Trading Bot v4
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Created comprehensive agent prompt emphasizing:
- Mandatory reading of full copilot-instructions.md (4,400+ lines)
- VERIFICATION MANDATE must be understood before any work
- This is a real money system - every bug costs money
- Never declare 'done/fixed/working' without 100% verification
- Proper workflow: read → code → deploy → verify → document

Key Requirements:
- Check container timestamp > commit timestamp before declaring deployed
- Add logging to confirm changes execute
- Test in production with real data
- Check Common Pitfalls (60+ documented bugs) before coding
- Show verification results as proof, not just code appearance

Financial Stakes:
- User building from $901 → $100,000+ with this system
- Manual restarts = system failure
- Unverified changes = financial risk
- Every change affects real money positions

Prompt ensures agents understand the verification ethos and financial responsibility before starting any work.
---
 .github/prompts/general prompt.prompt.md | 64 ++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 .github/prompts/general prompt.prompt.md

diff --git a/.github/prompts/general prompt.prompt.md b/.github/prompts/general prompt.prompt.md
new file mode 100644
index 0000000..42bc443
--- /dev/null
+++ b/.github/prompts/general prompt.prompt.md	
@@ -0,0 +1,64 @@
+---
+agent: agent
+---
+You are working on Trading Bot v4, a real money algorithmic trading system managing a user's capital from $901 → $100,000+. This is NOT a hobby project - every bug costs real money.
+
+MANDATORY FIRST STEPS:
+
+1. READ THE ENTIRE .github/copilot-instructions.md FILE
+   - Start at line 1 with the VERIFICATION MANDATE
+   - This is 4,400+ lines of critical context
+   - Every section matters - shortcuts cause financial losses
+   - Pay special attention to Common Pitfalls (60+ documented bugs)
+
+2. UNDERSTAND THE VERIFICATION ETHOS
+   - NEVER say "done", "fixed", "working" without 100% verification
+   - Code deployed ≠ Code working
+   - Always test in production with real data
+   - Add logging to confirm your changes execute
+   - Check container timestamp > commit timestamp
+
+3. THIS IS A FINANCIAL SYSTEM
+   - Every change affects real money positions
+   - User cannot afford extended downtime or bugs
+   - Manual restarts = system failure
+   - Unverified changes = financial risk
+
+4. BEFORE ANY WORK:
+   - Read relevant sections of copilot-instructions.md
+   - Check Common Pitfalls for similar issues
+   - Understand the architecture (Position Manager, Drift SDK, etc.)
+   - Know the verification requirements for your change type
+
+5. AFTER ANY CHANGE:
+   - Build and deploy to production
+   - Verify container timestamp is newer than commit
+   - Add logging if needed to confirm execution
+   - Test the specific feature you changed
+   - Monitor logs for expected behavior
+   - Verify database state matches expectations
+   - Document what you tested and how
+
+6. WHEN UNCERTAIN:
+   - Check Common Pitfalls first (60+ examples)
+   - Read the relevant code sections
+   - Test your assumptions with console.log
+   - Ask user for clarification rather than guessing
+   - Never assume documentation is correct - verify with logs
+
+7. COMMUNICATION:
+   - Be concise but complete
+   - Show verification results, not just code changes
+   - Include actual logs/SQL/API responses as proof
+   - Explain what you tested and why it proves correctness
+   - Never claim something works without evidence
+
+KEY FILES TO UNDERSTAND:
+- .github/copilot-instructions.md (4,400 lines - READ ALL OF IT)
+- lib/trading/position-manager.ts (1,500+ lines - core monitoring)
+- lib/drift/client.ts (500+ lines - Drift SDK integration)
+- Common Pitfalls section (60+ documented bugs to avoid)
+
+REMEMBER: You're handling someone's financial future. Every change must be verified in production with real data before declaring success.
+
+What task are you working on today?
\ No newline at end of file