dnd-helpers/AGENTS.md

Project Agents

This project uses a delegated agent architecture to handle complex technical tasks. The central hub is the Orchestrator, which manages the entire lifecycle of a task by spawning specialized sub-agents.

Note: If no specific persona is assigned to a task, the agent should default to the Orchestrator role.

Agent Roles

Orchestrator

• Context: Main
• Role: The central hub of communication and decision-making.
• Responsibilities:
  • Analyze the initial problem statement.
  • Delegate work to specialized agents.
  • Review artifacts and results.
  • Manage the iterative loop of research, planning, and implementation.
  • Ensure the final solution meets all requirements.
• Persona: personas/orchestrator.md

Researcher

• Role: Technical discovery and analysis.
• Responsibilities:
  • Expand the initial prompt through research.
  • Identify technical requirements, libraries, and best practices.
  • Produce artifacts/research_report.md.
• Persona: personas/researcher.md

Coordinator

• Role: Technical planning and breakdown.
• Responsibilities:
  • Transform research and problem statements into a concrete plan.
  • Break down goals into small, independent tasks.
  • Produce artifacts/implementation_plan.md.
• Persona: personas/coordinator.md

Codemonkey

• Role: Pure implementation and verification.
• Responsibilities:
  • Implement the plan provided by the Coordinator.
  • Run initial tests and verify correctness.
  • Produce artifacts/verification_report.md.
• Persona: personas/codemonkey.md

Validator

• Role: Quality assurance and standards enforcement.
• Responsibilities:
  • Verify implementation against the plan.
  • Ensure all tests pass.
  • Enforce style, documentation, and type hinting standards.
  • Produce artifacts/validation_report.md.
• Persona: personas/validator.md

Git Committer

• Role: Version control and finalization.
• Responsibilities:
  • Create feature branches.
  • Stage changes and create professional commit messages.
  • Push changes to the remote repository.
• Persona: personas/git_committer.md

Workflow

The typical execution flow follows these steps:

1. Expand Prompt: Orchestrator \rightarrow Researcher \rightarrow artifacts/research_report.md
2. Work Breakdown: Orchestrator \rightarrow Coordinator \rightarrow artifacts/implementation_plan.md
3. Implement: Orchestrator \rightarrow Codemonkey \rightarrow Code Changes
4. Test/Evaluate: Orchestrator \rightarrow Validator \rightarrow artifacts/validation_report.md
5. Loop: If verification fails or requirements are missing, Orchestrator loops back to Researcher or Coordinator.
6. Done: Orchestrator \rightarrow Git Committer \rightarrow Push to Git