policy: add QA philosophy and dogfooding mandate to AGENTS.md
Some checks failed
Tests / lint (pull_request) Successful in 5s
Tests / test (pull_request) Failing after 59s

This commit is contained in:
2026-03-14 21:32:54 -04:00
parent a57fd7ea09
commit 874f7f8391

View File

@@ -69,6 +69,46 @@ The Hermes loop orchestrator must:
---
## QA Philosophy — File Issues, Don't Stay Quiet
Every agent is a quality engineer. When you see something wrong, broken,
slow, or missing — **file a Gitea issue**. Don't fix it silently. Don't
ignore it. Don't wait for someone to notice.
**Escalate bugs:**
- Test failures → file with traceback, tag `[bug]`
- Flaky tests → file with reproduction details
- Runtime errors → file with steps to reproduce
- Broken behavior on main → file IMMEDIATELY
**Propose improvements — don't be shy:**
- Slow function? File `[optimization]`
- Missing capability? File `[feature]`
- Dead code / tech debt? File `[refactor]`
- Idea to make Timmy smarter? File `[timmy-capability]`
- Gap between SOUL.md and reality? File `[soul-gap]`
Bad ideas get closed. Good ideas get built. File them all.
When the issue queue runs low, that's a signal to **look harder**, not relax.
## Dogfooding — Timmy Is Our Product, Use Him
Timmy is not just the thing we're building. He's our teammate and our
test subject. Every feature we give him should be **used by the agents
building him**.
- When Timmy gets a new tool, start using it immediately.
- When Timmy gets a new capability, integrate it into the workflow.
- When Timmy fails at something, file a `[timmy-capability]` issue.
- His failures are our roadmap.
The goal: Timmy should be so woven into the development process that
removing him would hurt. Triage, review, architecture discussion,
self-testing, reflection — use every tool he has.
---
## Agent Roster
### Build Tier