---
name: project
description: Understand the PoE2 Build Agent project structure, architecture, and systems
---

# Project Overview

Use this skill to understand the PoE2 Build Agent project structure.

## What This Project Is

An AI agent that generates Path of Exile 2 builds by:
1. Decomposing user prompts into sub-problems
2. Reasoning about solutions using domain knowledge
3. Validating builds via Path of Building 2 (headless)
4. Iterating on conflicts until a coherent build emerges

## Tech Stack

- **Language:** Rust 2021
- **LLM:** ChatGPT API
- **PoB:** mlua (embedded Lua) running HeadlessWrapper.lua
- **CLI:** clap + tokio

## Directory Structure

```
├── CLAUDE.md              # Minimal entry point
├── crates/
│   ├── agent/             # CLI + LLM orchestration
│   ├── pob-headless/      # PoB2 Lua integration
│   ├── wiki/              # Wiki data fetching
│   └── knowledge/         # Pre-loaded game data
├── docs/
│   ├── agent/             # Agent design docs
│   └── domain/            # PoE2 game mechanics
├── .claude/skills/        # On-demand context (you are here)
├── .project/
│   ├── backlog/           # Work to do
│   ├── done/              # Completed work
│   └── systems/           # Component state + ideas
└── vendor/                # PoB2 clone (gitignored)
```

## Key Systems

| System | Purpose | State |
|--------|---------|-------|
| Agent Core | CLI + reasoning loop | 🟡 Scaffold |
| PoB Headless | Build validation via PoB2 | 🔴 Not started |
| Wiki | Game data fetching | 🔴 Not started |
| Domain Knowledge | Skills + knowledge crate | 🟡 Early |

See `.project/systems/` for detailed state of each.

## How to Work on This Project

1. **Check tickets:** Look at `.project/backlog/` for work to do
2. **Understand the system:** Read relevant `.project/systems/` file
3. **Load domain knowledge:** Use skills like `/defense-layers`, `/damage-scaling`
4. **Follow conventions:** See CLAUDE.md for coding standards
5. **Complete work:** Move ticket to `.project/done/` when finished

## Related Skills

- `/tickets` - How to use the ticket system
- `/finalize-ticket` - Clean up after completing a ticket
- `/defense-layers` - PoE2 defense mechanics
- `/damage-scaling` - PoE2 damage mechanics
