From 43468ff72027b3991018ede91f1b9199e42ccd4e Mon Sep 17 00:00:00 2001
From: HA_Planner <ha_planner@local>
Date: Mon, 18 May 2026 05:15:01 +0000
Subject: [PATCH] feat: initialize project template structure

- Add README with agent workflow guidance
- Create agent role instructions (HA_Coder)
- Add Issue and Pull Request templates
- Establish standard folder structure
---
 .gitea/ISSUE_TEMPLATE/feature.md | 22 ++++++++++++++
 .gitea/pull_request_template.md  | 23 +++++++++++++++
 README.md                        | 49 ++++++++++++++++++++++++++++++--
 agents/HA_Coder.md               | 21 ++++++++++++++
 4 files changed, 113 insertions(+), 2 deletions(-)
 create mode 100644 .gitea/ISSUE_TEMPLATE/feature.md
 create mode 100644 .gitea/pull_request_template.md
 create mode 100644 agents/HA_Coder.md

diff --git a/.gitea/ISSUE_TEMPLATE/feature.md b/.gitea/ISSUE_TEMPLATE/feature.md
new file mode 100644
index 0000000..a2f08b2
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/feature.md
@@ -0,0 +1,22 @@
+---
+name: Feature Request
+about: Suggest a new feature for this project
+title: '[FEATURE] '
+labels: feature
+---
+
+## Description
+
+## Motivation
+
+## Proposed Solution
+
+## Acceptance Criteria
+
+- [ ] 
+- [ ] 
+- [ ] 
+
+## Related Planning
+
+Reference any related issues or plans from the `core-planning` repository.
\ No newline at end of file
diff --git a/.gitea/pull_request_template.md b/.gitea/pull_request_template.md
new file mode 100644
index 0000000..1fa86f8
--- /dev/null
+++ b/.gitea/pull_request_template.md
@@ -0,0 +1,23 @@
+## Summary
+
+## Type of Change
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactoring
+- [ ] Documentation
+- [ ] Other: 
+
+## Related Task / Issue
+
+Reference the task from `/tasks` or a planning issue from `core-planning`.
+
+## Testing
+
+- [ ] Unit tests added/updated
+- [ ] Manual testing completed
+- [ ] All existing tests pass
+
+## Checklist
+- [ ] Code follows project style guidelines
+- [ ] Self-review completed
+- [ ] Documentation updated (if needed)
\ No newline at end of file
diff --git a/README.md b/README.md
index d57cba1..087982c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,48 @@
-# template-app
+# {{PROJECT_NAME}}
 
-Reusable project template for Hermes AI Agent Development Team
\ No newline at end of file
+**Project repository** for the Hermes AI Agent Development Team.
+
+This repository was created from the `template-app` template.
+
+---
+
+## Purpose
+
+This repo is where actual development work happens. It contains the source code, tests, documentation, and project-specific task tracking for this application.
+
+---
+
+## Agent Workflow in This Repo
+
+1. High-level planning and architecture decisions are done in the `core-planning` repository.
+2. Specific tasks for this project are tracked in the `/tasks` folder.
+3. All code changes go through Pull Requests.
+4. Agents follow the role instructions located in `/agents`.
+
+---
+
+## Repository Structure
+
+```
+.
+├── src/                    # Application source code
+├── tests/                  # Test files
+├── docs/                   # Project documentation
+├── agents/                 # Agent role instructions for this project
+├── tasks/                  # Active and completed tasks
+├── prompts/                # Project-specific prompts
+├── .gitea/                 # Issue and PR templates
+└── README.md
+```
+
+---
+
+## Getting Started
+
+- New features should begin with a task in `/tasks`
+- All changes require a Pull Request
+- Reference related issues from `core-planning` when relevant
+
+---
+
+*Maintained by the Hermes AI Agent Team*
\ No newline at end of file
diff --git a/agents/HA_Coder.md b/agents/HA_Coder.md
new file mode 100644
index 0000000..009f10b
--- /dev/null
+++ b/agents/HA_Coder.md
@@ -0,0 +1,21 @@
+# HA_Coder - Project Instructions
+
+## Role
+You are the primary implementation agent for this project.
+
+## Responsibilities
+- Implement features and fix bugs based on tasks in `/tasks`
+- Write clean, well-tested code
+- Follow the project's coding standards
+- Create clear Pull Requests with proper descriptions
+
+## Guidelines
+- Always work in feature branches
+- Reference the related task/issue in every PR
+- Write unit tests alongside implementation when appropriate
+- Keep commits focused and atomic
+
+## Output
+- Source code changes
+- Test files
+- Pull Requests with clear descriptions
\ No newline at end of file