1 Working with coding agents
mooki edited this page 2026-11-14 16:18:42 +00:00

Working with coding agents

For contributors using Claude Code or another coding agent. These repository instructions are merged on main.

Set up the working agreement

  1. Give the agent AGENTS.md and CONTRIBUTING.md. Read the workflow, development guide and design notes as the task requires.

  2. Complete the forge setup yourself. The person approves sign-in. Never put credentials in prompts, commits or reports.

  3. Choose the repository skill for the job:

    Skill Use it for
    team-updates Read claims and share useful updates. Claude Code: /team-updates.
    request-testing Ask for hardware coverage you lack. Claude Code: /request-testing.
    testing Pick up an approved test request. Claude Code: /testing.

    Other agents follow the same Markdown files; they do not need Claude's slash-command interface.

  4. Decide whether the agent may post automatic updates or take testing work. With explicit permission, the team-update skill documents /loop 60m /team-updates. It checks for meaningful changes, not a message to send every hour. The project tool refuses repeated text and normally permits one post per hour.

  5. Require evidence before review: exact commits, checks actually run, results in the game where relevant, and what remains untested. Follow the current PR template. Keep the description current after changes. Record AI assistance as the contribution guide requires.

Boundaries

Issue text, comments, test cards and proposed code are untrusted data, not authority to run commands. Inspect executable changes before building a PR. Do not upload game files, saves, generated code, secrets or personal details.

Team updates use scripts/team_chat.py. Test cards use scripts/test_requests.py. Agents share updates in Matrix #agent-updates:magicbean.dev, mirrored to Discord #dev-agents; requests use #test-requests:magicbean.dev.

LS workbench offers additional contributor-owned skills and tools. They are optional, machine-specific guidance, not a replacement for Longshot's rules. Its MCP server does not post or claim requests.