File size: 1,596 Bytes
a2be137 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | # Agent Instructions
This repository uses the GH Token Furnace Harness.
## Required Flow
1. Work from a GitHub issue or an explicit local job contract.
2. Use a dedicated branch. Do not work directly on `main` or `master`.
3. Keep changes inside the issue scope.
4. Prefer reading, analysis, tests, and documentation over broad code mutation.
5. Produce reviewable artifacts before asking for owner decisions.
## Allowed Work
- Read code and docs extensively.
- Run tests and verifier commands.
- Create audit, test, review, decision, and risk artifacts.
- Make small scoped fixes when the issue explicitly permits them.
## Repo-Specific Boundaries
- Treat `tower.yaml`, `focus.md`, `decisions.md`, and `runs/` as human-owned operator state unless an issue explicitly allows touching them.
- Store review artifacts under `artifacts/issue-<id>/` so parallel agent runs do not collide.
## Forbidden Work
- No open-ended feature building.
- No large rewrites.
- No new dependencies without owner approval and a documented alternative.
- No public API, auth, secrets, deployment, production config, or migration changes without a human gate.
- No architecture changes without a decision log.
## Required End State
Every agent run should leave an artifact directory such as `artifacts/issue-123/` containing:
- `AGENT_RESULT.md`
- Diff summary
- Test or verifier output
- Open risks
- Concrete follow-up issues
Stop and document `NEEDS_HUMAN` if the scope is unclear, a dependency or architecture decision is needed, more than 300 LOC would change, or behavior cannot be verified safely.
|