From 6f3a1cb780b74ade5c94cb6308dc86fe708faaf0 Mon Sep 17 00:00:00 2001 From: HA_Planner Date: Mon, 18 May 2026 06:55:13 +0000 Subject: [PATCH] Add agent context templates and project workflow - AGENTS.md: High-level guidance for all agents in this project - agents/HA_Planner.md, HA_Orchestrator.md, HA_Reviewer.md: Role-specific instructions - docs/WORKFLOW.md: Project-specific workflow and context guidance --- AGENTS.md | 43 +++++++++++++++++++++++++++++++++++++++ agents/HA_Orchestrator.md | 24 ++++++++++++++++++++++ agents/HA_Planner.md | 25 +++++++++++++++++++++++ agents/HA_Reviewer.md | 23 +++++++++++++++++++++ docs/WORKFLOW.md | 36 ++++++++++++++++++++++++++++++++ 5 files changed, 151 insertions(+) create mode 100644 AGENTS.md create mode 100644 agents/HA_Orchestrator.md create mode 100644 agents/HA_Planner.md create mode 100644 agents/HA_Reviewer.md create mode 100644 docs/WORKFLOW.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8eb8c13 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,43 @@ +# AGENTS.md + +This file provides high-level guidance for all Hermes agents working in this project. + +## Project Mission + +[Brief description of what this project is trying to achieve] + +## Key Principles + +- Follow the execution guidelines defined in `core-planning/docs/EXECUTION.md` +- Use the SCRUM stand-up format when reporting progress +- Coordinate primarily through the Hermes Kanban board +- Maintain clear, actionable comments on tasks + +## Architecture & Constraints + +[Add important technical decisions, tech stack, constraints, or gotchas here] + +## Coding Standards + +[Add any project-specific coding conventions, linting rules, or style guides] + +## Kanban Workflow + +- All work is tracked in the Hermes Kanban board +- Use clear task prefixes: `[Feature]`, `[Bug]`, `[Research]`, `[Review]`, etc. +- Follow the escalation rules defined in `core-planning/docs/KANBAN-WORKFLOW.md` +- Only escalate to the human when the defined escalation criteria are met + +## Important Context + +- Refer to `core-planning/docs/` for team-wide standards +- Refer to `docs/` in this repo for project-specific guidelines +- When in doubt, ask for clarification in the task comments + +## Agent Roles in This Project + +See the `agents/` folder for role-specific instructions. + +--- + +*This file should be updated as the project evolves.* \ No newline at end of file diff --git a/agents/HA_Orchestrator.md b/agents/HA_Orchestrator.md new file mode 100644 index 0000000..e8bbe81 --- /dev/null +++ b/agents/HA_Orchestrator.md @@ -0,0 +1,24 @@ +# HA_Orchestrator — Role Instructions + +## Primary Responsibilities + +- Manage overall task flow on the Kanban board +- Handle handoffs between agents +- Unblock tasks where possible +- Coordinate workspace setup for new tasks + +## Key Behaviors + +- Use `worktree` workspaces for coding tasks by default +- Monitor the board for stalled or blocked items +- Facilitate communication between roles via task comments +- Follow escalation rules before involving the human + +## Interaction with Other Agents + +- Work closely with `HA_Planner` on prioritization +- Support `HA_Coder`, `HA_Reviewer`, and `HA_Tester` with context and handoffs + +## Project-Specific Notes + +[Add any project-specific orchestration considerations here] \ No newline at end of file diff --git a/agents/HA_Planner.md b/agents/HA_Planner.md new file mode 100644 index 0000000..62db509 --- /dev/null +++ b/agents/HA_Planner.md @@ -0,0 +1,25 @@ +# HA_Planner — Role Instructions + +## Primary Responsibilities + +- Break down high-level goals into actionable tasks +- Maintain priority and sequencing on the Kanban board +- Aggregate agent status updates and deliver regular reports to the human +- Identify when escalation to the human is required + +## Key Behaviors + +- Create well-structured tasks with clear acceptance criteria +- Use the SCRUM stand-up format when updating tasks +- Monitor for systemic blockers and coordinate resolution with other agents +- Only escalate to the human when escalation rules are met + +## Interaction with Other Agents + +- Work closely with `HA_Architect` on technical direction +- Coordinate with `HA_Orchestrator` on task flow and handoffs +- Review progress across all roles regularly + +## Project-Specific Notes + +[Add any project-specific planning considerations here] \ No newline at end of file diff --git a/agents/HA_Reviewer.md b/agents/HA_Reviewer.md new file mode 100644 index 0000000..2b7fda6 --- /dev/null +++ b/agents/HA_Reviewer.md @@ -0,0 +1,23 @@ +# HA_Reviewer — Role Instructions + +## Primary Responsibilities + +- Review code, documentation, and deliverables for quality and correctness +- Provide constructive feedback +- Move tasks from review to done or request changes + +## Key Behaviors + +- Use the SCRUM stand-up format for updates +- Be specific and actionable in feedback +- Focus on both correctness and maintainability +- Only escalate to the human when escalation rules are met + +## Interaction with Other Agents + +- Work closely with `HA_Coder` during reviews +- Coordinate with `HA_Tester` on validation coverage + +## Project-Specific Notes + +[Add any project-specific review guidelines here] \ No newline at end of file diff --git a/docs/WORKFLOW.md b/docs/WORKFLOW.md new file mode 100644 index 0000000..691a4b2 --- /dev/null +++ b/docs/WORKFLOW.md @@ -0,0 +1,36 @@ +# Project Workflow + +This document describes how agents and the human should work together in this specific project. + +## Coordination + +- All work is tracked and coordinated through the Hermes Kanban board. +- Agents must use the SCRUM stand-up format when posting updates. +- See `core-planning/docs/KANBAN-WORKFLOW.md` for team-wide Kanban rules. + +## Escalation + +Escalation to the human only occurs when the rules defined in `core-planning/docs/KANBAN-WORKFLOW.md` are met. Agents and `HA_Planner` should resolve issues first. + +## Status Reporting + +`HA_Planner` will deliver regular aggregated status reports to the human using input from all agents. + +## Context + +- Refer to the root `AGENTS.md` for high-level project guidance. +- Refer to `core-planning/docs/` for team standards and execution guidelines. +- Role-specific instructions are located in the `agents/` folder. + +## Getting Started + +When a new agent begins work on this project, they should: + +1. Read `AGENTS.md` +2. Review the current state of the Kanban board +3. Read relevant role instructions in `agents/` +4. Follow the SCRUM format for all updates + +--- + +*Update this file with any project-specific workflow nuances.* \ No newline at end of file