manual_slop/AGENTS.md

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