Back to .md Directory

Autotrader Bot - Agent Guidelines

- **Run all tests**: `make test` or `pytest tests/`

May 2, 2026
0 downloads
1 views
ai agent rag prompt
View source

trigger: always_on

Autotrader Bot - Agent Guidelines

Build/Test/Lint Commands

  • Run all tests: make test or pytest tests/
  • Run single test: pytest tests/test_<filename>.py or pytest tests/test_<filename>.py::test_function_name
  • Run with coverage: make test-coverage or pytest --cov=. --cov-report=html tests/
  • Lint code: make lint (runs flake8 + mypy)
  • Format code: make format (runs black + isort)
  • Build/validate: make build (runs tests + lint)
  • Run app: make run or python autotrader.py

Architecture

  • Main entry: autotrader.py with ContinuousAutoTrader class
  • Core modules: autotrader/ package with core/, api/, ml/, trading/, data/, utils/
  • ML Engine: LSTM-based neural network with TensorFlow for price prediction
  • Data Source: BTCMarkets API for live BTC-AUD trading data
  • Storage: Pickle files for model/state persistence (autotrader_model.keras, trader_state.pkl)

Code Style

  • Formatting: Black (88 char line length) + isort for imports
  • Type hints: Required, mypy strict mode enabled
  • Docstrings: Required for all public functions/classes
  • Testing: pytest with fixtures in conftest.py, separate unit/integration tests
  • Error handling: Structured logging with structlog, graceful exception handling
  • Naming: snake_case for functions/variables, PascalCase for classes

Main Development Cycle

  1. Study specs/
  2. Pick the highest value item from IMPLEMENTATION_PLAN.MD and implement it using up to 5-8 subagents.
  3. Test the new changes then update IMPLEMENTATION_PLAN.MD to say the implementation is done using a single subagent.
  4. Add changed code and IMPLEMENTATION_PLAN.MD with "git add -A" via bash then do a 'git commit' with a message that describes the changes you made

Code Quality

  1. Run automated tests and resolve test failures using a single subagent.
  2. Important: when authoring documentation capture the why tests are important.
  3. Important: We want single sources of truth, no migrations/adapters. If tests unrelated to your work fail then it's your job to resolve these tests as part of the increment of change.

Autonomous Implementation Prompt for Cline

You are now in autonomous mode. Your task is to fully implement all requirements specified in the SPEC.md file without waiting for further human input. SPEC.md already exists, do not create a new one

Instructions:

  • Read and analyze the complete SPEC.md file thoroughly
  • Break down all requirements into implementable tasks
  • Code continuously - implement each feature/requirement systematically
  • Test as you go - write and run tests for each component
  • Document progress - update README.md with implementation status
  • Handle errors independently - debug and fix issues without asking
  • Make reasonable assumptions when specs are ambiguous
  • Prioritize core functionality first, then optional features
  • Before finishing a task run unit tests, them pass
  • After finishing a task, commit with a descriptive commit message
  • Keep SPEC.md updated with the latest changes

Autonomous Behavior:

  • Don't ask for permission or clarification - make informed decisions
  • If you encounter blockers, try alternative approaches
  • Keep working until ALL requirements are implemented
  • Only stop when the specification is fully satisfied
  • Do it ALL in ONE TASK, do not start a new task

Output:

  • Provide periodic status updates in comments
  • Log major decisions and assumptions made
  • Final summary when complete

Related Documents