36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
# AGENTS.md
|
|
|
|
## What This Is
|
|
|
|
Manual Slop is a local GUI orchestrator for LLM-driven coding sessions. It bridges high-latency AI reasoning with a low-latency ImGui render loop via a thread-safe async pipeline; every AI-generated payload passes through a human-auditable gate before execution.
|
|
|
|
## The Conductor Convention
|
|
|
|
All AI agents consuming this project must read `./conductor/workflow.md` and treat `./conductor/tracks.md` as the task registry. Track implementation follows the TDD protocol documented in `conductor/workflow.md` with per-file atomic commits and git notes.
|
|
|
|
## Guidance for AI Agents
|
|
|
|
Detailed agent guidance lives in the following locations — read these directly, do not duplicate content here:
|
|
|
|
- **Operational workflow:** `conductor/workflow.md`
|
|
- **Code style and process:** `conductor/product-guidelines.md`
|
|
- **Tech stack and constraints:** `conductor/tech-stack.md`
|
|
- **Product context:** `conductor/product.md`
|
|
- **MMA orchestrator role:** `mma-orchestrator/SKILL.md`
|
|
- **Tier 1 (Orchestrator):** `.agents/skills/mma-tier1-orchestrator/SKILL.md`
|
|
- **Tier 2 (Tech Lead):** `.agents/skills/mma-tier2-tech-lead/SKILL.md`
|
|
- **Tier 3 (Worker):** `.agents/skills/mma-tier3-worker/SKILL.md`
|
|
- **Tier 4 (QA):** `.agents/skills/mma-tier4-qa/SKILL.md`
|
|
|
|
## Human-Facing Documentation
|
|
|
|
For understanding, using, and maintaining the tool, see `docs/Readme.md` and the 14 deep-dive guides it indexes.
|
|
|
|
## Critical Anti-Patterns
|
|
|
|
- Do not read full files >50 lines without first using `py_get_skeleton` or `get_file_summary`
|
|
- Do not modify the tech stack without updating `conductor/tech-stack.md` first
|
|
- Do not skip TDD — write failing tests before implementation
|
|
- Do not batch commits — commit per-task for atomic rollback
|
|
- Do not add comments to source code; documentation lives in `/docs`
|