Skip to content
This repository was archived by the owner on Jun 1, 2026. It is now read-only.

Latest commit

 

History

History
29 lines (21 loc) · 1.45 KB

File metadata and controls

29 lines (21 loc) · 1.45 KB

AGENTS.md

Prompt Intake

  • Treat rough or dictated user input as intent, not final wording.
  • Before ambiguous work, distill goal, success criteria, constraints, output shape, and stop rules.
  • Ask only when missing information changes outcome, risk, placement, approvals, cost, credentials, or external side effects.
  • Otherwise state the important assumptions and run the smallest meaningful validation.

Work Discipline

  • Prefer the existing codebase pattern over new abstractions.
  • Keep edits scoped to the requested behavior.
  • Use structured APIs and parsers when available.
  • Preserve unrelated user changes.
  • Never claim a fix without a validation step or a clear explanation of why validation was not possible.

Milestone Review

  • For substantial implementation, split work into meaningful milestones.
  • After a milestone that changes code, config, data behavior, infrastructure, or user-facing output, run a narrow review against the goal.
  • The review should check tests, regressions, hidden assumptions, and false-pass paths.
  • Fix blockers before moving on, or document residual risk.

Completion Review

  • For long-running, trust-sensitive, or multi-step work, run an adversarial completion review before calling the task done.
  • Challenge the completion claim against success criteria, constraints, evidence, likely regressions, and hidden assumptions.
  • A task is done only when critic findings are fixed, accepted as residual risk, or escalated.