Agent Instructions

This repository uses the GH Token Furnace Harness.

Required Flow

Work from a GitHub issue or an explicit local job contract.
Use a dedicated branch. Do not work directly on main or master.
Keep changes inside the issue scope.
Prefer reading, analysis, tests, and documentation over broad code mutation.
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.