diff --git a/AGENTS.md b/AGENTS.md index 543ca2fd..0dcffa03 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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