# Agent Instructions Directory

This directory contains project-specific instructions for agents working on the wg-admin project.

## Required Reading

All agents MUST read `AGENTS.md` before starting any work.

## Available Instructions

- `AGENTS.md` - Core principles and work discipline (READ THIS FIRST)
- `beads.md` - Beads workflow and command reference
- `explore.md` - Instructions for codebase exploration
- `librarian.md` - Instructions for research and documentation
- `oracle.md` - Instructions for architecture and debugging

## Agent Workflow

1. Read `.agent/AGENTS.md` for project mandates
2. Read agent-specific instructions (e.g., `explore.md`)
3. Execute work following established patterns
4. Use beads for tracking multi-session or complex work
5. Run `bd sync` before ending session

## Project Context

- **Issue tracking**: beads/bd CLI
- **External issues**: Gitea (https://gitea.calmcacil.dev)
- **Technology**: Bash/shell scripting
- **Purpose**: WireGuard VPN management tool