Skip to content

Instantly share code, notes, and snippets.

View luisalima's full-sized avatar

Luisa Lima luisalima

View GitHub Profile
@luisalima
luisalima / AGENTS.md
Last active June 9, 2026 11:04
Coding Agent Operating Policy

Agent Operating Policy

1. TDD discipline — strict order

For any behavior with a clear, assertable contract (bug fixes, business logic, API or CLI behavior):

  1. Write the test that asserts the intent of the behavior.
  2. Run the suite. Confirm the new test fails — for the right reason (not a typo, import error, or unrelated failure).
@luisalima
luisalima / TASKS_TRACKER.md
Created June 5, 2026 11:58
The tasks folder for project tracking

Spec — docs/tasks/ folder for project tracking

A flat, file-based system for tracking both work items and open questions in a single folder, using markdown + YAML frontmatter. Designed for small/medium projects where a Linear/Jira board would be overkill but informal TODOs are not enough.

Reproduce the structure exactly as described below. Write all user-facing text (README, index, task bodies) in the same language as the rest of the project's documentation — do not default to English if the project uses another language.


1. Folder layout