# AI Development Team Agent Pack

This repository is a boilerplate Git repo for running a Markdown-based AI software development team inside software projects.

## Purpose

The repo is organized so downstream projects can learn locally while still promoting durable improvements back into the shared upstream boilerplate.

## Ownership Model

- Reusable system rules live in `.ai/AGENTS.md`, `.ai/SKILLS.md`, and the reusable folders under `.ai/`
- Project-specific state lives in `.ai/project/`
- Local working notes and scratch files live in `.ai/logs/` and `.ai/local/`

## Recommended Sync Model

1. Start new work from this repo as a fork, template, or imported subtree.
2. Keep project-specific changes inside `.ai/project/`.
3. Capture durable lessons in `.ai/evolution/proposals/`.
4. Promote approved `upstream-candidate` changes back to this boilerplate repo.
5. Record released baseline changes in `.ai/version.md` and Git tags.

## Install Into Another Project

Copy the `.ai` folder, `CLAUDE.md`, and `AGENTS.MD` into the root of your software project.

## Start

Tell your AI coding agent:

```text
Read ./.ai/AGENTS.md and help me work as the Product Owner.
```

## Key Features

- Product Owner-centered delivery
- Specialized AI agent roles
- Skill routing
- Workflow templates
- Definition of Ready and Definition of Done
- Controlled self-evolution
- Upstream promotion workflow for durable AI learning