Point the agent instructions at the issue tracker for outstanding work
Some checks failed
akbasic CI Build / cmake_build (push) Failing after 3m36s
akbasic CI Build / sanitizers (push) Failing after 4m39s
akbasic CI Build / coverage (push) Failing after 4m36s
akbasic CI Build / mutation_test (push) Failing after 3m57s
akbasic CI Build / akgl_build (push) Failing after 4m51s
Some checks failed
akbasic CI Build / cmake_build (push) Failing after 3m36s
akbasic CI Build / sanitizers (push) Failing after 4m39s
akbasic CI Build / coverage (push) Failing after 4m36s
akbasic CI Build / mutation_test (push) Failing after 3m57s
akbasic CI Build / akgl_build (push) Failing after 4m51s
This repository has no AGENTS.md; CLAUDE.md and MAINTENANCE.md carry the same rules, so both are updated. Outstanding work is an issue on the forge now, with the file and line, the functional consequence, and what closing it would touch. TODO.md is the record -- settled design decisions, the deviation register, defects already fixed, and the reasoning behind the measurements -- and its row in CLAUDE.md's reading table says so, with the tracker listed above it. The dependency rule gains the correction this migration produced. 'Never work around a missing dependency capability here' now says to open an issue in that repository's tracker, and says plainly that recording it here instead is not filing it: two akgl_ui gaps sat in TODO.md for a release on the reasoning that changing a submodule is that repository's decision, which is true of changing it and not of reporting it. Both are libakgl issues now. Cross-repository citations of deps/*/TODO.md sections point at the trackers. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
26
CLAUDE.md
26
CLAUDE.md
@@ -23,7 +23,8 @@ scripting engine for game authors.
|
||||
| Read | For |
|
||||
|---|---|
|
||||
| [`MAINTENANCE.md`](MAINTENANCE.md) | Everything above. Start here |
|
||||
| [`TODO.md`](TODO.md) | Outstanding defects, with file, line and consequence. §0.1 first — it retires the byte-for-byte fidelity constraint several later sections were written on |
|
||||
| [the issue tracker](https://source.starfort.tech/andrew/akbasic/issues) | **Outstanding defects and gaps.** Labelled by kind and blast radius; `status::grooming` means the scope is not settled yet |
|
||||
| [`TODO.md`](TODO.md) | The record: settled design decisions, the deviation register, defects already fixed, and the reasoning behind the measurements. §0.1 first — it retires the byte-for-byte fidelity constraint several later sections were written on |
|
||||
| [`README.md`](README.md) | What the project is and why, for somebody who has not seen it |
|
||||
| [`docs/`](docs/README.md) | The language itself: eighteen chapters, verb and function reference. [Chapter 14](docs/14-architecture.md) is the interpreter's architecture — the step loop, the pools, the two kinds of error, and how to debug it. [Chapter 15](docs/15-error-codes.md) is the error-code appendix. [Chapters 17](docs/17-tutorial-breakout.md) and [18](docs/18-tutorial-breakout-artwork.md) are tutorials that build the games in `examples/breakout/` |
|
||||
| `deps/libakerror/AGENTS.md` | The `ATTEMPT`/`CLEANUP`/`PROCESS`/`HANDLE`/`FINISH` protocol, authoritatively |
|
||||
@@ -44,19 +45,26 @@ repeating where you will see them:
|
||||
|
||||
- **Add tests in the same commit as the behaviour change**, and assert the *correct* contract
|
||||
even where the code is currently wrong. A known-failing test goes in
|
||||
`AKBASIC_KNOWN_FAILING_TESTS` with a `TODO.md` entry; it does not get pinned to the buggy
|
||||
`AKBASIC_KNOWN_FAILING_TESTS` with an open issue; it does not get pinned to the buggy
|
||||
behaviour, because that turns the eventual fix into a test failure.
|
||||
- **Never work around a missing dependency capability here.** File it in that repository's
|
||||
`TODO.md` — what the BASIC verb requires, what the entry point should look like, what tests
|
||||
would cover it. `MAINTENANCE.md` explains why, and names the four gaps this closed upstream.
|
||||
- **Never work around a missing dependency capability here.** Open an issue in that
|
||||
repository's tracker on <https://source.starfort.tech> — what the BASIC verb requires, what
|
||||
the entry point should look like, what tests would cover it. `MAINTENANCE.md` explains why,
|
||||
and names the four gaps this closed upstream. **Recording it here instead is not filing it**:
|
||||
two `akgl_ui` gaps sat in `TODO.md` for a release because changing a submodule is that
|
||||
repository's decision — which is true of changing it and not of reporting it.
|
||||
- **Never edit generated output** — `build/` trees, the generated `akerror.h`, `akgl.pc`,
|
||||
`include/akgl/SDL_GameControllerDB.h`. Change the template or the generator script.
|
||||
- **Do not reformat code you are not otherwise changing.** Several files mix tabs and spaces
|
||||
and there is no repo-wide formatter; style conversions get their own commit.
|
||||
- **Do not edit `tests/reference/`.** Those expectations came from the Go implementation and
|
||||
are never edited to suit this interpreter. A deliberate divergence goes in `TODO.md` and
|
||||
`docs/13-differences.md`.
|
||||
- **Update `TODO.md` when you learn something about a defect**, including that it is worse or
|
||||
better than recorded. Publishing a problem you cannot fix yet is a contribution.
|
||||
are never edited to suit this interpreter. A deliberate divergence goes in
|
||||
`tests/reference/README.md`'s divergence table and `docs/13-differences.md`.
|
||||
- **Open an issue for outstanding work; do not add it to `TODO.md`.**
|
||||
<https://source.starfort.tech/andrew/akbasic/issues>, or `tea issues create --repo
|
||||
andrew/akbasic`. Name the file and line, the functional consequence, and what closing it would
|
||||
touch. Publishing a problem you cannot fix yet is a contribution — and **when you learn
|
||||
something about an open issue, say so in the issue**, including that it is worse than
|
||||
recorded, already fixed, or resting on a premise that has expired.
|
||||
- **Add yourself — program, model and version — as a commit co-author.** `libakgl`'s
|
||||
`AGENTS.md` requires it and this repository follows the same rule.
|
||||
|
||||
Reference in New Issue
Block a user