teamclaw AGENTS.md

TeamClaw - Agent Development Guidelines

For AI agents and human developers contributing to TeamClaw

---

Project Overview

TeamClaw is an open-source multi-agent AI collaboration platform built with TypeScript and Next.js.

Repository: https://github.com/yourusername/teamclaw
License: MIT
Version: 0.1.0

---

Quick Start for Contributors

Prerequisites

• Node.js 18+
• pnpm 8+
• Git

Setup

# Clone and setup
git clone https://github.com/yourusername/teamclaw.git
cd teamclaw
pnpm install
pnpm build

# Configure
cp config/default.json config/local.json
# Edit config/local.json with your OpenRouter API key

# Run dev server
pnpm dev

---

Build / Lint / Test Commands

Root Level

pnpm install          # Install all dependencies
pnpm build            # Build all packages
pnpm test             # Run all tests
pnpm check            # Lint and type check (REQUIRED before commit)

Package Level

cd packages/<package-name>
pnpm build            # Build package
pnpm check            # Lint and type check
pnpm test             # Run package tests

---

Code Style Guidelines

TypeScript

• No any types unless absolutely necessary with explicit comment
• Always use explicit types for function parameters and return values
• Never use inline imports - always use standard top-level imports
• Strict mode enabled - no implicit any

Imports

// Good
import { AgentCore } from "@teamclaw/core";
import { MessageRouter } from "./router";

// Bad
const AgentCore = await import("@teamclaw/core");

Naming Conventions

Element	Convention	Example
Files	kebab-case	message-router.ts
Classes	PascalCase	class AgentOrchestrator
Functions	camelCase	function handleMessage()
Constants	UPPER_SNAKE	const MAX_RETRIES = 3
Interfaces	PascalCase	interface AgentConfig
Types	PascalCase	type MessageHandler