Files
fejkdata/AGENTS.md
T
2026-09-04 08:43:12 +02:00

1.7 KiB
Raw Blame History

Rules

  • Go runs only through docker compose run --rm <test|vet|fmt|build>; the merge gate is docker build ..
  • Tests first, in their own commit; the implementation follows in the next. A re-pin of seeded output is its own commit.
  • One-line commit messages: no ticket prefix, no repo name, no authorship trailers.
  • Hard tabs. No comment by default; delete a restatement, a rationale, history, or a file preamble.
  • One spelling per result: reject the other at New, and let the error name the spelling to use.
  • A standing choice a reader would relitigate goes under Decisions in the README, not in a comment.
  • A README example is a json block that loads and renders as a category; readme_test.go runs every one.
  • Cyclomatic complexity is gated at 14: the table-shaped dispatches (eachToken, calc.factor, walkPath) sit at 1314 and stay whole; anything else that reaches 14 is decomposed.

Deferred

  • A record cannot ask for an independent reference draw (2026-09-04). Within one record every tailed reference to a category is one draw, and a bare {/cat} renders the whole category, so a column wanting its own draw of {/cat.field} has no spelling for it. Left until a use case names which columns should disagree; premise: a record is one coherent row, which is what columns are for. Not raised in review before that.

  • Shipped-data de-duplication (2026-09-02). email.json's local is a drifted copy of username.json, and no shipped file yet uses a held path, an operand or a reference. Fixed in the data fill before the first tag, when the shipped set is rewritten anyway; premise: nothing depends on the shipped data's shape until then. Not raised in review before that.