# MixerSystem

MixerSystem is a package-first workflow engine used to run an AI-assisted delivery flow:

1. `task` -> establish `task.md`
2. `plan` -> produce `plan.md`
3. `work` -> implement/test and maintain `work.md`
4. `update` -> analyze changes and suggest `update.md`
5. `upgrade` -> mine agent logs for generalizable rules and suggest `upgrade.md`

## Package Layout

- `mixersystem/workflows/`
- `mixersystem/data/`
- `mixersystem/hooks/`
- `mixersystem/SKILL.md`
- `mixersystem/sync.py`

## Runtime Model

Install in editable mode for local development:

```bash
python3 -m pip install -e .
```

Generate runtime settings + skill in a target project:

```bash
python3 -m mixersystem sync --project_root=<project_root>
```

Or initialize runtime scaffolding (currently runs `sync` and prints an init confirmation):

```bash
python3 -m mixersystem init --project_root=<project_root>
```

This generates:

- `.mixer/settings.json`
- `.mixer/README.md`
- `.claude/skills/mixer/SKILL.md`
- Claude Code hooks in `.claude/settings.json`

Run workflows through the package CLI:

- `python3 -m mixersystem run task ...`
- `python3 -m mixersystem run plan ...`
- `python3 -m mixersystem run work ...`
- `python3 -m mixersystem run update ...`
- `python3 -m mixersystem run upgrade ...`

## Documentation Map

- Product-level doc: `mixersystem/doc.md`
- Layer docs:
  - `mixersystem/workflows/doc.md`
  - `mixersystem/data/doc.md`

## Fixture Projects

Framework fixture projects live under:

- `projects/project-a`

Use this fixture for workflow regression tests (copy it to a temp run directory first).
