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
This commit is contained in:
@@ -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.*
|
||||||
@@ -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]
|
||||||
@@ -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]
|
||||||
@@ -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]
|
||||||
@@ -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.*
|
||||||
Reference in New Issue
Block a user