agent_workspace

A general-purpose multi-agent development platform. Manages one external project repository with full AI agent infrastructure: worktree isolation, governance, skills, hooks, and multi-agent coordination.

Project Configuration

The managed project lives in project/ (gitignored). It is configured once via make setup, which will prompt for a git URL or local path:

After setup, configure your build and test commands in .agent/project_config.sh (gitignored, not committed):

Worktree Workflow

All work happens in isolated git worktrees:

For Codex or any tool that runs each shell command in isolation, use the execution-safe worktree entry modes instead of relying on source to persist:

For AI Agents

Read AGENTS.md before starting any task. The key rules:

• All work in worktrees — never edit the main tree
• Issue-first policy — open an issue before coding
• AI signature on all GitHub Issues/PRs/Comments

Documentation

• AGENTS.md — Rules for all agents
• CLAUDE.md — Claude Code specific setup
• CODEX.md — Codex CLI specific setup
• ARCHITECTURE.md — System design
• docs/decisions/ — Architecture Decision Records
• docs/PRINCIPLES.md — Guiding principles
• .agent/WORKTREE_GUIDE.md — Worktree patterns