Files
PMOCrazycoder/opencode/AGENTs.md
Eric Coissac 9c914b989b Enhance Docker setup with new tools and configurations
Update Dockerfile to install additional tools (orla, rust-analyzer), configure user permissions, and set up bash completion.

Update docker-entrypoint.sh to export new environment variables and configure MCP language servers for multiple languages (Go, Python, Rust, TypeScript) with proper workspace and LSP settings.

Add new documentation file AGENTS.md with development guidelines and security rules.

Add pyproject.toml for Python project configuration with dependencies and dev tools.

Add src/PMOCrazyCoder.py as a new MCP server implementation with example tools.
2026-02-21 23:04:23 +01:00

1.6 KiB

AGENTS.md - Development Guidelines

Code Style Guidelines

General Principles

  • Use relative paths only (never absolute paths)
  • Operate strictly on explicitly mentioned files
  • Generate minimal, single implementations
  • Avoid speculation about missing files

Error Handling

  • Use structured error messages
  • Avoid verbose stack traces in user-facing output

Naming Conventions

  • Variables/functions: snake_case
  • Types/interfaces: PascalCase
  • Constants: UPPER_SNAKE_CASE

CRITICAL Security Rules

File Operations

  • NEVER delete files without explicit human authorization
  • NEVER modify files outside the scope of the requested task
  • Always use relative paths (never absolute paths)

Version Control with jj

  • Projects are managed with jj (Jujutsu), NOT Git
  • Before starting modifications to respond to a user prompt, run jj new to create a commit
  • This creates a baseline to revert all changes from that prompt if needed
  • Do NOT run jj new for every individual file change—only once at the start of a prompt response

File Generation Rules

  • Output only requested files
  • Do not modify unrelated files
  • Valid JSON without comments when requested
  • Assume no knowledge of other files unless provided

MCP Tools

  • Located in /opt/dev-tools/
  • Use SQLite for graph storage (.ai_index/graph.db)
  • Embeddings stored in .ai_index/embeddings/
  • AST data in .ai_index/ast/

LM Studio Integration

  • Local LLM API: http://host.docker.internal:1248
  • Model: qwen/qwen3-coder-next@4bit
  • Context window: 32768 tokens
  • Max output: 65536 tokens